参加你附近的 ,了解 VS Code 中的 AI 辅助开发。

减少 Docker 构建警告

以下是一些消除 Dockerfile 构建中可能出现的警告的技巧。

debconf: 延迟软件包配置,因为 apt-utils 未安装

这个错误通常可以安全地忽略,并且很难完全消除。但是,您可以通过将以下内容添加到 Dockerfile 中,将其减少到在安装所需软件包时在标准输出中显示一条消息:

RUN apt-get update \
    && export DEBIAN_FRONTEND=noninteractive \
    && apt-get -y install --no-install-recommends apt-utils dialog 2>&1

警告:apt-key 输出不应被解析(标准输出不是终端)

这个非关键警告告诉您不要解析 apt-key 的输出,因此只要您的脚本不解析,就没有问题。您可以安全地忽略它。

这在 Dockerfile 中发生,因为 apt-key 命令不是从终端运行的。不幸的是,这个错误无法完全消除,但可以隐藏,除非 apt-key 命令返回非零退出代码(表示失败)。

例如

# (OUT=$(apt-key add - 2>&1) || echo $OUT) will only print the output with non-zero exit code is hit
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | (OUT=$(apt-key add - 2>&1) || echo $OUT)

您还可以设置 APT_KEY_DONT_WARN_ON_DANGEROUS_USAGE 环境变量来抑制警告,但这看起来有点吓人,因此如果您使用它,请务必在 Dockerfile 中添加注释。

# Suppress an apt-key warning about standard out not being a terminal. Use in this script is safe.
ENV APT_KEY_DONT_WARN_ON_DANGEROUS_USAGE=DontWarn

以红色显示的信息消息

一些 CLI 将某些信息(例如调试详细信息)输出到标准错误而不是标准输出。这些将在 Visual Studio Code 的终端和输出日志中以红色显示。

如果消息无害,您可以通过在命令末尾添加 2>&1 将命令的输出从标准错误重定向到标准输出。

例如

RUN apt-get -y install --no-install-recommends apt-utils dialog 2>&1

如果命令失败,您仍然可以看到错误,但它们不会是红色的。

避免 Docker 构建镜像出现问题

鉴于 Dockerfile 和 Docker Compose 文件可以在没有 VS Code 或 devcontainer CLI 的情况下使用,您可能希望让用户知道,如果镜像无法按预期工作,他们不应尝试直接构建它。为了解决这个问题,您可以添加一个需要指定才能正常工作的构建参数。

例如,您可以将以下内容添加到 Dockerfile 中:

ARG vscode
RUN if [[ -z "$devcontainercli" ]] ; then printf "\nERROR: This Dockerfile needs to be built with VS Code !" && exit 1; else printf "VS Code is detected: $devcontainercli"; fi

并将以下内容添加到 devcontainer.json 中:

"build": {
      "dockerfile": "Dockerfile",
      "args": {
          // set devcontainer-cli arg for Dockerfile
          "devcontainercli": "true"
      },
    }

对于 Docker Compose,您可以将此参数添加到单独的覆盖文件以扩展您的配置,该文件位于源代码树中与主 Docker Compose 文件不同的位置。