bretfisher/visualizer

Docker Swarm Visualizer

镜像概述

Docker Swarm Visualizer 是一个用于图形化展示 Docker Swarm 集群中节点和服务运行状态的演示级应用。该项目最初为 DockerCon 主题演讲创建，现广泛用于 Docker 教学与学习场景。它通过直观的拓扑图展示集群结构，帮助开发者快速了解服务在各个节点上的分布情况。

重要提示：

• 本镜像仅支持 Docker Engine 1.12.0 及以上版本内置的 Docker Swarm Mode，不兼容旧版独立的 Docker Swarm 项目。
• 此应用主要用于学习和演示。若在生产环境中使用，必须采取严格的安全措施，特别是通过 SSL https://docs.docker.com/engine/security/https/%EF%BC%8C%E9%81%BF%E5%85%8D%E7%9B%B4%E6%8E%A5%E6%9A%B4%E9%9C%B2 Docker Socket 带来安全风险。

核心功能和特性

• 集群拓扑可视化：以图形化方式展示 Swarm 集群中的所有节点及其运行的任务（Tasks）。
• 实时状态监控：
  • 当服务下线时，对应的任务会从视图中自动移除。
  • 当节点宕机时，节点不会被移除，但其顶部的状态圆圈会变为红色以示警告，同时该节点上的任务会被移除。
• 多架构支持：原生支持 linux/amd64，并提供针对 ARM（如树莓派）和 Windows 环境的预构建镜像。
• 上下文根自定义：支持配置上下文根路径，方便在外部负载均衡器或反向代理后部署。
• 数据自动修复：当 Remote API 偶尔返回不完整数据（如节点缺失名称）时，下次拉取信息时会自动更新修复。

使用场景和适用范围

• 适用场景：Docker Swarm 学习、培训课程演示（如 Docker Mastery 课程）、开发与测试环境的集群状态监控。
• 不适用场景：旧版独立 Docker Swarm 集群、未进行安全加固的生产环境。

详细的使用方法和配置说明

环境变量与配置参数

部署示例

1. 单机模式运行 (Docker Run)

在 Swarm Manager 节点上运行，需将宿主机的 Docker Socket 挂载到容器中：

bash
docker run -it -d -p 8080:8080 -v /var/run/docker.sock:/var/run/docker.sock docker.xuanyuan.run/dockersamples/visualizer

如果宿主机的 8080 端口已被占用，可自定义映射端口（例如映射到 5000 端口）：

bash
docker run -it -d -p 5000:8080 -v /var/run/docker.sock:/var/run/docker.sock docker.xuanyuan.run/dockersamples/visualizer

若需在外部负载均衡器后运行，可通过 CTX_ROOT 环境变量配置上下文根：

bash
docker run -it -d -p 8080:8080 -e CTX_ROOT=/visualizer -v /var/run/docker.sock:/var/run/docker.sock docker.xuanyuan.run/dockersamples/visualizer

2. Swarm 集群模式运行 (Docker Service)

推荐在 Swarm 集群中以服务形式部署，并添加约束条件确保其仅运行在 Manager 节点上：

bash
docker service create \
  --name=viz \
  --publish=8080:8080/tcp \
  --constraint=node.role==manager \
  --mount=type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
  dockersamples/visualizer

3. ARM 架构运行 (如树莓派)

对于 ARMv6 或 ARMv7 设备，请使用专门的 ARM 镜像：

bash
docker service create \
  --name=viz \
  --publish=8080:8080/tcp \
  --constraint=node.role==manager \
  --mount=type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
  alexellis2/visualizer-arm:latest

4. Windows 环境运行

在 Windows 环境下，无法直接使用 -v 挂载命名管道（Named Pipe）。Docker 引擎必须监听 TCP 端口（如 2375），并通过 DOCKER_HOST 环境变量进行连接。

基础 TCP 连接 (PowerShell)：

powershell
$ip=(Get-NetIPAddress -AddressFamily IPv4 `
   | Where-Object -FilterScript { $_.InterfaceAlias -Eq "vEthernet (HNS Internal NIC)" } `
   ).IPAddress

docker run -d -p 8080:8080 -e DOCKER_HOST=${ip}:2375 --name=visualizer docker.xuanyuan.run/stefanscherer/visualizer-windows

TLS 安全连接 (PowerShell)： 若需连接启用 TLS 的 Docker 引擎，需设置 DOCKER_TLS_VERIFY 并挂载 TLS 证书：

powershell
$ip=(Get-NetIPAddress -AddressFamily IPv4 `
   | Where-Object -FilterScript { $_.InterfaceAlias -Eq "vEthernet (HNS Internal NIC)" } `
   ).IPAddress

docker run -d -p 8080:8080 -e DOCKER_HOST=${ip}:2376 -e DOCKER_TLS_VERIFY=1 -v "$env:USERPROFILE\.docker:C:\Users\ContainerAdministrator\.docker" --name=visualizer docker.xuanyuan.run/stefanscherer/visualizer-windows

5. 自定义构建

若需为其他受支持的架构（如 arm64v8, ppc64le 等）构建镜像，请在目标架构设备上执行以下命令：

bash
# Linux/ARM 架构
docker build -t visualizer-custom:latest .

# Windows 架构
docker build -f Dockerfile.windows -t visualizer-windows:latest .

构建完成后，将上述部署命令中的镜像名称替换为 visualizer-custom 或 visualizer-windows 即可运行。