前提条件

本地 Dev Container 的前提条件

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

  当前， devcontainer.json 文件的代码补全功能有限。 但以下属性可用：

  • 支持 构建属性。

  • 常规属性。

  • 支持 Docker compose 属性。

  • 支持 生命周期脚本。

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

  • 不支持 最小主机要求。

  • 支持 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