bwolf/cert-manager-webhook-gandi

ACME webhook for Gandi (cert-manager-webhook-gandi)

镜像概述和主要用途

cert-manager-webhook-gandi 是 cert-manager 的ACME webhook组件。它为cert-manager提供ACME（即Let's Encrypt）协议支持，通过 Gandi 的DNS服务实现DNS-01挑战验证。该镜像允许Kubernetes集群获取非HTTP协议服务的Let's Encrypt证书，同时支持通配符证书申请。其内部通过 Gandi LiveDNS API 与Gandi服务进行通信。

核心功能和特性

• ACME DNS-01挑战支持：实现ACME协议的DNS-01挑战验证流程，用于域名所有权证明
• Gandi集成：通过Gandi LiveDNS API与Gandi DNS服务交互，自动添加/删除验证所需的DNS记录
• Kubernetes兼容：专为Kubernetes环境设计，与cert-manager无缝集成
• 通配符证书支持：允许申请覆盖多个子域名的通配符证书（如*.example.com）
• 非HTTP服务支持：解决HTTP-01挑战无法覆盖的非HTTP服务（如HTTPS、SSH等）证书需求

使用场景和适用范围

• Kubernetes集群中需要为非HTTP服务配置Let's Encrypt证书的场景
• 需要使用通配符证书保护多个子域名的应用
• 使用Gandi作为DNS服务提供商的用户
• 希望自动化证书申请和续期流程的Kubernetes管理员

使用方法和配置说明

前提条件

• 已安装cert-manager的Kubernetes集群
• Gandi账户及API密钥（可从Gandi账户设置中获取）
• 域名的DNS管理由Gandi LiveDNS服务托管

部署方式

通常通过Helm chart或Kubernetes资源清单部署，详细步骤请参考https://github.com/bwolf/cert-manager-webhook-gandi%E3%80%82

核心配置

1. 创建Gandi API密钥Secret

yaml
apiVersion: v1
kind: Secret
metadata:
  name: gandi-api-key
  namespace: cert-manager
type: Opaque
data:
  api-key: <base64-encoded-gandi-api-key>

2. 配置Issuer/ClusterIssuer

yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-gandi
spec:
  acme:
    server: https://acme-v02.api.letsencrypt.org/directory
    email: your-email@example.com
    privateKeySecretRef:
      name: letsencrypt-gandi-private-key
    solvers:
    - dns01:
        webhook:
          groupName: acme.gandi.net
          solverName: gandi
          config:
            apiKeySecretRef:
              name: gandi-api-key
              key: api-key
            zone: example.com # 替换为你的域名

3. 申请证书

yaml
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: example-wildcard-cert
  namespace: default
spec:
  secretName: example-wildcard-tls
  issuerRef:
    name: letsencrypt-gandi
    kind: ClusterIssuer
  dnsNames:
  - example.com
  - "*.example.com"

环境变量说明

参考链接

• https://github.com/bwolf/cert-manager-webhook-gandi
• cert-manager官方文档
• Gandi LiveDNS API文档