前提条件

本地 Dev Container 的前提条件

• 您拥有一个包含 .devcontainer 文件夹的项目，其中的 devcontainer.json 文件描述了实际的 Dev Container。

  目前，对 devcontainer.json 文件的代码补全功能有限。 但支持以下属性：

  • 支持 构建属性。

  • 常规属性。

  • 支持 Docker compose 属性。

  • 支持 生命周期脚本。

  • 在 端口属性 中，仅支持 标签。

  • 不支持 最小主机要求。

  • 支持 devcontainer.json 中的变量。

• 您可以访问 GitHub。

• 您的机器上已安装 Git 2.20.1 或更高版本。

• 您的本地计算机上有一个 正在运行的 SSH agent。

  例如，在 Windows 上，若使用 SSH URL 从 GitHub 仓库构建 Dev Container，则无法在没有运行中的 SSH agent 的情况下执行 - git clone 操作（将仓库源克隆到连接了辅助容器的 Docker 卷中）。

• 在将 Dev Container 部署到的计算机上，需安装 Docker。

• 挂载源码所需的最低后端要求是已安装的 Docker。 不支持 Docker 替代项，例如 Colima 或类似工具。 Podman 的支持正在开发中。

  如果您在使用这些 Docker 替代项时遇到问题，请向问题跟踪器提交错误报告。

• 您的 Docker 资源满足后端的 最低系统要求。

远程 Dev Container 的其他前提条件

以下是将 Dev Container 运行于远程服务器的其他前提条件列表：

• 远程和本地机器上都安装了 Docker。

• 对服务器和 Git 的授权是通过 SSH 密钥完成的。 如果通过密码连接到远程服务器，请在本地生成密钥对并转发至远程服务器。 如需了解详细信息，请参阅 共享凭据。

• 远程服务器上必须安装 Java 17 或更高版本。

• Dev Container 可能还需要一些附加依赖项。

  如果 Dev Container 无法启动，请确保在 devcontainer.json 文件中，Dev Container 的操作系统已包含以下依赖项：

  • curl

  • unzip

  • ps

  • libxext

  • libxrender

  • libxtst

  • libxi

  • freetype

  • procps

  • gcompat