### Python 3.10 与 Docker API 的集成与使用 Python 3.10 可以通过 `docker-py` 或 `docker-sdk-for-python`（官方推荐的 Docker SDK for Python）与 Docker API 进行集成。以下是一个详细的说明，包括如何安装、配置以及实现基本功能。 #### 安装 Docker SDK for Python 要将 Python 与 Docker 集成，首先需要安装 Docker SDK for Python。可以通过以下命令安装： ```bash pip install docker ``` 确保已安装最新版本的 `docker` 包，并且 Docker 服务正在运行[^5]。 #### 基本示例：连接到 Docker 守护进程 以下是一个简单的示例，展示如何使用 Python 脚本连接到本地 Docker 守护进程并列出所有容器： ```python import docker # 创建一个 Docker 客户端实例 client = docker.from_env() # 列出所有正在运行的容器 containers = client.containers.list() for container in containers: print(f"Container ID: {container.id}, Name: {container.name}") ``` 上述代码通过 `from_env()` 方法从环境变量中读取 Docker 的配置信息，并连接到本地 Docker 守护进程[^6]。 #### 构建和运行容器 可以使用 Docker SDK 来构建镜像并运行容器。以下是一个完整的示例： ```python import docker client = docker.from_env() # 构建镜像 image, build_logs = client.images.build( path=".", # Dockerfile 所在路径 tag="my-flask-app:latest" ) # 打印构建日志 for log in build_logs: print(log) # 运行容器 container = client.containers.run( "my-flask-app:latest", detach=True, ports={'8080/tcp': 8080} # 端口映射 ) print(f"Container {container.short_id} is running") ``` 上述代码展示了如何通过 Python 脚本构建镜像并运行容器，同时指定了端口映射[^7]。 #### 使用低级 API 如果需要更精细的控制，可以使用低级 API。例如，通过 `APIClient` 类直接调用 Docker 的 REST API： ```python from docker import APIClient client = APIClient(base_url='unix://var/run/docker.sock') # 拉取镜像 client.pull('alpine', tag='latest') # 创建容器 container = client.create_container( image='alpine:latest', command='/bin/echo Hello World' ) # 启动容器 client.start(container=container.get('Id')) # 获取日志 logs = client.logs(container=container.get('Id')) print(logs.decode('utf-8')) # 移除容器 client.remove_container(container=container.get('Id'), force=True) ``` 上述代码展示了如何使用低级 API 执行更复杂的操作，如拉取镜像、创建和启动容器、获取日志以及清理资源[^8]。 #### 注意事项 1. **Docker 版本兼容性**：确保 Docker 版本与 Python SDK 兼容。如果使用较新的 Docker 功能，请检查 SDK 是否支持。 2. **权限问题**：在 Linux 上运行时，可能需要为用户授予访问 `/var/run/docker.sock` 的权限。 3. **Python 3.10 支持**：`docker-py` 和 `docker-sdk-for-python` 应该完全支持 Python 3.10，但建议查看其官方文档以确认最新支持情况[^9]。 --- ###