csmith/service-reporter

Docker服务报告工具

这是一个小型Python脚本，能够发现所有运行中的Docker容器，并将其相关信息存储到etcd中。

核心价值

将服务详情存储在etcd这类共享存储中，可让其他进程发现服务，或自动化配置、管理任务（例如配置反向代理）。

使用场景

• 服务发现：其他服务可通过etcd获取容器的网络地址、端口等信息。
• 自动化配置：如反向代理服务可根据etcd中的容器信息自动更新配置。
• 容器管理：监控容器变化并同步信息，便于统一管理。

部署与配置

容器需要访问Docker API，因此需挂载Docker socket：

bash
docker run -d --name service-reporter \
              --restart always \
              -v /var/run/docker.sock:/var/run/docker.sock \
              csmith/service-reporter:latest \
              --arguments

可用的命令行参数：

• --etcd-host（默认值：etcd）：etcd运行的主机名
• --etcd-port（默认值：2379）：连接etcd的端口
• --etcd-prefix（默认值：/docker）：写入键的前缀
• --name（默认值：unknown）：运行Docker的主机名称

脚本启动时会立即更新etcd，之后监控Docker事件并应用相关更新。

数据结构

脚本在etcd中存储容器、标签、主机和网络相关的值，结构如下：

/docker/containers/{name1}/host = "server1.example.com"
                          /image = "ubuntu:xenial"
                          /labels/service = "foo"
                          /labels/org.example.some-label = "bar"
                          /net/addr/{network1} = "172.1.2.3"
                                   /{network2} = "172.0.2.3"
                              /ports/tcp/{container_port1} = {host_port}
                                        /{container_port2} = 0 # 未暴露
                                    /udp/...
                  /{name2}/...

       /hosts/{host_1}/{container_name_1} = {container_name_1}
                      /...
             /{host_2}/...

       /labels/{label_1}/{container_name_1} = "foo"
                        /{container_name_2} = "bar"
              /{label_2}/...

       /networks/{network1}/{container_name_1} = "172.1.2.3"
                           /{container_name_2} = "172.0.2.3"
                /{network2}/...

此外，还有一个特殊节点/docker/_updated，每次更新完成后会写入当前Unix时间戳，可用于脚本监听容器变化（直接监听容器节点会在第一个子节点写入时触发，多数场景下不适用）。

已知问题

• 脚本启动时会删除etcd中的/docker节点，因此不能在多个主机上运行多个副本。