praekeltfoundation/marathon-acme

docker-marathon-acme

![Requirements Status]([] ![Build Status]([]

本镜像为 https://github.com/praekeltfoundation/marathon-acme 提供Docker镜像，用于自动管理Marathon应用的ACME证书。

核心功能

• 自动从ACME服务（如Let's Encrypt）获取HTTPS证书
• 证书自动续期，避免手动更新操作
• 与marathon-lb集成，为Marathon集群内的应用提供证书支持
• 支持多Marathon实例和多负载均衡器的配置场景

使用场景

适用于运行在Marathon集群中的应用，需要通过marathon-lb对外提供HTTPS服务的场景，可大幅简化证书的获取、更新及管理流程。

配置说明

基础使用

通过命令行参数配置marathon-acme：

bash
docker run --rm praekeltfoundation/marathon-acme --help

默认证书存储路径为/var/lib/marathon-acme（已作为卷暴露），容器暴露端口8000。

Marathon部署示例

通常marathon-acme应通过Marathon自身运行，以下是应用定义示例：

json
{
  "id": "/marathon-acme",
  "cpus": 0.01,
  "mem": 128.0,
  "args": [
    "--email", "letsencrypt@example.com",
    "--marathon", "http://marathon1:8080,http://marathon2:8080,http://marathon3:8080",
    "--lb", "http://lb1:9090,http://lb2:9090",
    "/var/lib/marathon-acme"
  ],
  "labels": {
    "HAPROXY_GROUP": "external",
    "HAPROXY_0_VHOST": "marathon-acme.example.com",
    "HAPROXY_0_BACKEND_WEIGHT": "1",
    "HAPROXY_0_PATH": "/.well-known/acme-challenge/",
    "HAPROXY_0_HTTP_FRONTEND_ACL_WITH_PATH": "  acl host_{cleanedUpHostname} hdr(host) -i {hostname}\n  acl path_{backend} path_beg {path}\n  redirect prefix http://{hostname} code 302 if !host_{cleanedUpHostname} path_{backend}\n  use_backend {backend} if host_{cleanedUpHostname} path_{backend}\n"
  },
  "container": {
    "type": "DOCKER",
    "docker": {
      "image": "praekeltfoundation/marathon-acme",
      "network": "BRIDGE",
      "portMappings": [
        { "containerPort": 8000, "hostPort": 0 }
      ],
      "parameters": [
        {
          "value": "my-volume-driver",
          "key": "volume-driver"
        },
        {
          "value": "marathon-acme-certs:/var/lib/marathon-acme",
          "key": "volume"
        }
      ]
    }
  }
}

运行用户配置

默认以root用户运行容器。可通过MARATHON_ACME_USER环境变量指定运行用户，格式与Dockerfile的USER指令一致（如UID/GID或用户名）。需确保指定用户对证书存储路径拥有正确的读写权限。

更多配置细节请参考 https://github.com/praekeltfoundation/marathon-acme%E3%80%82