CNB Docs

English

简体中文

English

简体中文
简体中文

Appearance

Single/Double Container Mode​

Copy page

About 532 wordsAbout 2 min

Cloud-native development supports two launch modes:

  • Single Container Mode: Development environment and code-server run in the same container
  • Double Container Mode: Development environment and code-server run in separate containers, with the workspace (/workspace) directories shared between them

Development Environment: A container specified via .ide/Dockerfile or a custom image, or the default CNB container environment, which includes user-installed or pre-installed software.

Single Container Mode

Single container mode is recommended. The following methods start in single container mode:

Starting with Default Configuration

When no configuration is set (i.e., no startup pipeline and .ide/Dockerfile), the development environment starts with default configuration. The default environment has code-server and ssh installed, so it uses single container mode, supporting both WebIDE and VSCode remote development.

See Default Development Environment for details.

Starting with Custom Configuration

When a startup pipeline or .ide/Dockerfile is configured, and the custom image or .ide/Dockerfile has code-server installed, single container mode is used.

The following three methods all start in single container mode (all launch images have code-server installed):

Double Container Mode

When the development environment container doesn't have code-server installed, the system will start an additional code-server container to provide code service — this is double container mode. The workspace (/workspace) directories are shared between the two containers.

The following two methods will start in double container mode:

Docker Image Without code-server Installed

.cnb.yml
$:
  vscode:
    # Docker image without code-server service installed
    - docker:
        image: node:22
      services:
        - vscode
        - docker
      # Tasks to execute after the development environment starts
      stages:
        - name: ls
          script: ls -al

Custom Dockerfile Without code-server Installed

# .ide/Dockerfile

# You can replace node with your required base image
FROM node:20

# Install software as needed
RUN apt-get update && apt-get install -y git wget unzip openssh-server

# Specify character set to support Chinese input in command line (choose character set as needed)
ENV LANG C.UTF-8
ENV LANGUAGE C.UTF-8

Double Container Mode — Cross-Container Terminal

In double container mode, accessing WebIDE or VSCode actually connects to the code-server container. To access the development environment container, you can use the cross-container terminal provided in WebIDE or VSCode — the default terminal is a cross-container terminal named CNB.

If the development environment container doesn't support git, switch to a non-CNB terminal to use the built-in code-server terminal for git operations.

Double Container Mode — Plugin Capability Limitations

In double container mode, VSCode plugins are installed in the code-server container and may not be able to access the development environment container (such as Debug and other features that require access to it).

© 2026 cnb.cool