Alibaba Cloud DevOps：流水線任務 jobs

非必填。流水線任務運行環境，可以使用雲效提供的公用 K8s 叢集環境，也可以使用私人主機構建叢集。支援 指定容器環境 和 預設VM環境。

• 指定容器環境：在構建機器上啟動指定容器，在單容器環境進行構建。文法樣本如下：

  jobs:
    my_job:
      name: 我的工作
      runsOn:
        group: public/ap-southeast-1 // 指定容器環境目前僅支援雲效公用構建叢集
        container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest // 公網可直接存取的 public 鏡像地址,雲效系統官方鏡像參考：https://atomgit.com/flow-steps/system_images/blob/main/README_INTL.md 

  構建叢集	yaml 標識	說明
  雲效新加坡構建叢集	group: public/ap-southeast-1	雲效提供的新加坡公用 K8s 叢集（未指定 runsOn 時的預設值）
  私人構建叢集	group: private/<私人構建叢集ID>	通過私人構建叢集添加的企業私人主機叢集

• 預設VM環境：直接在構建叢集的宿主機或虛擬機器上執行步驟。樣本如下：

  jobs:  
    my_job:    
      name: 我的工作      
        runsOn:        
          group: private/<私人構建叢集ID>   // 僅支援私人構建叢集，指定私人構建叢集        
          labels: windows, amd64          // 指定作業系統、架構調度；不填時，則隨機調度到叢集中的某台機器        
          vm: true                        // 指定 VM 構建環境

  目前私人構建叢集支援接入 Linux、Windows、macOS 機器，各作業系統支援架構和構建環境如下：

  作業系統	架構	labels	說明
  Linux	amd64	linux,amd64	支援 預設環境 和 預設VM環境
  Linux	arm64	linux,arm64	僅支援 預設VM環境，需要指定 vm: true
  Windows	amd64	windows,amd64	僅支援 預設VM環境，需要指定 vm: true
  Windows	arm64	windows,arm64	僅支援 預設VM環境，需要指定 vm: true
  macOS	amd64	darwin,amd64	僅支援 預設VM環境，需要指定 vm: true
  macOS	arm64	darwin,arm64	僅支援 預設VM環境，需要指定 vm: true

非必填，構建環境規格。雲效會根據任務中配置的步驟自動分配 DEFAULT 預設規格，預設規格詳見協助文檔：https://www.alibabacloud.com/help/doc-detail/201868.html 。如有需要，您也可以指定構建環境規格，規格可選：SMALL_1C2G、MEDIUM_2C4G、LARGE_4C8G、XLARGE_8C16G。

如：

jobs:
  my_job:
    name: 我的工作
    runsOn:
      group: public/ap-southeast-1
      container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest
      instanceType: LARGE_4C8G    # 指定構建環境規格

非必填，預設任務運行逾時時間為 240 分鐘，支援設定範圍 1~1440 分鐘

如：

jobs:
  my_job:
    name: 我的工作
    runsOn:
      group: public/ap-southeast-1
      container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest
    timeoutMinutes: 60		# 任務開始運行後，60分鐘逾時結束

非必填，填寫該值，則可以在任務結束之後保留任務執行環境，並登入到環境中進行調試。

只能和”指定容器環境“一起使用。

這兩個值需要一起填寫，或者都不填寫。

debugPolicy 的可選值：

1. onFailure：僅任務運行失敗時才保留運行環境，運行成功或僅紅線卡點不通過則不會保留環境

2. always：無論任務是否成功都保留構建環境

debugRetentionMinutes 是1-240之間的整數，表示保留的時間長度

如：

jobs:
  my_job:
    name: 我的工作
    runsOn:
      group: public/ap-southeast-1
      container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest
    debugPolicy: always
    debugRetentionMinutes: 5

jobs:
  my_job:
    name: 我的工作
    runsOn:
      group: public/ap-southeast-1
      container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest
    driven: manual		#手動確認執行任務
    

jobs:
  my_job:
    name: 我的工作
    runsOn:
      group: public/ap-southeast-1
      container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest
    condition: |
      "${CI_COMMIT_REF_NAME}" == "master"		# 運行分支為 master 時執行該任務

jobs:
  deploy_job:
  name: 主機群組部署任務
  component: VMDeploy             # 指定組件
  with:                           # 填寫組件的參數
    artifact: $[stages.build_stage.build_job.upload_step.artifacts.default]
    machineGroup: <YOUR-MACHINE-GROUP-ID>
    ......