gjrtimmer/traefik-certmanager

Traefik CertManager

[!NOTE] 当前版本：2.2.2

Traefik CertManager用于管理Traefik IngressRoute的证书，本仓库是Rob Kooper创建的原traefik-certmanager项目的分支。Cert Manager仅支持默认的Kubernetes Ingress类型，而该工具可实现Cert Manager对Traefik IngressRoute类型的证书管理。详细文档请查看https://gjrtimmer.github.io/traefik-certmanager%E3%80%82

镜像概述

Traefik CertManager是连接Traefik与Cert Manager的桥梁工具，解决了Cert Manager无法直接处理Traefik IngressRoute证书的问题，支持在Kubernetes集群中自动化管理Traefik IngressRoute的SSL/TLS证书。

核心功能

• 支持Legacy CRD（Traefik traefik.containo.us/v1alpha1版本）
• 注解忽略功能（通过注解跳过特定IngressRoute的处理）
• IngressClass过滤（根据IngressClass筛选需处理的IngressRoute）
• 默认证书Issuer配置（可设置默认的ClusterIssuer或Issuer）

使用场景

适用于Kubernetes集群中使用Traefik作为Ingress控制器，并希望通过Cert Manager自动签发、管理IngressRoute证书的场景，例如：

1. 为Traefik Dashboard配置HTTPS证书
2. 为集群内的微服务应用IngressRoute自动生成SSL证书
3. 管理多IngressClass下的Traefik证书

配置说明

环境变量配置

注解配置

Traefik IngressRoute支持以下注解：

[!WARNING] 注意：cert-manager.io/cluster-issuer与cert-manager.io/issuer+cert-manager.io/issuer-kind是互斥的，只能选择其中一种方式配置。

部署示例

1. 添加ClusterIssuer到Cert Manager

bash
kubectl apply -f ./manifests/letsencrypt/le-cluster-issuer.yaml

对应的YAML文件：

yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt
spec:
  acme:
    email: manager@example.com
    server: https://acme-v02.api.letsencrypt.org/directory
    privateKeySecretRef:
      name: lets-encrypt
    solvers:
      - http01:
          ingress:
            class: ""

2. IngressRoute示例

以下是一个会被Traefik CertManager处理的IngressRoute示例（无INGRESS_CLASS_FILTER时）：

yaml
apiVersion: traefik.containo.us/v1alpha1
kind: IngressRoute
metadata:
  name: traefik-dashboard
  namespace: traefik
spec:
  entryPoints:
    - websecure
  routes:
    - match: Host(`traefik.example.com`)
      kind: Rule
      services:
        - name: api@internal
          kind: TraefikService
  tls:
    secretName: trafik.example

若需使用自定义ClusterIssuer（如k3s-apps-ca），可添加注解：

yaml
metadata:
  name: traefik-dashboard
  namespace: traefik
  annotations:
    cert-manager.io/cluster-issuer: "k3s-apps-ca"

安装说明

请参考https://gjrtimmer.github.io/traefik-certmanager/INSTALL.html%E5%AE%8C%E6%88%90Traefik CertManager及所有依赖（Cert Manager、Traefik、Traefik CRD）的安装。