recapfyi/docker-letsencrypt

letsencrypt-kubernetes

一个适用于从Let's Encrypt请求新证书并将其存储到Kubernetes Secret中的Docker镜像。可在Docker Hub获取：https://hub.docker.com/r/ployst/letsencrypt

镜像概述

该镜像基于Alpine Linux构建，专注于证书请求与存储管理，帮助用户在Kubernetes环境中自动化SSL证书的获取、更新和存储流程。

核心功能

• 处理Let's Encrypt的ACME请求（需将请求指向该容器）
• 每月定期请求新证书
• 将新证书存储到Kubernetes的Secret中
• 支持证书更新后触发相关部署的刷新

使用场景

适用于Kubernetes集群中需要自动管理SSL证书的场景，如网站、API服务等HTTPS证书的自动获取与更新，减少手动操作成本。

配置说明

环境变量

• EMAIL：用于获取证书的***地址
• DOMAINS：空格分隔的域名列表，需为这些域名获取证书
• LETSENCRYPT_ENDPOINT：指定Let's Encrypt的端点，测试时可使用https://acme-staging.api.letsencrypt.org/directory
• DEPLOYMENTS：空格分隔的部署列表，证书保存后需刷新这些部署的Pod
• SECRET_NAME：存储证书的Secret名称
• NAMESPACE：Secret所在的Kubernetes命名空间
• CRON_FREQUENCY：Cron任务的执行频率（5段式），默认是0-59 0-23 1-27 * *范围内的随机时间

常用命令

生成新证书

容器运行后，执行以下命令生成新证书：

bash
kubectl exec -it <pod> -- bash -c 'EMAIL=fred@fred.com DOMAINS=example.com foo.example.com ./fetch_certs.sh'

保存证书到Secret

bash
kubectl exec -it <pod> -- bash -c 'DOMAINS=example.com foo.example.com ./save_certs.sh'

刷新证书

bash
kubectl exec -it <pod> -- bash -c 'EMAIL=fred@fred.com DOMAINS=example.com foo.example.com SECRET_NAME=foo DEPLOYMENTS=bar ./refresh_certs.sh'

开发步骤

bash
docker-machine start
eval "$(docker-machine env default)"
docker build -t docker-letsencrypt .
docker run -p 8000:80 docker-letsencrypt
open http://192.168.99.100:8000
docker ps
docker kill <container-id>
docker images
docker tag 7d9495d03763 recapfyi/docker-letsencrypt:latest
docker push recapfyi/docker-letsencrypt

Cron任务说明

Cron守护进程会在系统启动时自动启动，并执行/etc/periodic目录下的脚本，包括15分钟、每小时、每日、每周和每月的脚本目录。