Function Compute：管理流水線

流水線配置

流水線配置主要包括流水線觸發方式、流水線執行環境、資源描述YAML、DingTalk機器人通知四個配置項，其中只有流水線觸發方式、流水線執行環境可以在建立應用、建立環境階段進行配置，這四項都可以在建立成功後單擊編輯按鈕配置。

流水線觸發方式

應用中心支援使用者自訂觸發流水線的Git事件。應用中心通過Webhook來接收Git事件，當接收到滿足觸發規則的事件時，將按照使用者配置的流水線YAML建立並執行流水線。當前支援的觸發方式如下：

• 分支觸發：需要環境關聯指定分支，匹配指定分支所有的Push事件。

• Tag觸發：匹配指定Tag運算式的所有Tag建立事件。

• 分支合并觸發：匹配指定來源分支到環境所關聯的目標分支的Merge/Pull Request合并事件。

流水線執行環境

流水線執行環境分為預設執行環境和專有執行環境兩種模式。

預設執行環境

預設執行環境下，流水線的資源由平台完全託管，由阿里雲Function Compute為您承擔流水線執行過程中的費用成本，您無需付出任何費用。流水線的每個任務都會運行在獨立安全沙箱環境中，平台會保證您的流水線執行環境的安全隔離。預設執行環境的使用限制如下：

• 執行個體資源規格：4vCPU、8GB記憶體。

• 臨時磁碟空間：10 GB。

• 任務執行逾時：15分鐘。

• 地區限制：模板直接部署、GitHub代碼源使用海外新加坡地區，Gitee、公網GitLab、Codeup使用中國杭州地區。

• 網路限制：不支援固定IP地址以及網段，不支援IP白名單方式訪問指定網站，不支援訪問您的VPC內的資源。

專有執行環境

專有執行環境會將流水線任務在使用者的帳號下執行，提供更多自訂的能力。應用中心會根據使用者的授權完全代管專有執行環境的任務，即時在使用者賬戶下調度Function Compute執行個體運行流水線。和預設執行環境類似，專有執行環境提供完全Serverless化的能力，使用者無需營運基礎設施。

通過專有執行環境，您可以使用如下自訂能力：

• 地區及網路：您可以指定執行環境的地區以及VPC，實現訪問內網代碼倉庫、製品倉庫、鏡像倉庫、Maven私服等情境。支援的地區請參見開服地區。

• 執行個體資源規格：您可以指定執行環境的CPU、記憶體規格。例如，指定更大規格的執行個體來加快構建速度。

  說明

  vCPU大小（單位為核）與記憶體大小（單位為GB）的比例必須設定在1:1到1:4之間。

• 持久化儲存：您可以指定NAS掛載以及OSS掛載配置。例如通過NAS掛載來進行檔案快取，實現加速構建的效果。

• 日誌：您可以指定SLS的記錄項目和日誌倉庫，實現流水線執行日誌的持久化。

• 逾時時間：您可以自訂流水線任務的執行逾時。預設為600秒，最長為86400秒。

資源描述YAML

Serverless應用中心和ServerlessDevs開發人員工具進行了深度整合，你可以通過ServerlessDevs的資源描述檔案來聲明業務的資源配置。預設的資源描述檔案名稱為s.yaml，您也可以指定其他檔案名稱。指定資源描述檔案後，在流水線中有兩種使用方式：

• 當使用部署外掛程式@serverless-cd/s-deploy時，外掛程式執行時會自動使用指定的資源描述檔案進行部署，執行的原理是在Serverless Devs的操作指令中增加-t/--template命令。下面的樣本，指定的資源描述YAML檔案為demo.yaml，外掛程式執行的命令就是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

• 當使用指令碼方式執行時，可以通過${{ ctx.data.deployFile }}來引用具體的資源描述檔案名稱。例如下面的樣本，效果是當指定了資源描述檔案時就使用指定檔案執行s plan命令，否則使用預設的s.yaml執行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

DingTalk機器人通知

開啟該配置後，需要配置DingTalk機器人的Webhook地址、加簽密鑰、通知規則以及自訂訊息等。您可以在此集中管理需要通知的任務，也可以通過流水線YAML對各個任務分別開啟通知。在此處完成通知的整體配置後，您也可以進一步在流水線詳情中進行各個任務的通知細化配置。

流水線環境變數

在流水線環境變數地區，點擊編輯，選擇配置環境的方式，按照下方步驟完成配置，然後單擊部署。

• 使用表單編輯（預設）

  1. 單擊+添加變數。

  2. 配置環境變數的索引值對：

     • 變數：自訂。

     • 值：自訂。

• 使用JSON格式編輯

  1. 單擊使用JSON格式編輯。

  2. 在文字框內，輸入對應的JSON格式的索引值對，格式如下。

     {
         "key": "value"
     }

     樣本如下。

     {
         "REGION": "MY_REGION",
         "LOG_PROJECT": "MY_LOG_PROJECT"
     }

當前環境變數會在Serverless Devs流水線中生效，可以通過${env(key)} 在s.yaml中引用，也可以通過 $Key在Shell命令中引用，樣本如下。

vars:
  region: ${env(REGION)}
  service:
    name: demo-service-${env(prefix)}
    internetAccess: true
    logConfig:
      project: ${env(LOG_PROJECT)}
      logstore: fc-console-function-pre
    vpcConfig:
      securityGroupId: ${env(SG_ID)}
      vswitchIds:
        - ${env(VSWITCH_ID)}
      vpcId: ${env(VPC_ID)}

流水線詳情

在流水線詳情地區，您可以配置流水線流程，對流水線中的任務、任務間的關係進行詳細配置。平台會自動產生預設流水線流程，您可以基於該流程進行二次編輯。

流水線通過YAML進行管理，當前提供了平台託管和倉庫讀取兩種配置方式：

平台託管

流水線YAML預設由平台託管，即配置在平台中心化管理，更新後下次部署時生效。

倉庫讀取

流水線的YAML描述檔案儲存體在遠端Git倉庫，在控制台中編輯儲存後平台會即時向您的Git倉庫提交Commit，該提交不觸發流水線的執行。當您的代碼倉庫事件觸發流水線執行時，平台使用您指定的Git倉庫中的流水線YAML建立流水線並執行。

您可以在流水線詳情地區上方指定倉庫讀取，輸入YAML的檔案名稱。如下圖所示。

流水線詳情地區的主體由左側的協助工具輔助區與右側的YAML編輯區構成：

• YAML編輯區：您可以直接對流水線YAML進行編輯，來實現對流水線流程的修改，參考使用YAML檔案描述流水線。

• 協助工具輔助區：提供了針對YAML編輯的協助工具輔助，包含：

  • 流程預覽：提供了對流水線流程的可視化預覽與簡單編輯能力。

  • 工作範本：提供了一系列常用的任務YAML模板。

地區右上方有儲存、全螢幕模式、重設三個按鈕：

• 儲存按鈕會儲存頁面中對YAML的更改，並同步到流水線YAML中。

• 全螢幕模式按鈕可以將主題編輯地區放大到全屏操作。

• 重設按鈕則將取消從上次儲存YAML之後的所有更改，退回初始狀態。

查看流水線執行歷史

您可以點擊具體的流水線執行版本，查看當前流水線歷史的具體資訊。通過此資訊，可以快速地查看流水線的執行日誌以及狀態等，便於掌握流水線的執行情況或排查問題。

升級流水線構建環境運行時

您可以使用流水線runtime-setup外掛程式或者修改資源描述檔案環境變數的方式來設定流水線運行時版本。