dienet/deployer

dienet/deployer镜像说明

镜像概述

dienet/deployer是一个基于Go语言开发的轻量级持续部署系统，旨在通过接收Docker Hub构建服务的webhook触发自动部署流程。它结合etcd实现集群节点间的更新同步，利用Docker API拉取最新镜像，并通过Fleet管理应用重启，支持零停机部署（功能未完全实现）和Slack通知，帮助团队高效实现持续交付。

核心功能

• 接收Docker Hub构建完成的webhook通知
• 通过etcd同步集群内镜像更新信息
• 自动拉取指定仓库的最新镜像
• 检测运行容器与最新镜像差异，触发应用重启
• 可选Slack部署结果通知
• 与Fleet兼容，直接使用Docker API避免竞态条件

使用场景

• 集群环境下的应用持续部署，自动更新版本
• 基于Docker Hub构建流程的自动化交付 pipeline
• 需要减少手动部署操作、提升发布效率的团队
• 依赖Fleet和etcd管理容器化应用的场景

配置说明

命令行参数

deployer支持以下参数（可通过docker run dienet/deployer:latest --help查看）：

-docker string
      Docker端点连接地址（默认 "unix:///var/run/docker.sock"）
-dockercfg string
      .dockercfg认证文件路径（默认 "~/.dockercfg"）
-etcd_dial_timeout duration
      连接etcd节点超时时间（默认5s）
-etcd_nodes string
      etcd节点列表（逗号分隔，默认"http://127.0.0.1:4001"）
-etcd_prefix string
      etcd路径前缀（默认"/deployer"）
-etcd_retry_delay duration
      请求重试间隔（默认2s）
-kill_timeout int
      容器停止超时时间（秒，默认10）
-listen string
      监听地址端口（默认":4500"）
-max_threads int
      最大运行线程数（默认4）
-registry string
      Docker registry URL（默认"https://index.docker.io/v1/"）
-repull_period duration
      自动重新拉取镜像周期（默认24h）
-slack_username string
      Slack通知用户名（默认"Deployer"）
-slack_webhook_url string
      Slack webhook URL（可选）
-strong_consistency
      设置etcd强一致性级别
-webhook_path string
      Docker Hub webhook接收路径（默认"/api/dockerhub/webhook"）

Fleet单元配置示例

应用服务单元（Foo App）

[Unit]
Description=Foo应用服务

[Service]
User=core
EnvironmentFile=/etc/environment.myorg
ExecStartPre=-/usr/bin/docker rm %n
ExecStartPre=-/usr/bin/docker pull myorg/foo:${MYORG_ENV}
ExecStart=/usr/bin/docker run --name %n -m 2g -P --env-file=/etc/environment.myorg myorg/foo:${MYORG_ENV}
ExecStop=/usr/bin/docker stop %n
TimeoutStartSec=5m
Restart=always
StartLimitInterval=5m

[X-Fleet]
Global=true

说明：依赖环境变量文件/etc/environment.myorg，MYORG_ENV指定环境（如qa/production），镜像标签与环境对应。

Deployer服务单元

[Unit]
Description=Deployer持续部署服务

[Service]
User=core
EnvironmentFile=/etc/environment.myorg
ExecStartPre=-/usr/bin/docker rm %n
ExecStartPre=-/usr/bin/docker pull dienet/deployer:latest
ExecStart=/usr/bin/docker run --name %n -m 1g -h ${HOSTNAME} -P -v /var/run/docker.sock:/var/run/docker.sock -v /home/core/.dockercfg:/app/.dockercfg dienet/deployer:latest --dockercfg /app/.dockercfg --etcd_nodes=http://${ETCD} --etcd_prefix=/${MYORG_ENV}/good/deployer --slack_username="${MYORG_ENV} deploy" --slack_webhook_url=https://hooks.slack.com/services/...
ExecStop=/usr/bin/docker stop %n
TimeoutStartSec=5m
Restart=always
RestartSec=1m

[X-Fleet]
Global=true

说明：映射Docker sock和认证文件，配置etcd节点、前缀及Slack参数，实现集群自动部署。