如何用Python Docker SDK无Dockerfile编程构建Docker镜像

核心思路是通过临时容器模拟Dockerfile的构建步骤：先基于基础镜像启动一个可交互的临时容器，在容器内依次执行文件复制、依赖安装、自定义命令等操作，每一步捕获执行输出，最后将修改后的容器提交为新镜像，完成后清理临时容器。

分步实现与代码示例 #

1. 初始化Docker客户端 #

创建Docker客户端实例，默认连接本地Docker daemon（远程环境需额外配置参数）。

import docker
from docker.errors import DockerException, APIError

# 初始化Docker客户端
try:
    client = docker.from_env()
except DockerException as e:
    print(f"连接Docker daemon失败: {str(e)}")
    exit(1)

2. 创建临时容器 #

基于指定基础镜像启动后台运行的临时容器，开启tty和stdin保证命令正常执行。

base_image = "python:3.10-slim"
container_name = "temp-build-container"

try:
    # 启动容器并保持运行状态
    container = client.containers.run(
        base_image,
        command="tail -f /dev/null",
        name=container_name,
        detach=True,
        tty=True,
        stdin_open=True
    )
    print(f"临时容器 {container_name} 启动成功，ID: {container.id[:12]}")
except APIError as e:
    print(f"创建容器失败: {str(e)}")
    exit(1)

3. 执行容器内命令（模拟RUN指令） #

封装命令执行函数，捕获每条命令的退出码、标准输出和错误输出，用于日志和错误处理。

def run_container_command(container, cmd):
    """执行容器内命令并返回执行结果"""
    try:
        result = container.exec_run(cmd, stream=False)
        stdout = result.output.decode('utf-8').strip()
        stderr = result.output.decode('utf-8').strip() if result.exit_code != 0 else ""
        return {
            "exit_code": result.exit_code,
            "stdout": stdout,
            "stderr": stderr
        }
    except APIError as e:
        return {
            "exit_code": -1,
            "stdout": "",
            "stderr": str(e)
        }

# 示例1：安装系统依赖
cmd_system = "apt-get update && apt-get install -y gcc --no-install-recommends"
result_system = run_container_command(container, cmd_system)
if result_system["exit_code"] != 0:
    print(f"命令执行失败: {cmd_system}\n错误信息: {result_system['stderr']}")
    container.stop()
    container.remove()
    exit(1)
print(f"命令执行成功: {cmd_system}\n输出: {result_system['stdout']}")

# 示例2：安装Python依赖
cmd_pip = "pip install flask requests"
result_pip = run_container_command(container, cmd_pip)
if result_pip["exit_code"] != 0:
    print(f"命令执行失败: {cmd_pip}\n错误信息: {result_pip['stderr']}")
    container.stop()
    container.remove()
    exit(1)
print(f"命令执行成功: {cmd_pip}\n输出: {result_pip['stdout']}")

4. 复制本地文件到容器（模拟COPY指令） #

通过内存tar归档的方式，将本地文件/目录高效复制到容器指定路径。

import tarfile
import io

def copy_local_to_container(container, local_path, container_path):
    """将本地文件/目录复制到容器内"""
    try:
        # 创建内存tar归档
        tar_stream = io.BytesIO()
        with tarfile.open(fileobj=tar_stream, mode='w') as tar:
            tar.add(local_path, arcname='.')
        tar_stream.seek(0)
        
        # 复制到容器目标路径
        container.put_archive(container_path, tar_stream)
        return {"success": True, "error": ""}
    except Exception as e:
        return {"success": False, "error": str(e)}

# 示例：复制本地项目目录到容器/app路径
copy_result = copy_local_to_container(container, "./my_project", "/app")
if not copy_result["success"]:
    print(f"复制文件失败: {copy_result['error']}")
    container.stop()
    container.remove()
    exit(1)
print("本地文件复制到容器成功")

5. 设置镜像默认启动命令（模拟CMD/ENTRYPOINT） #

可以通过执行命令生成启动脚本，或者在提交镜像时直接指定启动命令。

# 生成启动脚本
container.exec_run("echo 'python /app/main.py' > /start.sh && chmod +x /start.sh")

6. 提交容器为新镜像 #

将修改后的容器提交为带标签的新镜像。

new_image_tag = "my-custom-app:v1.0"
try:
    image = container.commit(
        repository="my-custom-app",
        tag="v1.0",
        message="通过Python SDK构建的自定义应用镜像",
        command="/start.sh"
    )
    print(f"新镜像构建成功: {new_image_tag}，镜像ID: {image.id[:12]}")
except APIError as e:
    print(f"提交镜像失败: {str(e)}")
    container.stop()
    container.remove()
    exit(1)

7. 清理临时容器 #

构建完成后，停止并删除临时容器，避免资源占用。

try:
    container.stop()
    container.remove()
    print(f"临时容器 {container_name} 已清理")
except APIError as e:
    print(f"清理容器失败: {str(e)}")

关键注意事项 #

• 所有操作需添加异常处理，防止构建失败后残留容器资源。
• 若需实时获取长命令输出，可将exec_run的stream参数设为True，逐行读取输出。
• 复制大文件时，使用put_archive比逐个文件复制效率更高。

内容的提问来源于stack exchange，提问作者Omar Al-Howeiti