lifeway/letsencrypt-ci

Let's Encrypt证书自动化镜像

镜像概述

本镜像集成了一系列工具，专门用于Let's Encrypt SSL/TLS证书的自动化管理。包含Certbot（证书管理工具）、Route53 DNS验证插件（certbot_dns_route53 0.26.1）、Ansible（自动化工具）、f5-sdk（F5设备开发工具）及Python相关依赖，可实现证书的自动申请、续期及相关配置管理。

核心功能和特性

• 证书管理：基于Certbot实现Let's Encrypt证书的申请、续期、吊销等生命周期管理
• DNS验证支持：集成certbot_dns_route53 0.26.1插件，支持通过AWS Route53 DNS记录完成域名验证
• 自动化能力：包含Ansible和bash，支持编写和执行证书管理自动化脚本
• F5设备集成：内置f5-sdk，可用于F5负载均衡设备的证书配置管理
• 依赖完整：包含Python 2、python-dev、py-pip、libffi-dev、build-base等基础依赖，确保工具正常运行

使用场景和适用范围

• 需要自动管理SSL/TLS证书的Web服务器、API服务等环境
• 使用AWS Route53作为DNS服务提供商的域名证书管理
• 通过Ansible实现多服务器证书批量部署和更新的场景
• F5负载均衡设备的证书自动化配置与管理
• 对证书续期有高自动化要求，需减少人工干预的场景

使用方法和配置说明

基本使用

通过docker run命令启动容器，需挂载证书存储目录并配置必要环境变量：

bash
docker run -d \
  -v /path/to/certificates:/etc/letsencrypt \
  -e AWS_ACCESS_KEY_ID="your_aws_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_aws_secret_key" \
  -e DOMAINS="example.com,*.example.com" \
  -e EMAIL="admin@example.com" \
  your-image-name

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  certbot-automation:
    image: your-image-name
    volumes:
      - ./certificates:/etc/letsencrypt
    environment:
      - AWS_ACCESS_KEY_ID=AKIAEXAMPLE123456
      - AWS_SECRET_ACCESS_KEY=secret123456example
      - DOMAINS=example.com,*.example.com
      - EMAIL=admin@example.com
    restart: unless-stopped

常用操作示例

申请新证书（Route53验证）

bash
docker exec -it [container_id] certbot certonly \
  --dns-route53 \
  -d example.com \
  -d *.example.com \
  --email admin@example.com \
  --agree-tos

手动续期证书

bash
docker exec -it [container_id] certbot renew

使用Ansible执行自动化任务

将Ansible playbook挂载到容器内，执行证书部署：

bash
docker run -v /path/to/ansible-playbooks:/playbooks your-image-name ansible-playbook /playbooks/deploy-cert.yml