流水線配置

流水線配置主要包括流水線觸發(fā)方式、流水線執(zhí)行環(huán)境、資源描述YAML、釘釘機(jī)器人通知四個(gè)配置項(xiàng)，其中只有流水線觸發(fā)方式、流水線執(zhí)行環(huán)境可以在創(chuàng)建應(yīng)用、創(chuàng)建環(huán)境階段進(jìn)行配置，這四項(xiàng)都可以在創(chuàng)建成功后單擊編輯按鈕配置。

流水線觸發(fā)方式

應(yīng)用中心支持用戶自定義觸發(fā)流水線的Git事件。應(yīng)用中心通過(guò)Webhook來(lái)接收Git事件，當(dāng)接收到滿足觸發(fā)規(guī)則的事件時(shí)，將按照用戶配置的流水線YAML創(chuàng)建并執(zhí)行流水線。當(dāng)前支持的觸發(fā)方式如下：

• 分支觸發(fā)：需要環(huán)境關(guān)聯(lián)指定分支，匹配指定分支所有的Push事件。

• Tag觸發(fā)：匹配指定Tag表達(dá)式的所有Tag創(chuàng)建事件。

• 分支合并觸發(fā)：匹配指定來(lái)源分支到環(huán)境所關(guān)聯(lián)的目標(biāo)分支的Merge/Pull Request合并事件。

流水線執(zhí)行環(huán)境

流水線執(zhí)行環(huán)境分為默認(rèn)執(zhí)行環(huán)境和專有執(zhí)行環(huán)境兩種模式。

默認(rèn)執(zhí)行環(huán)境

默認(rèn)執(zhí)行環(huán)境下，流水線的資源由平臺(tái)完全托管，由阿里云函數(shù)計(jì)算為您承擔(dān)流水線執(zhí)行過(guò)程中的費(fèi)用成本，您無(wú)需付出任何費(fèi)用。流水線的每個(gè)任務(wù)都會(huì)運(yùn)行在獨(dú)立安全沙箱環(huán)境中，平臺(tái)會(huì)保證您的流水線執(zhí)行環(huán)境的安全隔離。默認(rèn)執(zhí)行環(huán)境的使用限制如下：

• 實(shí)例資源規(guī)格：4vCPU、8GB內(nèi)存。

• 臨時(shí)磁盤空間：10 GB。

• 任務(wù)執(zhí)行超時(shí)：15分鐘。

• 地域限制：模板直接部署、GitHub代碼源使用海外新加坡地域，Gitee、公網(wǎng)GitLab、Codeup使用中國(guó)杭州地域。

• 網(wǎng)絡(luò)限制：不支持固定IP地址以及網(wǎng)段，不支持IP白名單方式訪問(wèn)指定網(wǎng)站，不支持訪問(wèn)您的VPC內(nèi)的資源。

專有執(zhí)行環(huán)境

專有執(zhí)行環(huán)境會(huì)將流水線任務(wù)在用戶的賬號(hào)下執(zhí)行，提供更多自定義的能力。應(yīng)用中心會(huì)根據(jù)用戶的授權(quán)完全代管專有執(zhí)行環(huán)境的任務(wù)，實(shí)時(shí)在用戶賬戶下調(diào)度函數(shù)計(jì)算實(shí)例運(yùn)行流水線。和默認(rèn)執(zhí)行環(huán)境類似，專有執(zhí)行環(huán)境提供完全Serverless化的能力，用戶無(wú)需運(yùn)維基礎(chǔ)設(shè)施。

通過(guò)專有執(zhí)行環(huán)境，您可以使用如下自定義能力：

• 地域及網(wǎng)絡(luò)：您可以指定執(zhí)行環(huán)境的地域以及VPC，實(shí)現(xiàn)訪問(wèn)內(nèi)網(wǎng)代碼倉(cāng)庫(kù)、制品倉(cāng)庫(kù)、鏡像倉(cāng)庫(kù)、Maven私服等場(chǎng)景。支持的地域：開服地域

• 實(shí)例資源規(guī)格：您可以指定執(zhí)行環(huán)境的CPU、內(nèi)存規(guī)格。例如指定更大規(guī)格的實(shí)例來(lái)加快構(gòu)建速度。

  說(shuō)明

  vCPU大小（單位為核）與內(nèi)存大小（單位為GB）的比例必須設(shè)置在1∶1到1∶4之間。

• 持久化存儲(chǔ)：您可以指定NAS掛載以及OSS掛載配置。例如通過(guò)NAS掛載來(lái)進(jìn)行文件緩存，實(shí)現(xiàn)加速構(gòu)建的效果。

• 日志：您可以指定SLS的日志項(xiàng)目和日志倉(cāng)庫(kù)，實(shí)現(xiàn)流水線執(zhí)行日志的持久化。

• 超時(shí)時(shí)間：您可以自定義流水線任務(wù)的執(zhí)行超時(shí)。默認(rèn)為600秒，最長(zhǎng)為86400秒。

資源描述YAML

