Alibaba Cloud DevOps:パイプラインジョブ

任意。パイプラインジョブが実行される環境。Apsara DevOps が提供するパブリック Kubernetes (K8s) クラスター環境またはプライベートホストビルドクラスターを使用できます。サポートされている環境には、指定コンテナー環境とデフォルト VM 環境が含まれます。

• 指定コンテナー環境: ビルドマシンで指定されたコンテナーを起動し、単一コンテナー環境でビルドを実行します。次の例は構文を示しています:

  jobs:
    my_job:
      name: My task
      runsOn:
        group: public/ap-southeast-1 // 指定コンテナー環境は現在、Apsara DevOps パブリックビルドクラスターのみをサポートしています。
        container: build-steps-public-registry.ap-southeast-1.cr.aliyuncs.com/build-steps/alinux3:latest // インターネットからアクセスできるパブリックイメージアドレス。公式 Apsara DevOps システムイメージの詳細については、https://atomgit.com/flow-steps/system_images/blob/main/README_INTL.md をご参照ください。 

  ビルドクラスター	YAML 識別子	説明
  Apsara DevOps シンガポールビルドクラスター	group: public/ap-southeast-1	Apsara DevOps がシンガポールで提供するパブリック K8s クラスター。これは runsOn が指定されていない場合のデフォルトクラスターです。
  プライベートビルドクラスター	group: private/<private_build_cluster_ID>	プライベートビルドクラスターを介してエンタープライズに追加されるプライベートホストクラスター。

• デフォルト VM 環境: ビルドクラスターのホストまたは VM 上で直接ステップを実行します。以下に例を示します:

  jobs:  
    my_job:    
      name: My task      
        runsOn:        
          group: private/<private_build_cluster_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 を設定する必要があります。

任意。ビルド環境の仕様。Apsara DevOps は、ジョブで構成されたステップに基づいて DEFAULT 仕様を自動的に割り当てます。デフォルト仕様の詳細については、https://www.alibabacloud.com/help/doc-detail/201868.html のドキュメントをご参照ください。ビルド環境の仕様を指定することもできます。有効な値は SMALL_1C2G、MEDIUM_2C4G、LARGE_4C8G、および XLARGE_8C16G です。

例:

jobs:
  my_job:
    name: My task
    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 から 1,440 分までの値に設定できます。

例:

jobs:
  my_job:
    name: My task
    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: My task
    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: My task
    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: My task
    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: Host group deployment task
  component: VMDeploy             # コンポーネントを指定します。
  with:                           # コンポーネントのパラメーターを指定します。
    artifact: $[stages.build_stage.build_job.upload_step.artifacts.default]
    machineGroup: <YOUR-MACHINE-GROUP-ID>
    ......