> 推荐前往博客以获得更好的阅读体验：https://owo.cab/218/

## 前言

以下是官方对 CNB 和 Lighthouse 的简单介绍：

**云原生构建（Cloud Native Build，CNB）**提供代码托管、云原生构建、云原生开发、AI 代码助手和制品库等功能。基于 Docker 生态，对环境、缓存、插件进行抽象，通过声明式的语法，帮助开发者以更酷的方式构建软件。

**轻量应用服务器（Tencent Cloud Lighthouse）**是新一代开箱即用、面向轻量应用场景的云服务器产品，助力中小企业和开发者便捷高效的在云端构建网站、Web应用、小程序/小游戏、AI Agent、游戏服、电商应用、云盘和开发测试环境，相比普通云服务器更加简单易用且更贴近应用，以高性价比套餐形式整体售卖云资源，将热门软件打包实现一键构建应用，提供极简上云体验。

------

本文将结合 CNB 和 Lighthouse 的功能，以 Hexo 和 Go 为例，从前端的静态站点部署和后端的 Docker 容器化部署两方面，讲讲 CNB 和 Lighthouse 在构建和部署上的用法。

坐稳扶好，我们发车咯~

## 以 Hexo 为例的静态站点构建与部署

这是我的博客，由 Hexo 驱动，目前在 CNB 和 GitHub 均有仓库且都为私有仓库：

