尝试以扩展 VS Code 中的代理模式!

开发容器 CLI

本主题涵盖了开发容器命令行界面 (dev container CLI),它允许你构建和管理开发容器,并且是开发容器规范的配套工具。

开发容器

一致、可预测的环境是高效愉快的软件开发体验的关键。

容器(例如Docker 容器)在部署时历来用于标准化应用程序,但在支持更多场景方面存在巨大机遇,包括持续集成 (CI)、测试自动化和功能齐全的编码环境。开发容器提供了这种工作环境,并确保你的项目拥有所需的工具和软件,无论它是复杂且分布式的,还是只有少数要求。

Diagram comparing dev versus production containers

Visual Studio Code 通过开发容器扩展支持开发容器,GitHub Codespaces 也支持开发容器。这种支持是由devcontainer.json 提供支持的,它是一种带有注释的结构化 JSON (jsonc) 元数据格式,用于配置容器化环境。

随着容器化生产工作负载变得司空见惯,开发容器已广泛用于 VS Code 之外的场景。为了在任何环境中推广开发容器,开发容器规范的工作已经开始,它使任何工具中的任何人都能配置一致的开发环境。开源的 dev container CLI 作为该规范的参考实现。

dev container CLI

当像 VS Code 和 Codespaces 这样的工具在用户的项目中检测到 devcontainer.json 文件时,它们会使用 CLI 来配置开发容器。dev container CLI 是一个参考实现,因此个人用户和其他工具可以读取 devcontainer.json 元数据并从中创建开发容器。

此 CLI 可以直接使用或集成到产品体验中,类似于它目前与开发容器和 Codespaces 集成的方式。它目前支持简单的单容器选项,并与Docker Compose 集成,用于多容器场景。

该 CLI 位于 devcontainers/cli 仓库中。

安装

你可以通过开发容器扩展快速试用 CLI。从命令面板 (F1) 中选择开发容器:安装 devcontainer CLI 命令。

替代安装

在其他地方使用 CLI 还有其他选项

  • 安装其 npm 包
  • 使用 GitHub Action 或 Azure DevOps 任务
  • 从源代码构建 CLI 仓库

在本页中,我们将重点介绍如何使用 npm 包。

npm install

要安装 npm 包,你需要安装 Python、Node.js(版本 14 或更高)和 C/C++ 来构建其中一个依赖项。VS Code 的如何贡献 wiki 详细介绍了推荐的工具集。

npm install -g @devcontainers/cli

验证你可以运行 CLI 并查看其帮助文本

devcontainer <command>

Commands:
  devcontainer up                   Create and run dev container
  devcontainer build [path]         Build a dev container image
  devcontainer run-user-commands    Run user commands
  devcontainer read-configuration   Read configuration
  devcontainer features             Features commands
  devcontainer templates            Templates commands
  devcontainer exec <cmd> [args..]  Execute a command on a running dev container

Options:
  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]

注意:如果你通过 VS Code 安装了 CLI,将列出用于打开开发容器的 open 命令。

运行 CLI

安装 CLI 后,你可以使用一个示例项目(例如此Rust 示例)进行试用。

将 Rust 示例克隆到你的机器上,并使用 CLI 的 up 命令启动开发容器

git clone https://github.com/microsoft/vscode-remote-try-rust
devcontainer up --workspace-folder <path-to-vscode-remote-try-rust>

这将从容器注册表下载容器镜像并启动容器。你的 Rust 容器现在应该正在运行

[88 ms] dev-containers-cli 0.1.0.
[165 ms] Start: Run: docker build -f /home/node/vscode-remote-try-rust/.devcontainer/Dockerfile -t vsc-vscode-remote-try-rust-89420ad7399ba74f55921e49cc3ecfd2 --build-arg VARIANT=bullseye /home/node/vscode-remote-try-rust/.devcontainer
[+] Building 0.5s (5/5) FINISHED
 => [internal] load build definition from Dockerfile                       0.0s
 => => transferring dockerfile: 38B                                        0.0s
 => [internal] load .dockerignore                                          0.0s
 => => transferring context: 2B                                            0.0s
 => [internal] load metadata for mcr.microsoft.com/vscode/devcontainers/r  0.4s
 => CACHED [1/1] FROM mcr.microsoft.com/vscode/devcontainers/rust:1-bulls  0.0s
 => exporting to image                                                     0.0s
 => => exporting layers                                                    0.0s
 => => writing image sha256:39873ccb81e6fb613975e11e37438eee1d49c963a436d  0.0s
 => => naming to docker.io/library/vsc-vscode-remote-try-rust-89420ad7399  0.0s
