当前位置：首页 > news >正文

Docker Swarm与Python-on-Whales：分布式容器集群管理教程

news 2026/8/4 23:54:13

Docker Swarm与Python-on-Whales：分布式容器集群管理教程

【免费下载链接】python-on-whalesAn awesome Python wrapper for an awesome Docker CLI!项目地址: https://gitcode.com/gh_mirrors/py/python-on-whales

Python-on-Whales是一个强大的Docker CLI Python包装器，它让Docker Swarm容器集群管理变得前所未有的简单。无论你是容器新手还是有经验的开发者，这个工具都能帮助你轻松构建和管理分布式应用。

Python-on-Whales标志：Python与Docker容器在鲸鱼上和谐共处，象征着轻松驾驭容器技术

为什么选择Python-on-Whales管理Docker Swarm？

Docker Swarm提供了原生的容器编排能力，但直接使用命令行工具管理集群可能会很繁琐。Python-on-Whales通过直观的API封装了Docker Swarm的所有功能，让你可以用Python代码轻松控制整个集群。

主要优势包括：

简洁的API：用Python代码替代复杂的命令行指令
类型安全：完整的类型提示，减少开发错误
自动化友好：轻松集成到CI/CD管道和自动化脚本
全面覆盖：支持Docker Swarm的所有核心功能

快速开始：安装与初始化

首先，通过以下命令安装Python-on-Whales：

pip install python-on-whales

然后使用以下Python代码初始化一个Docker Swarm集群：

from python_on_whales import docker # 初始化Swarm管理器 docker.swarm.init(advertise_address="192.168.1.100") # 获取工作节点加入令牌 worker_token = docker.swarm.join_token("worker") print(f"Worker join token: {worker_token}")

核心功能：Swarm集群管理

节点管理

Python-on-Whales提供了简单的方法来管理Swarm集群中的节点：

# 获取所有节点 nodes = docker.node.list() for node in nodes: print(f"Node: {node.hostname}, Status: {node.status}") # 将节点设置为维护模式 docker.node.update("worker-1", availability="drain")

服务部署

部署服务变得异常简单，无需编写复杂的YAML文件：

# 创建一个简单的Web服务 docker.service.create( "nginx:alpine", name="web-service", replicas=3, publish=[("8080", 80)], placement=[{"constraint": "node.role == worker"}] ) # 扩展服务 docker.service.scale("web-service", 5)

资源管理

Docker Swarm支持通用资源分配，Python-on-Whales让这一过程更加直观：

# 声明节点资源（在daemon.json中配置） # { # "node-generic-resources": ["gpu=UUID1", "gpu=UUID2"] # } # 创建需要GPU资源的服务 docker.service.create( "nvidia/cuda:11.0-base", name="gpu-service", generic_resources=[{"kind": "gpu", "value": 1}] )

高级操作：Swarm配置与安全

自动锁定与解锁

增强Swarm集群安全性的关键功能：

# 启用自动锁定 docker.swarm.update(autolock=True) # 获取解锁密钥（妥善保存） unlock_key = docker.swarm.unlock_key() print(f"Swarm unlock key: {unlock_key}") # 解锁Swarm（重启后需要） docker.swarm.unlock(unlock_key)

证书轮换

保持集群安全的重要措施：

# 轮换Swarm CA证书 docker.swarm.ca(rotate=True) # 设置证书过期时间 from datetime import timedelta docker.swarm.update(cert_expiry=timedelta(days=30))

实战案例：部署多服务应用

下面是一个完整的例子，展示如何使用Python-on-Whales部署一个包含Web前端和数据库的多服务应用：

from python_on_whales import docker # 初始化Swarm（如果尚未初始化） docker.swarm.init(advertise_address="192.168.1.100") # 创建网络 docker.network.create("app-network", driver="overlay") # 部署数据库服务 docker.service.create( "postgres:13", name="db", networks=["app-network"], environment=["POSTGRES_PASSWORD=secret"], mounts=["db-data:/var/lib/postgresql/data"], placement=[{"constraint": "node.role == manager"}] ) # 部署Web服务 docker.service.create( "my-web-app:latest", name="web", networks=["app-network"], environment=["DB_HOST=db"], publish=[("80", 8080)], replicas=3, update_config={"parallelism": 1, "delay": 10} ) # 检查服务状态 services = docker.service.list() for service in services: print(f"Service: {service.name}, Replicas: {service.replicas}")