moveyourdigital/swarmpit

Swarmpit 1.10 (edge) 镜像文档

镜像概述

Swarmpit 1.10 (edge) 是针对Docker Swarm集群的轻量级管理界面镜像，提供直观的Web界面用于监控和管理Swarm集群资源。本版本重点增强了本地日志驱动支持，可将容器日志高效存储至本地，满足对日志本地化管理的需求。

核心功能与特性

• Docker Swarm全功能管理：支持服务部署、扩缩容、网络配置、卷管理等Swarm核心操作
• 本地日志驱动集成：原生支持本地日志驱动，实现容器日志的本地存储与快速检索
• 可视化监控仪表盘：实时展示集群状态、资源使用率、服务健康状态等关键指标
• 多用户权限控制：支持用户角色配置，实现精细化权限管理
• 容器资源监控：实时跟踪容器CPU、内存、网络IO等资源使用情况

使用场景与适用范围

• 中小型Docker Swarm集群的日常运维管理
• 需要本地存储容器日志的开发与测试环境
• 对容器日志有实时查看需求的生产环境
• 希望通过可视化界面简化Swarm集群管理的技术团队

使用方法与配置说明

前提条件

• 已部署Docker Swarm集群（至少包含1个manager节点）
• Docker Engine版本需≥19.03（推荐20.10+）

快速部署（docker run）

bash
docker run -d \
  --name swarmpit \
  --restart always \
  --publish 8080:8080 \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  --volume swarmpit-data:/app/data \
  --env LOGGING_DRIVER=local \
  swarmpit/swarmpit:1.10-edge

关键参数说明

日志驱动高级配置

通过环境变量自定义日志存储行为：

bash
docker run -d \
  --name swarmpit \
  --restart always \
  --publish 8080:8080 \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  --volume swarmpit-data:/app/data \
  --env LOGGING_DRIVER=local \
  --env LOG_MAX_SIZE=10m \  # 单日志文件最大 size
  --env LOG_MAX_FILE=5 \     # 日志文件保留数量
  --env LOG_PATH=/app/data/logs \  # 日志存储路径
  swarmpit/swarmpit:1.10-edge

访问与初始配置

1. 容器启动后，通过浏览器访问 http://<主机IP>:8080
2. 首次登录需创建管理员账户（用户名/密码）
3. 在"设置-日志"菜单中确认本地日志驱动已启用

注意事项

• edge版本包含实验性功能，生产环境建议先进行充分测试
• 确保Docker Swarm集群处于正常运行状态（docker swarm init已执行）
• 持久化卷swarmpit-data需定期备份，避免配置与日志数据丢失
• 生产环境建议配合反向代理（如Nginx）使用HTTPS加密访问