yandeu/visualizer

Docker Swarm Visualizer

镜像概述

Docker Swarm Visualizer 是一款基于 Node.js 和 Docker Engine API 构建的 Docker Swarm 集群可视化管理工具。它通过直观的 Web 界面展示集群节点和服务的实时状态，并提供自动扩缩容、自动镜像更新、拖拽部署等高级自动化运维功能，旨在简化 Swarm 集群的管理与调度。

核心功能与特性

• 实时监控：实时可视化展示 Swarm 集群的节点状态、服务分布及容器运行情况。
• 垂直服务自动扩缩容 (Beta)：根据服务的 CPU 使用率阈值，自动增加或减少服务副本数。
• 自动镜像更新 (Beta)：定时检查并自动从镜像仓库拉取最新镜像，实现服务的无缝更新。
• 拖拽部署 (Beta)：支持通过 Web 界面直接拖拽文件来部署 Stacks（应用栈）和 Secrets（密钥）。
• 自动子网标签 (Beta)：自动检测节点所在的子网并添加标签，结合部署偏好设置，实现容器在多可用区或子网间的均匀分布。

使用场景与适用范围

• 集群状态监控：需要直观了解 Docker Swarm 集群资源使用和服务拓扑的团队。
• 自动化运维：希望实现基于负载（CPU）的自动扩缩容和镜像自动更新的 CI/CD 流程。
• 多可用区/多子网部署：在跨子网或跨可用区环境中，需要精确控制容器调度策略和分布的场景。
• 便捷部署：需要通过可视化界面快速上传和部署 Compose 文件或密钥的轻量级管理需求。

环境要求

• Docker API 版本：最低要求 1.41（可通过 docker version 检查）。
• 运行模式：Docker 必须处于 Swarm 模式（docker swarm init）。
• 网络端口：
  • 2377/tcp：集群管理通信。
  • 7946/tcp 和 7946/udp：节点间通信。
  • 4789/udp：Overlay 网络流量。
  • 9500/tcp：Visualizer Web 界面访问端口。
  • 9501/tcp：Visualizer 节点间通信端口。

快速开始

1. 初始化 Swarm 集群

确保 Docker 已开启 Swarm 模式，并开放上述所需端口。

2. 部署 Visualizer

通过官方提供的 Stack 文件进行一键部署：

bash
# 下载 Stack 配置文件
curl -L https://git.io/JcGlt -o visualizer.stack.yml

# 部署 Stack
docker stack deploy -c visualizer.stack.yml visualizer

3. 访问控制台

部署完成后，通过浏览器访问 Web 界面：

• 本地访问：http://127.0.0.1:9500
• 远程访问：http://[NODE_IP]:9500

详细配置与高级功能说明

以下高级功能目前处于 Beta 或开发阶段，需通过环境变量和 Labels 进行配置。

拖拽部署

在 Web 界面中，点击 ⇪ 图标，直接将 Stack (YAML) 文件或 Secret 文件拖拽至指定区域即可完成部署。

自动扩缩容 (Autoscaler)

根据 CPU 使用率自动调整服务副本数。需在 Visualizer 的 manager 和 agent 服务中开启环境变量，并在目标服务上添加 Labels。

yaml
services:
  manager:
    environment:
      - VISUALIZER_TASK=true
      - VISUALIZER_TASK_AUTOSCALE=true

  agent:
    environment:
      - VISUALIZER_TASK=true
      - VISUALIZER_TASK_AUTOSCALE=true

  your_app:
    labels:
      - visualizer.autoscale.min=1       # 最小副本数
      - visualizer.autoscale.max=5       # 最大副本数
      - visualizer.autoscale.up.cpu=0.2  # 扩容 CPU 阈值 (20%)
      - visualizer.autoscale.down.cpu=0.1 # 缩容 CPU 阈值 (10%)

自动镜像更新 (Image Updates)

定时检查并更新公共镜像（目前仅支持 Docker Hub 公共镜像）。

yaml
services:
  manager:
    environment:
      - VISUALIZER_TASK=true
      - VISUALIZER_TASK_AUTOUPDATE=true
      # 设置检查更新的 Cron 表达式，例如每 6 小时检查一次
      - VISUALIZER_TASK_AUTOUPDATE_CRON="0 */6 * * *"

  your_app:
    labels:
      - visualizer.autoupdate=true # 开启该服务的自动更新

子网标签 (Subnet Labeling)

自动识别节点子网并打标签，配合 Swarm 的 placement preferences 实现容器的分散部署。

yaml
services:
  agent:
    environment:
      - VISUALIZER_TASK=true
      - VISUALIZER_TASK_SUBNET=true
    labels:
      # 定义子网与标签的映射关系（根据实际网络环境修改）
      - visualizer.subnet.az1=172.31.0.0/20
      - visualizer.subnet.az2=172.31.16.0/20
      - visualizer.subnet.az3=172.31.32.0/20
      - visualizer.subnet.local=192.168.0.0/16

  your_app:
    deploy:
      placement:
        preferences:
          # 根据 "subnet" 标签分散部署服务
          - spread: node.labels.subnet

相关链接

• GitHub 仓库：https://github.com/yandeu/docker-swarm-visualizer
• Docker Hub：https://hub.docker.com/r/yandeu/visualizer
• Rust 重构版本：https://hub.docker.com/r/yandeu/visualizer-rs (推荐尝试)
• 视频教程：*** 快速入门