Windows环境下Docker Entrypoint脚本编写及多Python程序单容器运行

1. 基础镜像与Dockerfile编写 #

选择适配Windows的官方Python镜像（以ServerCore为例，兼容性更好），将所有Python程序复制到容器内，并配置PowerShell作为入口脚本载体：

# 选择Windows ServerCore基础的Python镜像
FROM mcr.microsoft.com/windows/servercore/python:3.11-windowsservercore-ltsc2022

# 设置容器内工作目录
WORKDIR C:\app

# 复制本地所有Python程序到容器工作目录
COPY ./scripts/ .

# 复制自定义入口脚本
COPY entrypoint.ps1 .

# 配置容器启动时执行PowerShell入口脚本
ENTRYPOINT ["powershell.exe", "-ExecutionPolicy", "Bypass", "-File", "C:\\app\\entrypoint.ps1"]

2. 编写PowerShell入口脚本（entrypoint.ps1） #

脚本核心作用是让容器持续运行，同时支持启动时直接执行指定程序，后续也可通过docker exec按需调用其他程序：

# 处理启动时传入的程序名参数（可选）
if ($args.Count -ge 1) {
    $targetScript = $args[0]
    Write-Host "Starting specified script: $targetScript"
    # 执行指定Python程序
    python.exe $targetScript
}

# 保持容器长期运行（等待一个永远不会触发的事件，避免容器退出）
Wait-Event -Name "ContainerKeepAlive"

3. 构建镜像与启动容器 #

构建镜像 #

在Dockerfile所在目录执行：

docker build -t windows-python-multi-app .

启动持续运行的容器 #

方式1：单纯启动容器（后续按需执行程序）

docker run -d --name persistent-python-container windows-python-multi-app

方式2：启动时直接执行某个程序，容器仍保持运行

docker run -d --name persistent-python-container windows-python-multi-app app1.py

4. 按需执行/启停Python程序 #

执行指定程序 #

通过docker exec进入运行中的容器，直接调用目标Python脚本：

# 执行前台程序（执行完成后返回控制台）
docker exec persistent-python-container python.exe app2.py

# 后台运行程序（适合服务类脚本）
docker exec persistent-python-container powershell.exe -Command "Start-Job -ScriptBlock { python.exe app3.py }"

管理后台运行的程序 #

查看后台作业状态：

docker exec persistent-python-container powershell.exe -Command "Get-Job"

停止指定后台作业（替换<JobId>为实际作业ID）：

docker exec persistent-python-container powershell.exe -Command "Stop-Job -Id <JobId>"

关键注意事项 #

• 镜像选择：若追求轻量化可使用nanoserver基础镜像，但需注意其PowerShell功能受限，部分命令可能无法运行；servercore兼容性更强，适合大多数场景。
• 依赖安装：若Python程序有第三方包依赖，需在Dockerfile中添加RUN pip install -r requirements.txt步骤。
• 路径配置：Windows容器内使用Windows风格路径（如C:\app），Docker会自动转换/app这类Unix风格路径为Windows格式。

内容的提问来源于stack exchange，提问作者jawahar venkat