云原生构建（Cloud Native Buildpacks，CNB）是一款基于 Docker 生态，对环境、缓存、插件进行抽象，通过声明式的语法，帮助开发者以更酷的方式构建软件的工具，本文将介绍如何使用 CNB 构建 Hexo 静态博客，并部署到腾讯云对象存储（COS）。

前提条件

  1. 注册云原生构建（CNB）账号，并完成实名认证，点此注册
  2. 已完成CNB组织的创建，注册完成后，在右上角头像处，点击我的组织，然后点击创建组织，按提示完成组织创建
  3. 已开通腾讯云对象存储（COS）服务

操作步骤

新建代码仓库

  1. 登录云原生构建（CNB）控制台，在右上角头像处，点击我的仓库，然后点击创建仓库，按提示完成仓库创建
    新建代码仓库

    仓库归属：选择你的组织
    仓库名称：填写你的仓库名称
    仓库描述：填写你的仓库描述
    公开性：选择是否公开，建议私有

  2. 点击创建，完成仓库创建
  3. 创建完成后，页面将提示仓库暂未完成初始化，您可以选择以下任一方式完成仓库的初始化，这时点击云原生开发
    仓库初始化
  4. 等待环境初始化完成，点击使用 WEB IDE 打开，进入代码编辑界面
    环境构建完成
  5. 在编辑器的终端中，输入以下命令，克隆 Hexo 仓库到当前目录
    1
    cnb-init-from https://cnb.cool/examples/ecosystem/hexo-cos-demo.git
  6. 等待克隆完成
    克隆仓库
  7. 完成后关闭当前窗口，返回仓库页面，刷新，并点击云原生构建
    返回仓库页面
  8. 找到通过vscode触发的任务并点击
    触发任务
  9. 进入后点击停止构建
    停止构建

新建存储桶

  1. 登录腾讯云对象存储（COS）控制台，在左侧导航栏中点击存储桶列表,点击创建存储桶
    新建存储桶
  2. 按提示填写信息完成存储桶创建
    填写存储桶信息

    地域：选择存储桶所在地域，就近选择即可，默认广州
    名称：填写存储桶名称
    访问权限：选择公有读私有写，建议选择私有读写，此处为了演示方便选择公有读私有写
    其他默认即可

    此处仅为了演示方便，选择了公有读私有写，实际使用时不建议大家直接使用 COS 存储桶直接对外提供访问服务，而是通过 CDN 等服务进行加速访问。

  3. 创建完成后保存存储桶名称和存储桶地域，后续需要使用
    存储桶信息

新建腾讯云API密钥

  1. 登录腾讯云-访问管理，点击新建密钥
    新建密钥
  2. 保存SecretId和SecretKey，后续需要使用
    密钥信息

新建密钥仓库

密钥仓库用于存储敏感信息，如密钥、密码等供构建时使用

  1. 登录云原生构建（CNB）控制台，在右上角头像处，点击我的仓库，然后点击创建仓库，按提示完成仓库创建
    新建密钥仓库

    仓库归属：选择你的组织
    仓库名称：填写你的仓库名称
    仓库描述：填写你的仓库描述
    公开性：选择密钥仓库

  2. 点击创建，完成仓库创建
  3. 点击新建，选择新建文件，填写文件名hexo_cos_secret.yml，内容如下
    1
    2
    3
    4
    5
    6
    7
    8
    # 腾讯云 SecretId
    COS_SECRET_ID: AKIDCOxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    # 腾讯云 SecretKey
    COS_SECRET_KEY: tt3S4fExxxxxxxxxxxxxxxxxxxxxxxx
    # 腾讯云 COS 存储桶名称
    COS_BUCKET: hexo-demo-xxxxxxx
    # 腾讯云 COS 存储桶地域
    COS_REGION: ap-guangzhou
    新建密钥文件
  4. 点击提交，完成密钥文件创建
  5. 创建完成后在仓库页面，点击刚刚创建的文件，在浏览器地址栏中复制链接地址，后续需要使用
    复制链接地址

编辑站点基本信息 && 新建页面

  1. 在仓库首页点击云原生开发
    云原生开发
  2. 等待环境初始化完成，点击使用 WEB IDE 打开，进入代码编辑界面
    环境构建完成
  3. 进入编辑器后，打开_config.yml文件，修改站点基本信息，完成修改后保存即可
    修改站点基本信息
  4. 您可通过在终端运行hexo n 文章标题命令新建文章，也可直接在source/_posts目录下新建md文件，编辑文章内容，具体操作可参考Hexo官方文档，这里不再赘述

配置云原生构建

  1. 在编辑器中打开.cnb.yml文件，修改配置
    修改构建配置
    • 去除指定行的注释符#
    • 将import行中的链接替换成密钥仓库文件的链接地址
  2. 完成修改后保存即可
    保存配置

提交代码并构建

  1. 在编辑器左侧菜单栏中点击源代码管理
    源代码管理
  2. 在弹出的窗口中，填写提交信息，点击提交
    提交代码
  3. 提交完成后点击Sync Changes，同步代码
    同步代码
  4. 等待同步完成后，返回仓库页面，点击云原生构建
    返回仓库页面
  5. 点击通过 push 触发的任务，进入构建页面
    触发构建
  6. 可在构建页面查看构建日志，等待构建完成
  7. 构建完成后，我们可以前往腾讯云 COS 控制台查看存储桶中是否已经上传了静态网站文件
    查看存储桶
    查看存储桶

开启存储桶静态网站

  1. 在腾讯云 COS 控制台中，点击存储桶列表，找到刚刚创建的存储桶，点击配置管理
  2. 在左侧导航栏中点击静态网站，点击编辑
    启用静态网站
  3. 勾选启用静态网站，填写索引文档，点击保存
    配置静态网站

绑定自定义域名

2024年1月1日后创建的桶不支持使用默认域名在浏览器预览文件，所以需要绑定自定义域名，境内存储桶需要绑定已备案的域名

  1. 在腾讯云 COS 控制台中，点击存储桶列表，找到刚刚创建的存储桶，点击配置管理
  2. 在左侧导航栏中点击域名与传输管理-自定义源站域名，点击添加域名
    添加域名
  3. 按提示填写信息完成域名绑定
    填写域名信息

    域名：填写您的域名
    源站类型：静态网站源站

  4. 添加完成后请前往域名服务商处添加解析，将域名解析到存储桶静态网站域名
    添加解析
  5. 解析完成后，即可通过域名访问静态网站
    访问静态网站

后续操作

正如上面所提到的，使用 COS 直接对外提供访问是一个很危险的行为，建议大家使用 CDN 等服务进行加速访问。
PS：有人可能好奇密钥为什么不打码，因为写完文章就删了，但是如果你是在生产环境中使用，请务必保护好你的密钥。