单/双容器模式

787 字约 3 分钟

云原生开发支持两种启动模式：

单容器模式：开发环境与 code-server 在同一容器中运行
双容器模式：开发环境与 code-server 分别在两个容器中运行，两个容器的工作区（/workspace）目录互通

开发环境：用户通过 .ide/Dockerfile 或自定义镜像指定的容器，或 CNB 默认容器环境，其中包含用户自行安装或预装的软件。

单容器模式

推荐使用单容器模式，以下方式将以单容器模式启动：

使用默认配置启动

未做任何配置（即未配置启动流水线和 .ide/Dockerfile）时，使用默认配置启动。默认开发环境已安装 code-server 和 ssh 服务，因此使用单容器模式，同时支持 WebIDE 和 VSCode 远程开发。

详见默认开发环境。

使用自定义配置启动

配置了启动流水线或 .ide/Dockerfile，且自定义镜像或 .ide/Dockerfile 中已安装 code-server 时，使用单容器模式。

以下三种方式均使用单容器模式启动（启动镜像均已安装 code-server）：

双容器模式

当开发环境容器中未安装 code-server 时，系统会额外启动一个 code-server 容器提供代码服务，即双容器模式。两个容器的工作区（/workspace）目录互通。

以下两种方式会以双容器模式启动：

.cnb.yml
# 方式 1：使用未安装 code-server 的 Docker 镜像
$:
  vscode:
    - docker:
        image: node:22
      services:
        - vscode
        - docker
      stages:
        - name: ls
          script: ls -al

.ide/Dockerfile
# 方式 2：使用未安装 code-server 的自定义 Dockerfile
FROM node:20

RUN apt-get update && apt-get install -y git wget unzip openssh-server

ENV LANG C.UTF-8
ENV LANGUAGE C.UTF-8

两种方式的本质都是开发环境容器中未安装 code-server，系统会自动补充 code-server 容器形成双容器模式。

双容器模式 — 跨容器终端

双容器模式下，访问 WebIDE 或 VSCode 时实际连接的是 code-server 容器。要访问开发环境容器，可使用 WebIDE 或 VSCode 中提供的跨容器终端—— 默认打开的终端即为跨容器访问开发环境的终端，名为 CNB。

如果开发环境容器中不支持 git，可切换到非 CNB 终端，使用 code-server 自带的终端执行 git 操作。

双容器模式 — 插件能力限制

双容器模式下，VSCode 插件安装在 code-server 容器中，可能无法访问开发环境容器（如 Debug 等需要访问开发环境容器的功能）。