[1640 ms] Start: Run: docker run --sig-proxy=false -a STDOUT -a STDERR --mount type=bind,source=/home/node/vscode-remote-try-rust,target=/workspaces/vscode-remote-try-rust -l devcontainer.local_folder=/home/node/vscode-remote-try-rust --cap-add=SYS_PTRACE --security-opt seccomp=unconfined --entrypoint /bin/sh vsc-vscode-remote-try-rust-89420ad7399ba74f55921e49cc3ecfd2-uid -c echo Container started
Container started
{"outcome":"success","containerId":"f0a055ff056c1c1bb99cc09930efbf3a0437c54d9b4644695aa23c1d57b4bd11","remoteUser":"vscode","remoteWorkspaceFolder":"/workspaces/vscode-remote-try-rust"}

然后你可以在此开发容器中运行命令

devcontainer exec --workspace-folder <path-to-vscode-remote-try-rust> cargo run

这将编译并运行 Rust 示例,输出

[33 ms] dev-containers-cli 0.1.0.
   Compiling hello_remote_world v0.1.0 (/workspaces/vscode-remote-try-rust)
    Finished dev [unoptimized + debuginfo] target(s) in 1.06s
     Running `target/debug/hello_remote_world`
Hello, VS Code Dev Containers!
{"outcome":"success"}

以上这些步骤也在 CLI 仓库的README 中提供。

自动化

如果你想在 CI/CD 构建或测试自动化中使用 dev container CLI,你可以在devcontainers/ci 仓库中找到 GitHub Actions 和 Azure DevOps 任务的示例。

预构建

devcontainer build 命令允许你按照与开发容器扩展或 GitHub Codespaces 相同的步骤快速构建开发容器镜像。当你希望使用 CI 或 DevOps 产品(如 GitHub Actions)预构建开发容器镜像时,这特别有用。

build 接受包含 .devcontainer 文件夹或 .devcontainer.json 文件的文件夹路径。例如,devcontainer build --workspace-folder <my_repo> 将为 my_repo 构建容器镜像。

构建和发布镜像的示例

例如,你可能希望预构建一些镜像,然后将其重用于多个项目或仓库。为此,请按照以下步骤操作

  1. 创建一个源代码仓库。

  2. 为要预构建的每个镜像创建开发容器配置,并根据需要进行自定义(包括开发容器功能)。例如,考虑这个 devcontainer.json 文件

    {
      "build": {
        "dockerfile": "Dockerfile"
      },
      "features": {
        "ghcr.io/devcontainers/features/docker-in-docker:1": {
          "version": "latest"
        }
      }
    }
    
  3. 使用 devcontainer build 命令构建镜像并将其推送到你的镜像注册表。有关镜像命名和额外步骤(例如身份验证)的信息,请参阅你的镜像注册表文档(例如Azure 容器注册表GitHub 容器注册表Docker Hub)。

    devcontainer build --workspace-folder <my_repo> --push true --image-name <my_image_name>:<optional_image_version>
    

避免使用 Docker 构建镜像时出现问题

鉴于 Dockerfile 和 Docker Compose 文件可以在没有 VS Code 或 devcontainer CLI 的情况下使用,你可能希望让用户知道他们不应该直接构建镜像。你可以在高级开发容器文档中了解更多信息。

模板和功能

你可以使用 dev container CLI 处理开发容器模板功能。当你创建和使用模板时,你可能希望将它们发布给其他人,你可以在dev container 规范中了解更多信息。

反馈

dev container CLI 和规范正在积极开发中,我们欢迎你的反馈,你可以在此问题中提供反馈,或通过devcontainers/cli 仓库中的新问题和拉取请求提供反馈。

后续步骤