![CNB的私有仓库](https://developer.qcloudimg.com/http-save/yehe-7153982/cfb63f1acc21fc1a7bab48ce6ddccd9d.webp "CNB的私有仓库")

![GitHub的私有仓库](https://developer.qcloudimg.com/http-save/yehe-7153982/1bd138e59f4c0088fb0d5a223b1a9489.webp "GitHub的私有仓库")

因此我的需求很简单：

- 由于 CNB 在大陆的拉取和推送体验优于 GitHub，每次更新博客后会推送到 CNB，希望能自动同步到 GitHub；
- 推送后自动运行 Hexo 生成器进行构建并打包产物；
- 将构建产物安全部署到服务器。

下面我将通过 CNB 提供的 [git-sync](https://cnb.cool/cnb/plugins/tencentcom/git-sync)、[attachments](https://cnb.cool/cnb/plugins/cnbcool/attachments)、[tcloud-cmd](https://cnb.cool/cnb/plugins/tencentcom/tcloud-cmd) 三个官方插件实现以上需求。

### 从 CNB 同步到 GitHub

在根目录创建 `.cnb.yml`，该文件用于配置 CNB 流水线。

根据[语法手册](https://docs.cnb.cool/zh/build/grammar.html)，我希望在所有分支的推送事件触发流水线，应配置如下规则：

```yaml
"**":
  push:
    - stages:
```

`"**"` 用于匹配**任意分支**，`push` 表示**推送**事件，即匹配任意分支的推送事件；

`stages` 用于定义串行的阶段任务，也是我们接下来要配置的部分。

根据插件 [git-sync](https://cnb.cool/cnb/plugins/tencentcom/git-sync) 的说明，我们来填写同步任务所需的配置：

```yaml
"**":
  push:
    - stages:
        - name: Sync to GitHub
          image: tencentcom/git-sync
          imports:
            - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/github.yml
          settings:
            target_url: https://github.com/zhxycn/blog.git
            auth_type: https
            username: ${username}
            password: ${token}
            force: true
```

这里出现了 `imports`，我们要用它来导入**密钥仓库**里的配置文件，导入后，可以在该阶段通过环境变量来读取对应值。关于密钥仓库的说明，可以在[这里](https://docs.cnb.cool/zh/repo/secret.html)找到。

------

在这之前，我们需要先前往 GitHub 生成一个密钥：

- 在浏览器打开 https://github.com/settings/tokens 创建一个新的访问密钥：

  ![创建访问密钥](https://developer.qcloudimg.com/http-save/yehe-7153982/dac0249aef2432b83a20d4520d668a53.webp "创建访问密钥")

- 为密钥配置 `repo` 和 `workflow` 权限：

  ![配置密钥权限](https://developer.qcloudimg.com/http-save/yehe-7153982/ea18e3bdcd7cd9bea3b0bf9f99597dbb.webp "配置密钥权限")

- 得到了 Token！我们记下来备用：

  ![访问密钥](https://developer.qcloudimg.com/http-save/yehe-7153982/7b3000d99ca7d5927786ad78a6811f01.webp "访问密钥")

在密钥仓库创建一个文件，命名为 `github.yml`，内容如下：

```yaml
username: 你的 GitHub 用户名
token: 刚刚从 GitHub 得到的 Token
```

然后复制地址栏的链接到 `imports` 下，就完成了配置导入。

------

比如，我可以将现在这篇写了一半的文章推送到 CNB 的 `new` 分支，测试是否能正常同步：

```bash
git checkout new
git add .
git commit -m ":pencil: p218: CNB × Lighthouse | 解锁构建部署新姿势"
git push origin new
```

从云原生构建的运行日志中可以看到，流水线成功运行：

![云原生构建的运行日志](https://developer.qcloudimg.com/http-save/yehe-7153982/782010cb1963c4efb1eed6b0c6ae5d60.webp "云原生构建的运行日志")

再看看 GitHub 仓库，完美~

![GitHub 仓库](https://developer.qcloudimg.com/http-save/yehe-7153982/f67df2334fc539fd92129c9a2a6ef8a1.webp "GitHub 仓库")

### 自动构建并打包产物

我希望仅在 `main` 分支推送时触发自动构建，同时由于 Hexo 依赖 Node.js，我们指定 `node:24` 镜像作为构建时使用的基础环境，可以这样配置：

```yaml
main:
  push:
    - docker:
        image: node:24
        volumes:
          - /usr/local/share/.cache/yarn:cow
```

这里的 `volumes` 用来定义**数据卷**，我们将数据卷以 `cow` (`copy-on-write`) 类型挂载到 `/usr/local/share/.cache/yarn`，该目录用来存放 Yarn 的缓存，加快构建流程。

完成了基础环境的定义，接下来就该定义构建流程了。配置过程和在终端运行一样，我们只需要按步来定义需要执行的命令就可以了。

```yaml
stages:
  - name: Install dependencies
    script: yarn install
  - name: Build
    script: yarn build
```

Hexo 生成器会将构建后的内容存放到 `/public` 目录，我们将目录下的文件打个包，暂且命名为 `dist.tar.gz` 吧~

```yaml
- name: Pack files
  script: tar -C public -cf - . | gzip -9 > dist.tar.gz
```

然后使用 [attachments](https://cnb.cool/cnb/plugins/cnbcool/attachments) 插件把它上传到云原生构建的附件里：

```yaml
- name: Upload to attachments
  image: cnbcool/attachments:latest
  settings:
    attachments:
      - dist.tar.gz
```

那么完整的配置应该是这样的：

```yaml
"**":
  push:
    - stages:
        - name: Sync to GitHub
          image: tencentcom/git-sync
          imports:
            - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/github.yml
          settings:
            target_url: https://github.com/zhxycn/blog.git
            auth_type: https
            username: ${username}
            password: ${token}
            force: true
main:
  push:
    - docker:
        image: node:24
        volumes:
          - /usr/local/share/.cache/yarn:cow
      stages:
        - name: Install dependencies
          script: yarn install
        - name: Build
          script: yarn build
        - name: Pack files
          script: tar -C public -cf - . | gzip -9 > dist.tar.gz
        - name: Upload to attachments
          image: cnbcool/attachments:latest
          settings:
            attachments:
              - dist.tar.gz
```

运行一下试试效果：

![云原生构建的附件](https://developer.qcloudimg.com/http-save/yehe-7153982/d08c81a56f0c58f14fb2ae8b249d2c6e.webp "云原生构建的附件")

### 部署到服务器

对于一个静态资源来说，部署方式多种多样，可以使用 `scp` 或 `rsync`，官方也提供了[相应的插件](https://cnb.cool/cnb/plugins/tencentcom/rsync)。但对于博主这样禁用了公网 SSH 和 22 端口的服务器来说，显得有点麻烦。

不过，既然 CNB 和腾讯云打通了生态，那就不得不拿出[自动化助手 TAT](https://cloud.tencent.com/product/tat) 和 [tcloud-cmd](https://cnb.cool/cnb/plugins/tencentcom/tcloud-cmd) 插件了~

Lighthouse 服务器自带 TAT 客户端，但在开始之前，我们还是要检查一下 TAT 是否正常安装并运行。

在轻量应用服务器详情页的最底部，我们能看到 TAT 的状态：

![TAT 状态](https://developer.qcloudimg.com/http-save/yehe-7153982/48b91dc4f9cba8a0a0f837f10ade042b.webp "TAT 状态")

随后再前往 https://console.cloud.tencent.com/cam 快速新建一个子用户：

![创建子用户](https://developer.qcloudimg.com/http-save/yehe-7153982/222b61a8c4a2e0c242ce6d76058e82d2.webp "创建子用户")

注意红色方框内的内容，我们需要设置访问方式为**编程访问**，仅授予 **`QcloudTATFullAccess` 权限**，**取消勾选**重置密码，**关闭**操作保护并创建。

这样，我们就拿到了能调用 TAT 的密钥：

![访问密钥](https://developer.qcloudimg.com/http-save/yehe-7153982/519f9869c7676bae7fcf706d89d1142a.webp "访问密钥")

和上文一样，在密钥仓库创建一个 `tcloud.yml` 文件，将刚刚拿到的密钥填入：

```yaml
secret_id: 
secret_key: 
```

------

先贴出我的配置：

```yaml
- name: Deploy
  image: tencentcom/tcloud-cmd
  imports:
    - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/tcloud.yml
  settings:
    secret_id: ${secret_id}
    secret_key: ${secret_key}
    region: ap-shanghai
    instance_ids: lhins-a1b2c3d4
    script: |
      curl -L --fail \
        -H "Authorization: Bearer ${CNB_TOKEN}" \
        -H "Accept: application/vnd.cnb.api+json" \
        -o ~/dist.tar.gz \
        "${CNB_API_ENDPOINT}/${CNB_REPO_SLUG}/-/commit-assets/download/${CNB_COMMIT}/dist.tar.gz"
      mkdir -p ~/dist
      tar -C ~/dist -xzf ~/dist.tar.gz
      rsync -avz --delete ~/dist/ /www/wwwroot/blog/
      rm -rf ~/dist ~/dist.tar.gz
```

除了 `imports`，这里还有几个参数需要注意一下，要根据情况来修改：

| 参数           | 说明                                                         |
| -------------- | ------------------------------------------------------------ |
| `region`       | 服务器所在地域，可以从[这里](https://cloud.tencent.com/document/product/1596/77930)查询，一般为 `ap-<地区名称>` |
| `instance_ids` | 服务器实例 ID，可以在服务器详情页找到，支持以 `,` 分隔的多个实例 |
| `script`       | 要在服务器上执行的命令                                       |

由于我的仓库为私有仓库，下载构建阶段生成的附件需要鉴权，因此需要使用 `curl` 命令携带 `Authorization` 头进行下载，当然公开仓库不需要这一步。

通过查询 CNB 的[默认环境变量](https://docs.cnb.cool/zh/build/build-in-env.html)，`CNB_TOKEN` 为用户**临时令牌**，会在流水线结束时销毁，可用于代码和制品的拉取、推送以及 API 调用。

云原生构建附件的目录也可以通过拼接得出：

```url
${CNB_API_ENDPOINT}/${CNB_REPO_SLUG}/-/commit-assets/download/${CNB_COMMIT}/dist.tar.gz
```

于是很容易写出如下命令：

```bash
curl -L --fail \
  -H "Authorization: Bearer ${CNB_TOKEN}" \
  -H "Accept: application/vnd.cnb.api+json" \
  -o ~/dist.tar.gz \
  "${CNB_API_ENDPOINT}/${CNB_REPO_SLUG}/-/commit-assets/download/${CNB_COMMIT}/dist.tar.gz"
```

接下来是解压后放到对应目录，就不用多说了：

```bash
mkdir -p ~/dist
tar -C ~/dist -xzf ~/dist.tar.gz
rsync -avz --delete ~/dist/ /www/wwwroot/blog/
rm -rf ~/dist ~/dist.tar.gz
```

------

这样，我们就完成了一个静态站点从构建到部署的自动化流程，最后贴一下完整的流水线配置吧~

```yaml
main:
  push:
    - docker:
        image: node:24
        volumes:
          - /usr/local/share/.cache/yarn:cow
      stages:
        - name: Install dependencies
          script: yarn install
        - name: Build
          script: yarn build
        - name: Pack files
          script: tar -C public -cf - . | gzip -9 > dist.tar.gz
        - name: Upload to attachments
          image: cnbcool/attachments:latest
          settings:
            attachments:
              - dist.tar.gz
        - name: Deploy
          image: tencentcom/tcloud-cmd
          imports:
            - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/tcloud.yml
          settings:
            secret_id: ${secret_id}
            secret_key: ${secret_key}
            region: ap-shanghai
            instance_ids: lhins-a1b2c3d4
            script: |
              curl -L --fail \
                -H "Authorization: Bearer ${CNB_TOKEN}" \
                -H "Accept: application/vnd.cnb.api+json" \
                -o ~/dist.tar.gz \
                "${CNB_API_ENDPOINT}/${CNB_REPO_SLUG}/-/commit-assets/download/${CNB_COMMIT}/dist.tar.gz"
              mkdir -p ~/dist
              tar -C ~/dist -xzf ~/dist.tar.gz
              rsync -avz --delete ~/dist/ /www/wwwroot/blog/
              rm -rf ~/dist ~/dist.tar.gz
```

在调用 TAT 运行后，我们还可以在命令执行记录中查看运行结果，满足了调试和审计需求：

![运行结果](https://developer.qcloudimg.com/http-save/yehe-7153982/48ef2ebdd9867d4edc602a71f457998f.webp "运行结果")

## 以 Go 为例的 Docker 容器化部署

这是一个由我和团队维护的 Go 语言项目：

![项目仓库](https://developer.qcloudimg.com/http-save/yehe-7153982/b85f7bd397533cee5aac9a4ff2f3f2e6.webp "项目仓库")

对于这个项目，我的需求如下：

- 在 `main` 分支提交后，自动构建 `dev` 标记的 Docker 镜像，然后部署到测试环境；
- 在测试完成，创建 Tag 后，自动构建 `latest` 标记的 Docker 镜像，然后部署到生产环境。

下面我将通过 CNB 的 Docker 制品库和 [tcloud-cmd](https://cnb.cool/cnb/plugins/tencentcom/tcloud-cmd) 插件实现以上需求。

### 自动构建

对于一个在 Docker 运行的项目，自然少不了 Dockerfile，我们应该将程序的构建过程在 Dockerfile 中完成定义：

```dockerfile
FROM golang:alpine AS builder

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o server ./cmd

FROM alpine:latest

WORKDIR /app

COPY --from=builder /app/server .

ENV TZ="Asia/Shanghai"
ENV DATABASE=""

EXPOSE 8080

CMD ["./server"]
```

有了 Dockerfile，构建镜像就很简单了：

```yaml
main:
  push:
    - services:
        - docker
      stages:
        - name: docker build
          script: docker build -t ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:dev .
        - name: docker push
          script: docker push ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:dev
```

这两步会生成一个**与仓库同名**的镜像，并推送到仓库对应的制品库中。至于生产环境，我们只需要稍微调整一下触发条件和 Docker 镜像的标签：

```yaml
$:
  tag_push:
    - services:
        - docker
      stages:
        - name: Docker build
          script: docker build -t ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:latest .
        - name: Docker push
          script: docker push ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:latest
```

在运行成功后，就可以在制品库中看到构建的镜像了：

![制品库](https://developer.qcloudimg.com/http-save/yehe-7153982/e755d5321d8fe039270431338ba04e76.webp "制品库")

### 部署到服务器

和上文一样，我们依然可以使用 [tcloud-cmd](https://cnb.cool/cnb/plugins/tencentcom/tcloud-cmd) 插件调用 TAT 在服务器中完成镜像的拉取和部署，配置如下：

```yaml
- name: Deploy
  image: tencentcom/tcloud-cmd
  imports:
    - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/tcloud.yml
    - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/project.yml
  settings:
    secret_id: ${secret_id}
    secret_key: ${secret_key}
    region: ap-shanghai
    instance_ids: lhins-a1b2c3d4
    script: |
      sudo docker stop ${CNB_REPO_NAME_LOWERCASE} || true
      sudo docker rm ${CNB_REPO_NAME_LOWERCASE} || true
      sudo docker run -d --name ${CNB_REPO_NAME_LOWERCASE} \
        -p 8080:8080 \
        -e TZ="Asia/Shanghai" \
        -e DATABASE="${DATABASE}" \
        ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:dev
    query_instance: true
```

镜像拉取可以通过腾讯云内网完成，在解决了 Docker Hub 在国内无法拉取的痛点上，又提高了部署效率。 

对于不同部署环境来说，只需要调整对应的定义。若仓库为私有仓库，需要多一条登录到 CNB Docker 制品库的命令：

```bash
sudo docker login docker.cnb.cool -u cnb -p ${CNB_TOKEN}
```

------

除文中提到的流水线外，高阶用户还可以参考文档中的[自定义部署流程](https://docs.cnb.cool/zh/build/deploy.html)来实现审批流程。同样的，也可以利用 YAML 语法特性来[简化配置文件](https://docs.cnb.cool/zh/build/simplify-configuration.html)。

以下是经过简化的完整配置~

```yaml
.job: &job
  services:
    - docker
  stages:
    - name: docker build
      script: docker build -t ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:${image_tag} .
    - name: docker push
      script: docker push ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:${image_tag}
    - name: Deploy
      image: tencentcom/tcloud-cmd
      imports:
        - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/tcloud.yml
        - https://cnb.cool/CatNya/zhxycn/secrets/-/blob/main/project.yml
      settings:
        secret_id: ${secret_id}
        secret_key: ${secret_key}
        region: ap-shanghai
        instance_ids: ${instance_ids}
        script: |
          sudo docker stop ${CNB_REPO_NAME_LOWERCASE} || true
          sudo docker rm ${CNB_REPO_NAME_LOWERCASE} || true
          sudo docker run -d --name ${CNB_REPO_NAME_LOWERCASE} \
            -p 8080:8080 \
            -e TZ="Asia/Shanghai" \
            -e DATABASE="${DATABASE}" \
            ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:${image_tag}
        query_instance: true
main:
  push:
    - env:
      instance_ids: lhins-a1b2c3d4
      image_tag: dev
      <<: *job
"*":
  tag_push:
    - env:
      instance_ids: lhins-a1b2c3d4
      image_tag: latest
      <<: *job
```

## 结语

CNB 与腾讯云生态结合带来了高效的 CI/CD 流程。无论是静态站点的自动更新，还是容器化应用的持续交付，CNB 强大的插件生态和声明式的流水线配置，无疑能简化我们的构建与部署工作。

云原生构建（Cloud Native Build，CNB）提供代码托管、云原生构建、云原生开发、AI 代码助手和制品库等功能。基于 Docker 生态，对环境、缓存、插件进行抽象，通过声明式的语法，帮助开发者以更酷的方式构建软件。

CNB × Lighthouse | 解锁构建部署新姿势

以 Hexo 和 Go 为例，从前端的静态资源部署和后端的 Docker 容器化部署两方面，讲讲 CNB 和 Lighthouse 在 CICD 上的用法。

编程语言

本文详细介绍了如何利用云原生构建(CNB)和轻量应用服务器(Lighthouse)实现Hexo静态站点和Go项目的自动化构建部署。通过CNB的git-sync、attachments、tcloud-cmd等插件，结合Lighthouse的TAT功能，实现从代码同步、构建打包到服务器部署的全流程自动化，大幅提升开发效率。

轻量应用服务器

云原生开发

自动化助手

云原生构建

云服务器

云原生

服务器

AI Agent

GitHub

Docker

容器

Agent

AI驱动 智领未来

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

lighthouse

coding

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

CNB × Lighthouse | 解锁构建部署新姿势-腾讯云开发者社区-腾讯云

CNB × Lighthouse | 解锁构建部署新姿势

CNB × Lighthouse | 解锁构建部署新姿势

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