前言

通過(guò)自動(dòng)構(gòu)建的功能，可以實(shí)現(xiàn)代碼或鏡像提交后組件自動(dòng)觸發(fā)構(gòu)建和部署，Rainbond 提供了基于代碼倉(cāng)庫(kù) Webhooks、鏡像倉(cāng)庫(kù) Webhooks 和自定義 API 三種方式觸發(fā)組件自動(dòng)部署。自動(dòng)構(gòu)建的功能可以輔助開發(fā)者便捷的實(shí)現(xiàn)敏捷開發(fā)。

前提條件

• 組件是由源碼創(chuàng)建(官方 demo 除外)，可支持代碼倉(cāng)庫(kù) Webhooks，目前支持的代碼倉(cāng)庫(kù)為GitHub、GitLab、Gitee 與 Gogs。
• 組件是由鏡像創(chuàng)建，可支持鏡像倉(cāng)庫(kù) Webhooks，目前支持 Docker 官方倉(cāng)庫(kù)，阿里云鏡像倉(cāng)庫(kù)。
• 基于源代碼創(chuàng)建組件 A 并使其處于正常運(yùn)行狀態(tài)。

基于源代碼操作流程

1.開啟組件 Git-Webhook

在 組件管理面板/構(gòu)建源管理 中請(qǐng)打開 Git-Webhook 自動(dòng)構(gòu)建功能，復(fù)制生成的 hook 地址。

Rainbond 自動(dòng)構(gòu)建后默認(rèn)會(huì)進(jìn)行部署動(dòng)作，所以一般情況下開發(fā)者不希望每一次代碼提交都進(jìn)行部署動(dòng)作，因此 Rainbond hook 自動(dòng)觸發(fā)設(shè)置了前提，在 Commit 信息中包含@關(guān)鍵字時(shí)才觸發(fā)動(dòng)作。這個(gè)關(guān)鍵字可以由開發(fā)者進(jìn)行設(shè)置。

請(qǐng)注意，這里生成的域名是根據(jù)當(dāng)前訪問(wèn)平臺(tái)的域名生成，若不正確可直接使用平臺(tái)正確的訪問(wèn)域名。

2.配置代碼倉(cāng)庫(kù)

如果您的項(xiàng)目存放在Github中，請(qǐng)參考如下截圖：

如果您的項(xiàng)目存放在Gitlab中，請(qǐng)參考如下截圖:

其他代碼倉(cāng)庫(kù)配置方式類似，需要說(shuō)明的是目前 Rainbond hook 觸發(fā)暫不支持安全請(qǐng)求校驗(yàn)。

基于鏡像倉(cāng)庫(kù)操作流程

鏡像倉(cāng)庫(kù)自動(dòng)構(gòu)建可以實(shí)現(xiàn)推送鏡像后應(yīng)用的自動(dòng)構(gòu)建，方便的對(duì)接第三方自動(dòng)化流程。當(dāng)鏡像更新事件到達(dá)時(shí)判斷以下條件，都滿足時(shí)觸發(fā)自動(dòng)構(gòu)建。

• 應(yīng)用是由鏡像創(chuàng)建，鏡像倉(cāng)庫(kù)為Docker Hub, 5.1.2 版本及以后支持阿里云鏡像倉(cāng)庫(kù)。
• 默認(rèn)更新的鏡像名稱和 tag 是否與當(dāng)前組件構(gòu)建源鏡像名稱一致（判斷時(shí)不包含鏡像倉(cāng)庫(kù)域名）, 5.1.3 版本及以后支持配置 Tag 觸發(fā)正則策略，動(dòng)態(tài)匹配和改變組件的鏡像 Tag。
• 組件已經(jīng) 開啟 了鏡像倉(cāng)庫(kù) Webhook 功能。
• 應(yīng)用狀態(tài)不是已關(guān)閉狀態(tài)。

1.開啟鏡像倉(cāng)庫(kù) Webhook 自動(dòng)構(gòu)建

需要在應(yīng)用中啟用自動(dòng)構(gòu)建功能，并且需要將應(yīng)用的 webhooks url 配置到目標(biāo)鏡像倉(cāng)庫(kù)的 webhooks 中。

2.Tag 觸發(fā)自動(dòng)修改策略

默認(rèn)情況下 Webhook 更新事件的鏡像名稱和 Tag 必須與組件當(dāng)前構(gòu)建源的鏡像名稱和 Tag 配置一致才能觸發(fā)構(gòu)建和部署。配置了 Tag 觸發(fā)策略以后，根據(jù)配置的正則表達(dá)式，如果接收到的 push 事件的鏡像 tag 能夠正確匹配正則表達(dá)式，則認(rèn)為此次更新事件有效，根據(jù)更新的 Tag 信息來(lái)升級(jí)當(dāng)前組件的構(gòu)建源信息并進(jìn)行自動(dòng)構(gòu)建。

比如設(shè)置 Tag 策略為： v5.* 當(dāng) Tag 為 v5.1 v5.2 v5.9等都將被允許。

3.配置鏡像倉(cāng)庫(kù)

配置 Docker Hub

配置方式請(qǐng)參考如下截圖:

API 觸發(fā)自動(dòng)構(gòu)建

通過(guò)開啟 API 自動(dòng)構(gòu)建返回的 url，POST 方法調(diào)用 API，攜帶秘鑰即可觸發(fā) API 自動(dòng)構(gòu)建，秘鑰可以自定義設(shè)置

API 使用方式如下：

curl -d '{"secret_key":"<秘鑰>"}' -H "Content-type: application/json" -X POST <API地址>

基于 API 觸發(fā)自動(dòng)構(gòu)建是最靈活的方式之一，主要用于與第三方 CI 系統(tǒng)集成。

以上就是Rainbond配置組件自動(dòng)構(gòu)建部署官方文檔講解的詳細(xì)內(nèi)容，更多關(guān)于Rainbond配置組件自動(dòng)構(gòu)建部署官方文檔的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論