先决条件

本地开发容器的先决条件

• 您拥有一个项目，其中包含带有 devcontainer.json 文件的 .devcontainer 文件夹，该文件用于描述实际的开发容器。

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

  • 构建属性 受支持。

  • 常规属性。

  • Docker Compose 属性 受支持。

  • 生命周期脚本 受支持。

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

  • 不支持 最低主机要求。

  • 在 devcontainer.json 中的变量 受支持。

• 您可以访问 GitHub。

• 您的计算机已安装 Git 2.20.1 或更高版本。

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

  例如，在 Windows 上，使用 SSH URL 从 GitHub 仓库构建开发容器时，如果没有正在运行的 SSH 代理，则无法执行 - git clone 操作（将仓库源代码克隆到连接到辅助容器的 Docker 卷）。

• 在将运行开发容器的计算机上已安装 Docker。

• 对于挂载源代码，后端的最低要求是安装了 Docker。 尚不支持 Docker 的替代方案，例如 Colima 等。 对 Podman 的支持正在开发中。

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

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

远程开发容器的其他先决条件

以下是在远程服务器上运行开发容器的其他先决条件：

• 远程与本地计算机均已安装 Docker。

• 对服务器和 Git 的身份验证通过 SSH 密钥完成。 如果使用密码连接远程服务器，请在本地生成密钥对，然后将其转发到远程服务器。 有关详细信息，请参阅 共享凭据。

• 远程服务器需要 Java 17 或更高版本。

• 开发容器可能需要一些其他依赖项。

  如果您的开发容器无法启动，请确保在 devcontainer.json 文件中为开发容器的操作系统指定以下依赖项：

  • curl

  • unzip

  • ps

  • libxext

  • libxrender

  • libxtst

  • libxi

  • freetype

  • procps

  • gcompat