雲原生構建jiàn（Cloud Native Buildpacks，CNB）是一款基於yú Docker 生態tài，對環境jìng、緩存cún、插件進行抽象xiàng，通過聲明式的語法fǎ，幫助開發者以更酷的方式構建軟件的工具jù，本文將介紹如何使用yòng CNB 構建jiàn Hexo 靜態博客kè，並部署到騰訊雲對象存儲chǔ（COS）。

前提條件jiàn

  1. 註冊雲原生構建jiàn（CNB）賬號hào，並完成實名認證zhèng，點此註冊cè
  2. 已完成chéngCNB組織的創建jiàn，註冊完成後hòu，在右上角jiǎo頭像處chù，點擊jī我的組織，然後點擊jī創建組織，按提示完成組織創建jiàn
  3. 已開通tōng騰訊雲對象存儲chǔ（COS）服務wù

操作步驟zhòu

新建代碼倉庫kù

  1. 登錄lù雲原生構建jiàn（CNB）控制檯tái，在右上角jiǎo頭像處chù，點擊jī我的倉庫，然後點擊jī創建倉庫，按提示完成倉庫創建jiàn
    新建代碼倉庫

    倉庫歸屬shǔ：選擇你的組織zhī
    倉庫名稱chēng：填寫你的倉庫名稱chēng
    倉庫描述shù：填寫你的倉庫描述shù
    公開性xìng：選擇是否公開kāi，建議私有yǒu

  2. 點擊jī創建，完成倉庫創建jiàn
  3. 創建完成後hòu，頁面將提示shì倉庫暫未完成初始化，您可以選擇以下任一方式完成倉庫的初始化，這時點擊jī雲原生開發
    倉庫初始化
  4. 等待環境初始化完成chéng，點擊jī使用 WEB IDE 打開，進入代碼編輯界面miàn
    環境構建完成
  5. 在編輯器的de終端中zhōng，輸入以下命令lìng，克隆lóng Hexo 倉庫到當前目錄lù
    1
    cnb-init-from https://cnb.cool/examples/ecosystem/hexo-cos-demo.git
  6. 等待克隆完成chéng
    克隆倉庫
  7. 完成後關閉當前窗口kǒu，返回倉庫頁面miàn，刷新xīn，並點擊jī雲原生構建
    返回倉庫頁面
  8. 找到通過guòvscode觸發的任務並點擊jī
    觸發任務
  9. 進入後點擊jī停止構建
    停止構建

新建存儲桶tǒng

  1. 登錄lù騰訊雲對象存儲chǔ（COS）控制檯tái，在左側導航欄中點擊jī存儲桶列表,點擊jī創建存儲桶
    新建存儲桶
  2. 按提示填寫信息完成存儲桶創建jiàn
    填寫存儲桶信息

    地域yù：選擇存儲桶所在地域yù，就近選擇即可kě，默認廣州zhōu
    名稱chēng：填寫存儲桶名稱chēng
    訪問權限xiàn：選擇zé公有讀私有寫，建議選擇zé私有讀寫，此處爲了演示方便選擇zé公有讀私有寫
    其他默認即可kě

    此處僅爲了演示方便biàn，選擇了公有讀私有寫xiě，實際使用yòng時不建議大家直接使用 COS 存儲桶直接對外提供訪問服務wù，而是通過guò CDN 等服務進行加速訪問wèn。

  3. 創建完成後保存cún存儲桶名稱和hé存儲桶地域，後續需要使用yòng
    存儲桶信息

新建騰訊雲yúnAPI密鑰yào

  1. 登錄lù騰訊雲yún-訪問管理lǐ，點擊jī新建密鑰
    新建密鑰
  2. 保存cúnSecretId和héSecretKey，後續需要使用yòng
    密鑰信息

新建密鑰倉庫kù

