Custom Development Environment

About 355 wordsAbout 1 min

Specifying Development Environment via Docker Image

You can specify the development environment by writing a Workspaces event pipeline in .cnb.yml and setting pipeline.docker.

If the specified image has code-server installed, it will start in single-container mode; otherwise, it will start in dual-container mode.

.cnb.yml
$:
  vscode:
    - docker:
        image: cnbcool/default-dev-env:latest
        # build: .ide/Dockerfile
      services:
        - vscode
        - docker
      stages:
        - name: ls
          script: ls -al

Two options are available for specifying the development environment image:

image: Use a pre-built image directly (for pre-configured image scenarios)
build: Custom build via Dockerfile (choose one with image; you can also specify image as a fallback)

Customizing Development Environment via Dockerfile

If specifying an image doesn't meet your needs, you can create a .ide/Dockerfile in the repository root to customize the development environment.

When no custom startup pipeline is defined, the system prioritizes using .ide/Dockerfile to build the base image. If .ide/Dockerfile doesn't exist or the build fails, it falls back to the default image.

# .ide/Dockerfile

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

# Install code-server and common VSCode extensions
RUN curl -fsSL https://code-server.dev/install.sh | sh \
  && code-server --install-extension cnbcool.cnb-welcome \
  && code-server --install-extension redhat.vscode-yaml \
  && code-server --install-extension dbaeumer.vscode-eslint \
  && code-server --install-extension mhutchie.git-graph \
  && echo done

# Install SSH service to support accessing the development environment via VSCode Remote-SSH (and other 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

Customizing Both Development Environment and Startup Process

To customize both the development environment and startup process, write .ide/Dockerfile and .cnb.yml. The Dockerfile content is the same as above.

In .cnb.yml, enable build: .ide/Dockerfile (see Option 2 in the example above), and optionally specify image as a fallback.