条件
Updated 2 years ago
by
Admin
条件を使用して、実行時のパイプラインステップの実行を制限できます。たとえば、ブランチごとにステップの実行を制限したい場合があります。
1 kind: pipeline
2 type: exec
3 name: default
4
5 steps:
6 - name: build
7 commands:
8 - go build
9 - go test
10 when:
11 branch:
12 - master
13 - feature/*
条件にワイルドカードマッチングを使用できます。条件は正規表現ではなく、globパターンマッチングを使用することに注意してください。
10 when:
11 ref:
12 - refs/heads/master
13 - refs/heads/**
14 - refs/pull/*/head
複数の条件を組み合わせることもできます。複数の条件を組み合わせる場合は、すべての条件がtrueと評価される必要があることに注意してください。
10 when:
11 branch:
12 - master
13 event:
14 - push
ブランチによる条件
ブランチ条件は、gitブランチに基づいてステップの実行を制限します。ターゲットブランチはプルリクエストに対して評価されることに注意してください。ブランチ名はタグイベントには使用できません。
10 when:
11 branch:
12 - master
13 - feature/*
構文の例：
10 when:
11 branch:
12 include:
13 - master
14 - feature/*
除外構文の例：
10 when:
11 branch:
12 exclude:
13 - master
14 - feature/*
イベントによる条件
イベント条件は、Droneイベントタイプに基づいてステップの実行を制限します。これは、プッシュ、プルリクエスト、タグなどに基づいてステップを制限する場合に役立ちます。
10 when:
11 event:
12 - push
13 - pull_request
14 - tag
15 - promote
16 - rollback
構文の例：
10 when:
11 event:
12 include:
13 - push
14 - pull_request
除外構文の例：
10 when:
11 event:
12 exclude:
13 - pull_request
リファレンスによる条件
リファレンス条件は、git参照名に基づいてステップの実行を制限します。これは、ブランチ名またはタグ名をglobマッチさせたい場合に役立ちます。
10 when:
11 ref:
12 - refs/heads/feature-*
13 - refs/tags/*
構文の例：
10 when:
11 ref:
12 include:
13 - refs/heads/feature-*
14 - refs/pull/**
15 - refs/tags/**
除外構文の例：
10 when:
11 ref:
12 exclude:
13 - refs/heads/feature-*
14 - refs/pull/**
15 - refs/tags/**
リポジトリによる条件
リポジトリ条件は、リポジトリ名に基づいてステップの実行を制限します。これは、リポジトリとそのフォークに対してDroneが有効になっていて、それに応じて実行を制限したい場合に役立ちます。
10 when:
11 repo:
12 - octocat/hello-world
構文の例：
10 when:
11 repo:
12 include:
13 - octocat/hello-world
14 - spacebhost/hello-world
除外構文の例：
10 when:
11 repo:
12 exclude:
13 - octocat/hello-world
14 - spacebhost/hello-world
ワイルドカードマッチングを使用した例：
10 when:
11 repo:
12 include:
13 - octocat/*
インスタンスによる条件
インスタンス条件は、Droneインスタンスのホスト名に基づいてステップの実行を制限します。これは、単一のリポジトリ用に複数のDroneインスタンスを構成し、同じyamlファイルを共有していて、インスタンスごとにステップを制限したい場合に役立ちます。
10 when:
11 instance:
12 - drone.instance1.com
13 - drone.instance2.com
構文の例：
10 when:
11 instance:
12 include:
13 - drone.instance1.com
14 - drone.instance2.com
除外構文の例：
10 when:
11 instance:
12 exclude:
13 - drone.instance1.com
14 - drone.instance2.com
ワイルドカードマッチングを使用した例：
10 when:
11 instance:
12 exclude:
13 - *.company.com
ステータスによる条件
ステータス条件は、パイプラインステータスに基づいてステップの実行を制限します。たとえば、失敗した場合にのみSlack通知を構成したい場合があります。
10 when:
11 status:
12 - failure
失敗時にステップを実行します。
10 when:
11 status:
12 - failure
成功または失敗のステップを実行します。
10 when:
11 status:
12 - success
13 - failure
次の構成は冗長です。デフォルトの動作では、パイプラインステップは、パイプラインが通過状態にある場合にのみ実行されます。
10 when:
11 status:
12 - success
ターゲットによる条件
ターゲット条件は、ターゲット展開環境に基づいてステップの実行を制限します。これは、プロモーションイベントとロールバックイベントにのみ適用されます。
10 when:
11 target:
12 - production
構文の例：
10 when:
11 target:
12 include:
13 - staging
14 - production
除外構文の例：
10 when:
11 target:
12 exclude:
13 - production
