ncsa/traefik-certmanager

镜像概述

本镜像用于对接Traefik与cert-manager，自动为Traefik的IngressRoute对象发起证书请求，实现Kubernetes集群中TLS证书的创建、更新及清理自动化。

核心功能

• 自动扫描现有IngressRoute对象，检查是否已配置证书（仅针对含secretName的IngressRoute）
• 监听IngressRoute的新增/删除事件，同步处理证书的创建与清理
• 支持配置删除IngressRoute时是否自动删除对应证书（默认不删除）

使用场景

适用于Kubernetes集群中以Traefik为Ingress Controller，需要通过cert-manager自动获取Let's Encrypt等CA颁发的TLS证书的场景。

配置说明

步骤1：安装cert-manager

通过Helm安装cert-manager：

bash
helm install \
  cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --version v1.9.1 \
  --set installCRDs=true

步骤2：安装Traefik

通过Helm安装Traefik：

bash
helm install \
  traefik traefik/traefik \
  --namespace cert-manager \
  --create-namespace

步骤3：配置ClusterIssuer

创建ClusterIssuer对接Let's Encrypt ACME服务：

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: ""

执行命令应用：kubectl apply -f cluster-issuer.yaml

步骤4：部署traefik-certmanager

应用部署配置：

bash
kubectl apply -f traefik-certmanager.yaml

示例IngressRoute

以下IngressRoute会被本镜像处理：

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: traefik.example  # 证书将存储在此Secret