子パイプライン ステップのオプション
子パイプラインでは、パイプライン内で別のパイプラインをトリガーするステップを定義できます。これにより、より複雑なワークフローをモジュール化して効率化し、パイプライン内での並列処理を向上させることができます。「パイプライン ステップ内のパイプライン」を定義するには、次のオプションを使用します。子パイプライン (パイプライン内のパイプライン) ステップでは type: pipeline を使用します。
custom プロパティ
custom オプションは、子パイプライン ステップの実行時に実行されるカスタム パイプラインを定義するために使用されます。
プロパティ — step
必須 — はい (type: pipeline の場合)
データ タイプ — 文字列 (カスタム パイプラインの名前と一致する必要がある)
指定可能な親プロパティ — step
指定可能な子プロパティ — なし
input-variables プロパティ
input-variables プロパティは、親パイプラインから子パイプラインに渡すことができる変数を定義するために使用します。渡された変数は子パイプラインのパイプライン変数と見なされます。
pipeline ステップの入力変数は 20 個までに制限されています。
プロパティ — input-variables
必須 — いいえ
データ タイプ — キーと値のペア (YAML 仕様 - ブロック マッピング)
指定可能な値 — 有効な変数名
名前には ASCII 文字、数字、およびアンダースコアのみを含めることができます。
名前の先頭を数字にすることはできません。
指定可能な親プロパティ — step
例: input-variables オプションを使用して、子パイプラインに公開できる変数を定義します。
pipelines:
custom:
a-parent-pipeline:
- variables:
- name: parent_pipeline_variable
default: "val1"
allowed-values:
- "val1"
- "val2"
- step:
name: 'Child pipeline'
type: pipeline
custom: a-child-pipeline
input-variables:
var_1: $parent_pipeline_variable
var_2: $repository_variable_name
var_3: $workspace_variable_name
var_4: "static-value-1"
var_5: "static-value-2"
a-child-pipeline:
- step:
name: 'Child Pipeline step'
script:
- echo "Parent Pipeline Step Variable -" $var_1
- echo "Parent Pipeline Step Variable -" $var_2script プロパティ
script プロパティは実行されないため、子パイプライン ステップには含めないでください。代わりに、custom プロパティによって参照される子パイプラインのステップが実行されます。
制限されているプロパティ
子パイプライン ステップは、パイプライン内で別のパイプラインを実行するための単なるトリガーです。たとえば、子パイプライン ステップでアーティファクトを定義することは、子パイプライン ステップから生成されるアーティファクトがないことから無効です。ただし、子パイプライン自体に含まれるステップではアーティファクトが生成される場合があります。
次のプロパティはパイプライン ステップではサポートされていないため、type: pipeline を使用する際に含めないでください。子パイプラインではサポートされていない deployment を除いて、これらのプロパティは子パイプライン自体の内部で使用する必要があります。
deployment
Stage
size
ランタイム
output-variables
Cache
artifacts
runs-on
image
clone
oidc
services
この内容はお役に立ちましたか?