密鑰倉庫用於存儲敏感信息xī，如密鑰yào、密碼等供構建時使用yòng

  1. 登錄lù雲原生構建jiàn（CNB）控制檯tái，在右上角jiǎo頭像處chù，點擊jī我的倉庫，然後點擊jī創建倉庫，按提示完成倉庫創建jiàn
    新建密鑰倉庫

    倉庫歸屬shǔ：選擇你的組織zhī
    倉庫名稱chēng：填寫你的倉庫名稱chēng
    倉庫描述shù：填寫你的倉庫描述shù
    公開性xìng：選擇密鑰倉庫kù

  2. 點擊jī創建，完成倉庫創建jiàn
  3. 點擊jī新建，選擇zé新建文件，填寫文件名mínghexo_cos_secret.yml，內容如下xià
    1
    2
    3
    4
    5
    6
    7
    8
    # 騰訊雲yún SecretId
    COS_SECRET_ID: AKIDCOxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    # 騰訊雲yún SecretKey
    COS_SECRET_KEY: tt3S4fExxxxxxxxxxxxxxxxxxxxxxxx
    # 騰訊雲yún COS 存儲桶名稱chēng
    COS_BUCKET: hexo-demo-xxxxxxx
    # 騰訊雲yún COS 存儲桶地域yù
    COS_REGION: ap-guangzhou
    新建密鑰文件
  4. 點擊jī提交，完成密鑰文件創建jiàn
  5. 創建完成後在zài倉庫頁面miàn，點擊剛剛創建的文件jiàn，在瀏覽器地址欄中複製zhì鏈接地址，後續需要使用yòng
    複製鏈接地址

編輯站點基本信息xī && 新建頁面miàn

  1. 在倉庫首頁點擊jī雲原生開發
    雲原生開發
  2. 等待環境初始化完成chéng，點擊jī使用 WEB IDE 打開，進入代碼編輯界面miàn
    環境構建完成
  3. 進入編輯器後hòu，打開kāi_config.yml文件jiàn，修改站點基本信息xī，完成修改後保存即可kě
    修改站點基本信息
  4. 您可通過在終端運行xínghexo n 文章標題命令新建文章zhāng，也可直接在zàisource/_posts目錄下新建jiànmd文件jiàn，編輯文章內容róng，具體操作可參考kǎoHexo官方文檔dàng，這裏不再贅述shù

配置雲原生構建jiàn

  1. 在編輯器中打開kāi.cnb.yml文件jiàn，修改配置zhì
    修改構建配置
    • 去除指定行的註釋符fú#
    • 將jiāngimport行中的鏈接替換成密鑰倉庫文件的鏈接地址zhǐ
  2. 完成修改後保存即可kě
    保存配置

提交代碼並構建jiàn

  1. 在編輯器左側菜單欄中點擊jī源代碼管理
    源代碼管理
  2. 在彈出的窗口中zhōng，填寫xiě提交信息，點擊jī提交
    提交代碼
  3. 提交完成後點擊jīSync Changes，同步代碼mǎ
    同步代碼
  4. 等待同步完成後hòu，返回倉庫頁面miàn，點擊jī雲原生構建
    返回倉庫頁面
  5. 點擊jī通過 push 觸發的任務，進入構建頁面miàn
    觸發構建
  6. 可在構建頁面查看構建日誌zhì，等待構建完成chéng
  7. 構建完成後hòu，我們可以前往wǎng騰訊雲yún COS 控制檯tái查看存儲桶中是否已經上傳了靜態網站文件jiàn
    查看存儲桶
    查看存儲桶

開啓存儲桶靜態網站zhàn

  1. 在zài騰訊雲yún COS 控制檯tái中zhōng，點擊jī存儲桶列表，找到剛剛創建的存儲桶tǒng，點擊jī配置管理
  2. 在左側導航欄中點擊jī靜態網站，點擊jī編輯
    啓用靜態網站
  3. 勾選xuǎn啓用靜態網站，填寫xiě索引文檔，點擊jī保存
    配置靜態網站

綁定自定義域名míng

2024年nián1月yuè1日後創建的桶不支持使用默認域名在瀏覽器預覽文件jiàn，所以需要綁定自定義域名míng，境內存儲桶需要綁定已備案的域名míng

  1. 在zài騰訊雲yún COS 控制檯tái中zhōng，點擊jī存儲桶列表，找到剛剛創建的存儲桶tǒng，點擊jī配置管理
  2. 在左側導航欄中點擊jī域名與傳輸管理-自定義源站域名，點擊jī添加域名
    添加域名
  3. 按提示填寫信息完成域名綁定dìng
    填寫域名信息

    域名míng：填寫您的域名míng
    源站類型xíng：靜態網站zhàn源站

  4. 添加完成後請前往域名服務商處添加解析xī，將域名míng解析到存儲桶靜態網站域名
    添加解析
  5. 解析完成後hòu，即可通過域名訪問靜態網站zhàn
    訪問靜態網站

後續操作zuò

正如上面所提到的de，使用yòng COS 直接對外提供訪問是一個很危險的行爲wèi，建議大家使用yòng CDN 等服務進行加速訪問wèn。
PS：有人可能好奇密鑰爲什麼不打碼mǎ，因爲寫完文章就刪了le，但是如果你是在生產環境中使用yòng，請務必保護好你的密鑰yào。