Serverless應(yīng)用中心和ServerlessDevs開發(fā)者工具進(jìn)行了深度集成，你可以通過(guò)ServerlessDevs的資源描述文件來(lái)聲明業(yè)務(wù)的資源配置。關(guān)于資源描述YAML的規(guī)范，請(qǐng)參見ServerlessDevs YAML規(guī)范。默認(rèn)的資源描述文件名為s.yaml，您也可以指定其他文件名。指定資源描述文件后，在流水線中有兩種使用方式：

• 當(dāng)使用部署插件@serverless-cd/s-deploy時(shí)，插件執(zhí)行時(shí)會(huì)自動(dòng)使用指定的資源描述文件進(jìn)行部署，執(zhí)行的原理是在Serverless Devs的操作指定中增加-t/--template命令。例如下面示例，指定的資源描述YAML文件為demo.yaml，插件執(zhí)行的命令就是s deploy -t demo.yaml。

- name: deploy
  context:
    data:
      deployFile: demo.yaml
      steps:
      - plugin: '@serverless-cd/s-setup'
      - plugin: '@serverless-cd/checkout'
      - plugin: '@serverless-cd/s-deploy'
  taskTemplate: serverless-runner-task

• 當(dāng)使用腳本方式執(zhí)行時(shí)，可以通過(guò)${{ ctx.data.deployFile }}來(lái)引用具體的資源描述文件名。例如下面的示例，效果是當(dāng)指定了資源描述文件時(shí)就使用指定文件執(zhí)行s plan命令，否則使用默認(rèn)的s.yaml執(zhí)行s plan命令。

- name: pre-check
  context:
    data:
      steps:
      - run: s plan -t ${{ ctx.data.deployFile || s.yaml }}
      - run: echo "s plan finished."
  taskTemplate: serverless-runner-task

釘釘機(jī)器人通知

開啟該配置后，需要配置釘釘機(jī)器人的Webhook地址、加簽密鑰、通知規(guī)則以及自定義消息等。您可以在此集中管理需要通知的任務(wù)，也可以通過(guò)流水線YAML對(duì)各個(gè)任務(wù)分別開啟通知。在此處完成通知的整體配置后，您也可以進(jìn)一步在流水線詳情中進(jìn)行各個(gè)任務(wù)的通知細(xì)化配置。

流水線詳情

在流水線詳情區(qū)域，您可以配置流水線流程，對(duì)流水線中的任務(wù)、任務(wù)間的關(guān)系進(jìn)行詳細(xì)配置。平臺(tái)會(huì)自動(dòng)生成默認(rèn)流水線流程，您可以基于該流程進(jìn)行二次編輯。

流水線通過(guò)YAML進(jìn)行管理，當(dāng)前提供了平臺(tái)托管和倉(cāng)庫(kù)讀取兩種配置方式：

平臺(tái)托管

流水線YAML默認(rèn)由平臺(tái)托管，即配置在平臺(tái)中心化管理，更新后下次部署時(shí)生效。

倉(cāng)庫(kù)讀取

流水線的YAML描述文件存儲(chǔ)在遠(yuǎn)端Git倉(cāng)庫(kù)，在控制臺(tái)中編輯保存后平臺(tái)會(huì)實(shí)時(shí)向您的Git倉(cāng)庫(kù)提交Commit，該提交不觸發(fā)流水線的執(zhí)行。當(dāng)您的代碼倉(cāng)庫(kù)事件觸發(fā)流水線執(zhí)行時(shí)，平臺(tái)使用您指定的Git倉(cāng)庫(kù)中的流水線YAML創(chuàng)建流水線并執(zhí)行。

您可以在流水線詳情區(qū)域上方指定倉(cāng)庫(kù)讀取，輸入YAML的文件名。如下圖所示。

流水線詳情區(qū)域的主體由左側(cè)的輔助工具區(qū)與右側(cè)的YAML編輯區(qū)構(gòu)成：

• YAML編輯區(qū)：您可以直接對(duì)流水線YAML進(jìn)行編輯，來(lái)實(shí)現(xiàn)對(duì)流水線流程的修改，參考使用YAML文件描述流水線。

• 輔助工具區(qū)：提供了針對(duì)YAML編輯的輔助工具，包含：

  • 流程預(yù)覽：提供了對(duì)流水線流程的可視化預(yù)覽與簡(jiǎn)單編輯能力。流程預(yù)覽

  • 任務(wù)模板：提供了一系列常用的任務(wù)YAML模板。任務(wù)模板

區(qū)域右上角有保存、全屏模式、重置三個(gè)按鈕：

• 保存按鈕會(huì)保存頁(yè)面中對(duì)YAML的更改，并同步到流水線YAML中。

• 全屏模式按鈕可以將主題編輯區(qū)域放大到全屏操作。

• 重置按鈕則將取消從上次保存YAML之后的所有更改，退回初始狀態(tài)。

查看流水線執(zhí)行歷史

您可以點(diǎn)擊具體的流水線執(zhí)行版本，查看當(dāng)前流水線歷史的具體信息。通過(guò)此信息，可以快速地查看流水線的執(zhí)行日志以及狀態(tài)等，便于掌握流水線的執(zhí)行情況或排查問(wèn)題。

升級(jí)流水線構(gòu)建環(huán)境運(yùn)行時(shí)

您可以使用流水線runtime-setup插件或者修改資源描述文件環(huán)境變量的方式來(lái)設(shè)置流水線運(yùn)行時(shí)版本。