VSCode DevContainer执行check-requirements.sh脚本失败求助

核心原因 #

Python distroless镜像的极简设计导致缺少VS Code Server初始化所需的基础工具——这类镜像仅保留运行Python程序的必要组件，没有bash解释器、coreutils（如cat/echo/id）等check-requirements.sh依赖的基础命令，因此脚本执行失败。

解决方案 #

1. 自定义distroless镜像，补充必要依赖（推荐）

通过多阶段构建，从标准Linux镜像（如Debian）中复制所需工具到distroless镜像，保留其轻量化特性的同时满足VS Code Server需求。示例Dockerfile：

# 第一阶段：从基础镜像获取依赖工具
FROM debian:bookworm-slim as tooling
RUN apt-get update && apt-get install -y --no-install-recommends \
    bash coreutils curl

# 第二阶段：基于Python distroless镜像构建最终容器
FROM gcr.io/distroless/python3-debian12
# 复制必要工具到distroless镜像
COPY --from=tooling /bin/bash /bin/bash
COPY --from=tooling /bin/cat /bin/cat
COPY --from=tooling /bin/echo /bin/echo
COPY --from=tooling /usr/bin/curl /usr/bin/curl
COPY --from=tooling /usr/bin/id /usr/bin/id

# 常规配置：设置工作目录、复制项目文件等
WORKDIR /app
COPY . .

2. 跳过VS Code Server的需求检查（临时方案）

在devcontainer.json中添加环境变量，强制跳过需求检查脚本：

{
  "image": "gcr.io/distroless/python3-debian12",
  "remoteEnv": {
    "VSCODE_SKIP_REQUIREMENTS_CHECK": "1"
  }
}

⚠️ 注意：此方法可能导致终端无法正常启动、部分扩展功能失效，仅适合临时测试使用。

3. 使用distroless的Debug变体

部分distroless镜像提供包含基础shell和工具的debug版本，直接替换镜像标签即可：

{
  "image": "gcr.io/distroless/python3-debian12:debug"
}

此变体体积略大于标准distroless镜像，但无需额外构建即可满足VS Code Server的运行需求。

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