mecodia/cert-manager-webhook-hetzner

ACME Webhook for Hetzner DNS

【已归档项目】

推荐使用 https://github.com/vadimkim/cert-manager-webhook-hetzner 替代。

镜像概述和主要用途

本项目提供了一个适用于Hetzner DNS的cert-manager ACME Webhook，基于https://github.com/jetstack/cert-manager-webhook-example%E6%9E%84%E5%BB%BA%E3%80%82

本README及Webhook的灵感主要来源于Stephan Müllers的INWX Webhook。Helm Chart通过https://mecodia.github.io/cert-manager-webhook-hetzner/%E8%87%AA%E5%8A%A8%E5%8F%91%E5%B8%83%E3%80%82

核心功能和特性

• 与cert-manager集成，支持ACME DNS-01挑战
• 通过Hetzner DNS API自动完成DNS记录的创建与删除
• 提供Helm Chart便于在Kubernetes集群中部署
• 可配置资源限制、节点选择器等Kubernetes部署参数

要求

• helm >= v3.0.0
• kubernetes
• cert-manager

最后测试的版本组合

• webhook镜像: v0.4.0
• cert-manager: v1.12.5
• kubernetes: v1.26.7

配置参数

以下表格列出了cert-manager chart的可配置参数及其默认值。

安装方法

cert-manager

按照cert-manager文档中的说明在集群中安装cert-manager。

Webhook

bash
git clone https://github.com/mecodia/cert-manager-webhook-hetzner.git
cd cert-manager-webhook-hetzner
helm install --namespace kube-system cert-manager-webhook-hetzner ./charts/cert-manager-webhook-hetzner

注意：用于安装Webhook的Kubernetes资源应部署在与cert-manager相同的命名空间中。

卸载Webhook：

bash
helm uninstall --namespace kube-system cert-manager-webhook-hetzner

使用场景和配置说明

Issuer配置

创建ClusterIssuer或Issuer资源，示例如下：

yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-staging
spec:
  acme:
    # ACME服务器URL（注意：这是测试环境！）
    server: https://acme-staging-v02.api.letsencrypt.org/directory

    # 用于ACME注册的电子邮件地址
    email: mail@example.com # 替换为您的电子邮件！

    # 用于存储ACME账户私钥的密钥名称
    privateKeySecretRef:
      name: letsencrypt-staging-account-key

    solvers:
      - dns01:
          webhook:
            groupName: dns.hetzner.cloud
            solverName: hetzner
            config:
              APIKey: <YOUR-DNS-API-KEY-HERE>

凭证

要访问Hetzner DNS API，需要创建API令牌，可在DNS控制台中创建。

目前，本项目不提供使用密钥存储API密钥的方式。

创建证书

最后，可以创建证书，例如：

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

开发

开发要求

• go >= 1.21

运行测试套件

1. 在Hetzner DNS控制台创建新测试账户或使用现有账户

2. 进入testdata/hcloud-dns/config.json并替换您的API密钥

3. 下载依赖

   bash
   go mod download
   

4. 运行测试（将区域名称替换为您的区域之一）

   bash
   env TEST_ZONE_NAME='warbl.net.' make test
   

发布

Dockerhub设置为从标记的提交自动构建镜像。

示例标签：

text
cert-manager-webhook-hetzner-0.3.0-rc4
cert-manager-webhook-hetzner-0.3.0
cert-manager-webhook-hetzner-0.1
cert-manager-webhook-hetzner-1.1

Github会处理Helm Chart的更新。