# 打造自己的CNB开发环境

## 简介

### CNB 是什么

CNB：Cloud Native Build ,中文：云原生构建  
怎么解释云原生这个概念呢？这是是一个软件开发方法论，是一个体系，这是一个变化的概念，可以理解他是从以exsi、openstack为代表的iaas开始，到以docker、k8s为代表的cicd，再到serverless，这是一个不断发展的过程。  
而云原生构建[CNB](https://cnb.cool),是腾讯推出的新一代以为云原生为核心打造的软件开发工具和资源。

### CNB 的优势

从云原生开始成为软件开发主流，CNB并不是第一个类似的产品，从github的Codespaces，到google的firbase studio，再到国内的csdn的inscode，菊厂的开发者空间，都是优秀的产品，但是也都有很致命的缺点，这这些缺点，却都让cnb给解决了：  
1. 以Codespaces、firbase为代表的国外产品访问速度慢，体验差  
2. 以inscode、开发者空间为代表的国内产品，免费额度少，对少金用户不友好（当然，菊厂提供的是鲲鹏cpu，在信创的路上还是独一份）  

cnb直接给满了以月均22工作日*8小时的8c16g的足够用的算力，顺带解决了一些程序员离不开却又访问体验差的网站（如github、dockerhub、npm仓库等等）！

## 开始

省略：微信扫码登录->创建根组织->创建项目  
然后，你就看到了这个页面：  
![1.png](https://developer.qcloudimg.com/http-save/yehe-4165153/104e03b9231f2485f2aed0de7bf4ecc0.png)

点击"云原生开发"，来到这里：    

![2.png](https://developer.qcloudimg.com/http-save/yehe-4165153/e798800b10960a9e961f8b657f855320.png)

这是一个标准版的webide，基于codeserver，然后我开始自定义自己习惯的环境：

### cnb配置的简单介绍

更多详细的见官方文档：[CNB帮助文档](https://docs.cnb.cool/zh/)  
以下是个人的理解和对文件的管理：  

![3.png](https://developer.qcloudimg.com/http-save/yehe-4165153/1318db450785f153ff4122022be452b3.png)

1. cnb的主配置文件  
🌰  
```yaml
$:
    vscode:
      - docker:  # 定制一个docker镜像作为开发环境
          build:
            dockerfile: .ide/Dockerfile
          volumes:   # cnb的超级缓存，可以加快启动
            - /pnpm-store:copy-on-write
            - node_modules:cow
        services:
          - vscode
          - docker  # 提供docker in docker
        stages:
          - name: vscode go  #等待coderserver准备好
            type: vscode:go
          - name: install nestjs  #初始化脚本，可以安装项目需要的一些工具
            script: |
              pnpm add -g @nestjs/cli
              pnpm install
        endStages:  # 关闭开发环境前的收尾环境，例如可以在这里定义关闭开发环境前，commit并push代码
          - name: byebye
            script: |
              echo "bye"


"**":
  web_trigger_one:  # 这个是配合界面触发的事件1
    - services:
        - docker
      stages:
        - name: set tag
          script: echo -n $(date "+%Y%m%d%H%M%S")
          exports: 
            info: bktag
        - name: test my default tag
          script: |
            echo "default tag: ${bktag}"
            echo "final tag: ${tag:-$bktag}"   #如果没填参数，准备一个默认值作为镜像的tag
        - name: docker login
          script:    # 登录docker，编译，打包，并推送到cnb的制品库
            - docker login -u ${CNB_TOKEN_USER_NAME} -p "${CNB_TOKEN}" ${CNB_DOCKER_REGISTRY}
        - name: docker build
          script:
            - docker build -t ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:latest -f ./deploy/Dockerfile .
        - name: docker push
          script:
            - docker push ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:latest
            - docker tag  ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:latest ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:${tag:-$bktag}
            - docker push ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:${tag:-$bktag}
  
  web_trigger_two:  # 这个是配合界面触发的事件2
    - stages:
        - name: deploy by using ansible  #使用ansible部署、更新项目
          image: plugins/ansible
          imports: https://cnb.cool/yiqiu/dev.env/-/blob/main/webdemo/nestdemo.yml  #将关键密钥信息存储到cnb的密钥库做隔离，以提高安全信
          settings:
            private_key: $PRIVATE_KEY
            inventory: deploy/ansible/hosts.conf
            playbook: deploy/ansible/playbook.yml              
```

注：  
密钥库：  只能同意web访问，可以用于存储账号密码密钥等信息

2. 开发环境相关的配置目录  
这里用于存放一些docker镜像环境的一些配置文件，例如构建镜像的dockerfile  

3. cnb环境相关的配置
这里用于存放cnb相关功能配置文件：  
a. settings.yml  
```yaml
workspace:
  launch:
    button:   #自定义启动开发环境的按钮，效果如下图
      name: 好好学习
      description: 天天向上
    cpus: 8  #开发环境资源配置
    disabled: false
    autoOpenWebIDE: false  #是否自动打开webide
```
启动开发环境按键自定义效果：  

![4.png](https://developer.qcloudimg.com/http-save/yehe-4165153/661acbbef9cdbec0f1820cf96a421184.png)

b. web_trigger.yml  
自定义功能按键配置文件：  
```yaml
branch:
  - buttons:
      - name: 构建
        description: 手工构建版本
        event: web_trigger_one 
        inputs:                                                                        
          tag:
            description: tag(默认为今天日期)
            required: false
            type: input
      - name: 发布
        description: 发布到服务器
        event: web_trigger_two 
        inputs:                                                                        
          tag:
            description: tag(默认为latest)
            required: false
            type: input            
```

这个配置文件中的事件函数（web_trigger_two），配合主配置文件（.cnb.yml）实现功能.  

自定义功能按键效果：  

![5.png](https://developer.qcloudimg.com/http-save/yehe-4165153/bbb34a46e5657d198ef962a2ff054fbb.png)


***下面详细说一下开发环境的定制： *** 

我把定制的开发环境，分为两个级别：
1. 系统级别： 
   我把这个理解为，你拿到一个新电脑，需要安装一些自己习惯的软件，对常用软件做一些细节习惯性的设置。  
   CNB是基于docker而不是基于云主机，所以，定制这部分，就相当于定制一个docker镜像。  
   我想以一个nest开发restful api为例，来演示如何定制系统级别的开发环境。所以这一步，定义一个含node环境的docker镜像。

### 定制一个node环境的docker镜像

这是我用来定制自己习惯的各种docker镜像的地方：https://cnb.cool/yiqiu/dev

以node环境来说明：  
```dockerfile
#以node官方的最新lts镜像为基础定制
FROM node:lts-trixie

# 安装一些自己习惯的linux系统管理工具：
RUN apt-get update -y && apt-get install -y wget curl unzip lsof nload htop net-tools dnsutils openssh-server zsh git git-lfs jq vim net-tools sysstat iputils-ping

# 安装codeserver,和最基础的3个插件：cnb的welcome，vscode的yaml，腾讯的coding-copilot
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 tencent-cloud.coding-copilot

# 安装ohmyzsh，和一些常用的插件：zsh-autosuggestions，zsh-syntax-highlighting
COPY ./scripts ./scripts

RUN sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" && \
    git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions && \
    git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting && \
    chmod +x ./scripts/*.sh && \
    ./scripts/add-zsh-plugins.sh zsh-autosuggestions zsh-syntax-highlighting && \
    ./scripts/set-zsh-env.sh && \
    echo 'setopt NO_AUTO_REMOVE_SLASH' >> /root/.zshrc && \
    cp ./scripts/commit.sh /usr/local/bin/commit && \
    chmod +x /usr/local/bin/commit && \
    chsh -s $(which zsh)

# 在最开始 source /etc/profile 
RUN sed -i '1isetopt NULL_GLOB 2>/dev/null\nsource /etc/profile\nunsetopt NULL_GLOB 2>/dev/null' $HOME/.zshrc

# 设置vscode的配置文件
COPY .ide/settings.json /root/.vscode-server/data/Machine/settings.json
COPY .ide/settings.json /root/.local/share/code-server/Machine/settings.json

#设置git的配置文件
COPY .ide/gitconfig /root/.gitconfig

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

ENTRYPOINT ["/usr/bin/zsh"]
```
   
2. 项目级别：  
更细化一点的配置，项目专属的，例如这个前段项目，规定使用pnpm管理、git管理的个性化配置等。  
所以可以在项目中，使用上一步配置的docker镜像作为基础，定制一些更详细的软件：  

```dockerfile
FROM docker.cnb.cool/yiqiu/dev:node

# 针对pnpm的配置
ENV PNPM_HOME="/usr/local/bin"
RUN pnpm config set store-dir /pnpm-store && pnpm add -g @nestjs/cli
```

## 愉快的编码

至此，一个如何自己编码喜欢的环境，就基本完成了，下面继续完成一个简单的restful demo：  

### 基于nest工具生成的一个demo

生成一个nest项目：  
```bash
nest new nest demo
```  

![6.png](https://developer.qcloudimg.com/http-save/yehe-4165153/fe7a05c3452cbfe060ed38af1aab60d7.png)

对这个默认的demo做个简单的修改，让返回的hello替换为为package.json里面的版本信息：  
```typescript
import { Injectable } from '@nestjs/common';
import { version,description } from '../package.json';

export interface VersionInfo {
  version: string;
  description?: string;
}

@Injectable()
export class AppService {
  getHello(): VersionInfo {
    return {"version": version, "description": description};
  }
}

```

启动测试：  

![7.png](https://developer.qcloudimg.com/http-save/yehe-4165153/a812f09d095f4deab4fb5b5a7612f257.png)

## 部署

cnb支持很多种方式部署，都已经被高手们玩出花了，可以在[CNB最佳实践](https://cnb.cool/examples/showcase)中找到自己喜欢的方式。就算不喜欢也可以自己定制，cnb插件市场支持以docker镜像作为插件来扩展其功能。  

对于一个简单的crud的小项目，我还是习惯于手工触发，以ansible为工具去部署，下面是一个过程：  

### 主要的配置文件

1. 首先需要一个打包的配置，打包为docker镜像：  

```dockerfile
###################
# BUILD STAGE
###################
FROM node:lts-alpine AS build
RUN npm install -g pnpm
WORKDIR /usr/src/app
COPY package*.json ./
COPY pnpm-lock.yaml ./
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm run build

###################
# PRODUCTION STAGE
###################
FROM node:lts-alpine AS production
WORKDIR /usr/src/app
COPY --from=build /usr/src/app/dist ./dist
COPY --from=build /usr/src/app/node_modules ./node_modules
COPY package.json ./
ENV NODE_ENV=production
EXPOSE 3000
CMD ["node", "dist/main.js"]
```

2. 一个编排文件  

一个使用docker compose的简单的编排文件：

```yaml
services:
  nestdemo:
    image: docker.cnb.cool/hello.cnb/demo/nestdemo:latest
    container_name: nestdemo
    restart: always
#    ports: #发布的时候，由caddy代理
#      - "3000:3000"
    volumes:
      - ../yaml:/usr/src/app/yaml

networks:
  default:
    external: true
    enable_ipv6: false
    name: netproxy      
```

3. ansible相关配置文件  

a. playbook.yml  ansible的配置文件：  

```yaml
---
- hosts: 
    - nestdemo
  remote_user: root
  vars:
    ansible_ssh_port: 22
  tasks:
    - name: hello
      shell: echo "$(date "+%Y-%m-%d %H:%M:%S") hello nestdemo, we going to updating your app">>/root/docker/nestdemo/ansible.log
    - name: exec update scripts
      script: update.sh
```

b. update.sh  发布更新的脚本：  
```bash
#!/bin/bash
{
# 定义目标目录
TARGET_DIR="/root/docker/nestdemo"

# 切换到目标目录
echo "正在切换到目录: $TARGET_DIR"
cd "$TARGET_DIR" || {
    echo "❌ 错误：无法切换到目录 $TARGET_DIR，请确认该目录存在且有访问权限。"
    exit 1
}

# 执行 docker compose down，并检查是否成功
echo "🔽 正在执行：docker compose down"
if docker compose down; then
    echo "✅ docker compose down 执行成功"
else
    echo "❌ 错误：docker compose down 执行失败，退出脚本。"
    exit 1
fi

# 执行 docker compose up -d --pull always
echo "🔼 正在执行：docker compose up -d --pull always"
if docker compose up -d --pull always; then
    echo "✅ docker compose up -d --pull always 执行成功"
else
    echo "❌ 错误：docker compose up -d --pull always 执行失败"
    exit 1
fi

echo "🎉 所有操作已完成！"
} >> /root/docker/nestdemo/ansible.log 2>&1
```

### 开始部署
1. 构建最新版本  

手动触发构建->默认构建tag->查看构建日志->查看制品

![16.png](https://developer.qcloudimg.com/http-save/yehe-4165153/589fa665f8ed22c11342024aa5a92ec5.png)

2. 自动远程部署  

手工触发发布->查看发布日志  

![13.png](https://developer.qcloudimg.com/http-save/yehe-4165153/44f11b28f83919f3365ce4eec048bd8b.png)


![14.png](https://developer.qcloudimg.com/http-save/yehe-4165153/2de27d6fe48b8de7c79ea1b64f1fe520.png)

3. 回归测试  

![15.png](https://developer.qcloudimg.com/http-save/yehe-4165153/b140e31dc5b3b4471a03cc3f35df6add.png)


好了，一个简单的cicd，就此完成！

demo源码： https://cnb.cool/hello.cnb/demo/nestdemo


## 还有

这个是简单的手工触发的例子，如果要实现自动，有一个问题是无法略过的，就是及时通知。

但是我的微信公众号没有认证，无法推送消息！！

所以，走了条弯路：注册企业微信，使用企业微信推送，然后使用微信的插件代收！

看看这个：

![17.png](https://developer.qcloudimg.com/http-save/yehe-4165153/ae0af60c4f2d8cc19b8ae19747249727.png)


得空再把这个过程写出来^_^


## 参考文献

[CNB帮助文档](https://docs.cnb.cool/zh/)
[CNB最佳实践](https://cnb.cool/examples/showcase)

CNB：Cloud Native Build ,中文：云原生构建  怎么解释云原生这个概念呢？这是是一个软件开发方法论，是一个体系，这是一个变化的概念，可以理解他是从以exsi、openstack为代表的iaas开始，到以docker、k8s为代表的cicd，再到serverless，这是一个不断发展的过程。  而云原生构建CNB,是腾讯推出的新一代以为云原生为核心打造的软件开发工具和资源。

打造自己的CNB开发环境

数据库

腾讯云原生构建(CNB)是一款基于云原生理念的软件开发工具，提供8c16g高性能算力资源，支持Docker镜像定制和WebIDE开发环境。相比GitHub Codespaces等产品，CNB具有访问速度快、免费额度充足等优势，内置对GitHub、DockerHub等仓库的加速访问，助力开发者高效构建云原生应用。

云原生构建

云原生开发

软件开发

回归测试

服务器

云主机

云原生

Docker

2026新春采购季

4核4G3M云服务器 新用户低至38元/年！

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

打造自己的CNB开发环境-腾讯云开发者社区-腾讯云

打造自己的CNB开发环境

打造自己的CNB开发环境

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