siutoba/docker-certs

docker-certs

用于按需创建CA（证书颁发机构）和SSL证书的Docker容器。

前提条件

• 需安装 https://docs.docker.com/installation/ 和 https://docs.docker.com/compose/install/

容器顺序启动

该镜像通过读取环境变量实现容器的顺序启动：

DOCKER_NAME     : 容器名称，例如 "mi_aplicacion"
DOCKER_WAIT_FOR : 需要等待的容器名称，例如 "otra_aplicacion"

要实现此功能，相关容器需共享一个挂载到 /var/local/docker-data/containers-status 的公共卷。

关键环境变量

变量从 docker.env 文件读取（该文件需从 docker-template.env 复制并修改内容）。以下是重要变量及其功能：

• CA_PWD 和 CA_INT_PWD：定义创建CA的密码
• LISTA_SERVER：定义需生成证书的域名列表
• LISTA_CLIENTES：定义需生成客户端证书的名称列表
• DOCKER_WEB_SCRIPT：容器ENTRYPOINT最后一步执行的脚本路径

其他变量可修改证书信息、有效期等，详情请查看 docker-template.env 文件。

注意事项

• 初始化完成后会生成 CA_INITIALIZED 文件，若该文件不存在，将删除中间CA及已生成的证书。
• 根CA需保存在容器外部。

构建镜像

若修改了OpenSSL配置文件、证书生成脚本或Dockerfile，需执行以下命令重新生成镜像：

bash
docker build -t="siutoba/docker-certs" .

推送至GitHub后，镜像会自动更新到 https://hub.docker.com 索引。

部署示例

Docker Run 命令

bash
docker run -d \
  --name my-docker-certs \
  -v $(pwd)/docker.env:/app/docker.env \
  -v container-status:/var/local/docker-data/containers-status \
  docker.xuanyuan.run/siutoba/docker-certs

Docker Compose 配置

yaml
version: '3.8'
services:
  cert-generator:
    image: siutoba/docker-certs
    volumes:
      - ./docker.env:/app/docker.env
      - shared-status:/var/local/docker-data/containers-status
    environment:
      - DOCKER_NAME=cert-generator
      - DOCKER_WAIT_FOR=db-service

volumes:
  shared-status: