
mathnao/certs该Chart使用acme.sh脚本以DNS验证方式生成Let's Encrypt证书;它通过Kubernetes Job来获取和续期证书。
| 名称 | 示例 | 描述 |
|---|---|---|
| acme.kubernetes.io/enable | "true" | 当值设为"true"时,在此Ingress上启用Certs。默认值为空。 |
| acme.kubernetes.io/dns | "dns_gd" | 设置acme.sh的--dns参数:(查看[[***]]了解所有支持的--dns值)。默认值为空。 |
| acme.kubernetes.io/staging | "true" | 当值设为"true"时,启用acme测试环境证书验证。默认值为空。 |
| acme.kubernetes.io/add-args | "--keylength ec-256" | 为生成证书的acme.sh命令添加更多参数。默认值为空。 |
| acme.kubernetes.io/cmd-to-use | "acme.sh -h" | 替换用于生成证书的acme.sh命令。默认值为空。 |
| 参数 | 默认值 | 描述 |
|---|---|---|
| image.registry | mathnao | 设置要使用的Docker镜像仓库。 |
| image.repository | certs | 设置要使用的Docker镜像仓库路径。 |
| image.tag | tag | 设置要使用的Docker镜像标签。 |
| schedule | 0 0,12 * * * | 设置运行DNS验证以续期证书的Job调度时间。 |
| backoffLimit | 1 | 指定Job失败前的重试次数。 |
| activeDeadlineSeconds | 600 | 设置终止Job的活动截止时间。 |
| ttlSecondsAfterFinished | 120 | 设置清理Job的TTL(生存时间)。 |
| successfulJobsHistoryLimit | 3 | 指定应保留的已完成Job数量。 |
| manageAllNamespaces | false | 是否让certs管理所有命名空间以生成证书。 |
| debug | false | 当值设为"true"时,显示更多日志。 |
| failedJobsHistoryLimit | 1 | 指定应保留的失败Job数量。 |
| env | [] | 列出运行acme.sh DNS验证以续期证书所需的所有环境变量。 |
| demo.enabled | false | 启用用于测试目的的演示后端。 |
| demo.image | mathnao/light-test-server | 设置演示后端使用的Docker镜像。 |
| demo.service.type | ClusterIP | 设置演示后端的服务类型。 |
| demo.service.port | 8080 | 设置演示后端的服务端口。 |
| demo.secretName | demo-ingress-cert | 设置用于存储生成证书的密钥名称。 |
| demo.hosts | - "example.com" | 设置要生成Let's Encrypt证书的主机列表。 |
确保Ingress Controller已部署并就绪
注册Ingress,例如:
yamlapiVersion: extensions/v1beta1 kind: Ingress metadata: name: test-ingress annotations: acme.kubernetes.io/enable: "true" acme.kubernetes.io/dns: "dns_gd" nginx.ingress.kubernetes.io/rewrite-target: / spec: tls: - hosts: - sslexample.foo.com secretName: testsecret-tls rules: - host: sslexample.foo.com http: paths: - path: / backend: serviceName: service1 servicePort: 80
Certs Chart:bash# 添加Certs Helm仓库 helm repo add certs [***] # 更新本地Helm Chart仓库缓存 helm repo update # 在与Ingress相同的命名空间中安装Certs Helm Chart helm install \ --name certs \ --namespace app \ --values values.yaml \ certs/certs
values.yaml文件内容示例:
yaml# 每天调度两次Kubernetes Job,仅当证书即将过期时才续期 schedule: "0 2,14 * * *" # 添加acme.sh DNS验证所需的所有必要环境变量 # 参见[***] env: - name: GD_Key value: XXXX - name: GD_Secret value: XXXX
[***]网页,应看到有效的Let's Encrypt证书acme.sh: [***]
本代码根据Apache License, Version 2.0进行分发,详见LICENSE。
您的***有助于维护Certs:
![]([]
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务