dockersamples/visualizer

Docker Swarm Visualizer

镜像概述

Docker Swarm Visualizer是一个演示应用，用于以图表形式直观展示Docker Swarm模式集群中运行的服务和节点状态。仅适用于Docker Engine 1.12.0及以上版本的Swarm模式，不支持独立的Docker Swarm项目。

注意：此应用仅用于学习Docker，在生产环境中运行存在安全风险。若需在生产环境使用，必须采取所有安全措施，尤其是通过SSLhttps://docs.docker.com/engine/security/https/。

该项目最初由Francisco Miranda为2015年DockerCon EU主题演讲创建，后经改编用于2016年DockerCon US主题演讲，展示https://docs.docker.com/engine/swarm/。社区贡献者对其进行了多次更新，特别感谢https://github.com/DovAmir和https://github.com/alexellis的重要贡献。

核心功能和特性

• 实时可视化：以图表形式展示Swarm集群中的节点和服务分布
• 节点状态监控：节点下线时顶部圆圈变为红色，任务自动移除
• 任务状态显示：每个节点显示其上运行的所有任务，服务下线时自动移除任务
• 数据自动更新：定期拉取节点信息，补充缺失数据（如节点名称）
• 灵活配置：支持自定义端口映射和上下文根（CTX_ROOT）
• 多架构支持：包括linux/amd64、ARM（armhf）和Windows（nanoserver容器）

使用场景

• Docker Swarm模式集群的可视化监控
• 学习和演示Docker Swarm的服务部署与调度
• 直观展示集群中节点和服务的运行状态
• 监控服务扩缩容和节点故障转移过程

使用方法和配置说明

基本运行（单节点）

通过docker run命令在Swarm管理节点运行：

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

自定义端口

若主机8080端口已被占用，可指定其他端口：

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

自定义上下文根

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

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

在Swarm集群中部署

通过docker service create在Swarm集群中创建服务：

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

支持的架构

linux/amd64

官方镜像dockersamples/visualizer默认支持此架构。

ARM架构

适用于ARMv6/ARMv7设备（如树莓派），使用预构建镜像alexellis2/visualizer-arm:latest：

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

从源码构建ARM镜像（需在树莓派上执行）：

bash
docker build -t visualizer-arm:latest .

Windows架构

使用Windows nanoserver容器镜像stefanscherer/visualizer-windows:latest。

从源码构建Windows镜像：

bash
docker build -f Dockerfile.windows -t visualizer-windows:latest .

运行Windows版本：

Windows不支持绑定挂载命名管道，需将Docker引擎配置为监听TCP端口（如2375），并设置DOCKER_HOST环境变量：

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安全的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

构建自定义镜像

对于https://hub.docker.com/_/node/支持的架构（如amd64、arm32v6、arm32v7、arm64v8等），可在目标架构设备上从源码构建：

bash
docker build -t visualizer-custom:latest .

使用自定义镜像运行（替换官方镜像名）：

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

待办事项

• 优化或修复dist目录处理方式
• 增加详细注释
• 创建并改进测试用例
• 优化CSS弹性布局（当前仅针对大屏幕3节点场景优化）