joffrey/docker-py

Docker SDK for Python

这是一个针对Docker Engine API的Python库，允许您在Python应用程序中完成docker命令所能实现的所有操作，例如运行容器、管理容器、管理Swarm集群等。

核心功能

• 运行容器（支持前台及后台模式）
• 管理容器（列出、获取、停止、查看日志等）
• 管理镜像（拉取、列出镜像等）
• 管理Swarm集群（相关操作支持）
• 支持通过TLS连接Docker主机

使用场景

• Python应用中集成Docker操作，实现自动化容器部署与管理
• 开发Docker相关的自动化工具或脚本
• 构建基于Python的Docker管理平台

配置说明

安装

最新稳定版本可通过PyPI获取：

• 基础安装：pip install docker
• 若需通过TLS连接Docker主机：pip install docker[tls]

连接Docker

通过默认套接字或环境配置连接Docker：

python
import docker
client = docker.from_env()

使用示例

运行容器

python
# 前台运行容器
client.containers.run("ubuntu:latest", "echo hello world")

# 后台运行容器
container = client.containers.run("bfirsh/reticulate-splines", detach=True)

管理容器

python
# 列出所有容器
client.containers.list()

# 获取指定容器
container = client.containers.get('容器ID')

# 查看容器日志
container.logs()

# 停止容器
container.stop()

管理镜像

python
# 拉取镜像
client.images.pull('nginx')

# 列出所有镜像
client.images.list()

更多功能请参考完整文档。