Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

5.5. パイプライン実行に一致するイベントをフィルターするためのアノテーション

1 つ以上のアノテーションをパイプライン実行に追加して、このパイプライン実行に一致するイベントをフィルターできます。この場合、定義された一致するイベント（プルリクエスト、プッシュイベント、コメントなど）が発生すると、コードとしてのパイプラインは、これらのアノテーションも一致するかどうかを確認します。パイプライン実行は、追加したすべてのアノテーションが一致する場合にのみ起動します。

5.5.1. 特定のパスの変更とパイプライン実行の対応付け
リンクのコピー

指定したパス内で変更があった場合のみ、パイプラインを実行するように設定できます。Pipelines as Code は、プルリクエストまたはプッシュイベントにリストしたパスの変更が含まれる場合にのみパイプライン実行を開始します。

* ワイルドカードはディレクトリー内の任意のファイルを表します。** ワイルドカードは、ディレクトリー内の任意のファイル、またはそのディレクトリーの配下のサブディレクトリーを表します。

次の例を使用すると、プルリクエストによって pkg ディレクトリー、cli ディレクトリー、または cli ディレクトリーの配下のサブディレクトリーにあるファイルが変更されたときに、pipeline-pkg-or-cli パイプラインの実行をトリガーします。 

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-pkg-or-cli
annotations:
  pipelinesascode.tekton.dev/on-path-changed: "[pkg/*, cli/**]"
# ...
Copy to Clipboard Toggle word wrap

5.5.2. パイプライン実行のマッチング処理からパスの変更を除外する
リンクのコピー

プルリクエストが指定されたパスのセット内のファイルのみを変更する場合に、マッチング処理を除外するようにパイプライン実行を設定できます。パイプラインの実行がイベントと一致しているが、プルリクエストにはリストしたパス内のファイルへの変更のみが含まれている場合、Pipelines as Code はパイプラインの実行を開始しません。

次の例を使用すると、docs/generated ディレクトリーまたはそのサブディレクトリーにのみ変更が加えられた場合を除き、docs ディレクトリーまたはサブディレクトリーのファイルがプルリクエストで変更された場合に、pipeline-docs-not-generated パイプライン実行がトリガーされます。 

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-docs-not-generated
annotations:
  pipelinesascode.tekton.dev/on-path-changed: "[docs/**]"
  pipelinesascode.tekton.dev/on-path-changed-ignore: "[docs/generated/**]"
# ...
Copy to Clipboard Toggle word wrap

次の例を使用すると、docs ディレクトリーまたはサブディレクトリーにのみ変更が加えられた場合を除き、プルリクエストが main ブランチを対象とする場合に、pipeline-main-not-docs パイプライン実行がトリガーされます。 

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-main-not-docs
annotations:
  pipelinesascode.tekton.dev/on-target-branch: "[main]"
  pipelinesascode.tekton.dev/on-event: "[pull_request]"
  pipelinesascode.tekton.dev/on-path-changed-ignore: "[docs/**]"
# ...
Copy to Clipboard Toggle word wrap

5.5.3. プルリクエストラベルとパイプライン実行とのマッチング処理
リンクのコピー

重要

パイプライン実行とプルリクエストラベルを紐づけする機能は、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

パイプライン実行を 1 つまたは複数のプルリクエストラベルと紐づけることができます。コードとしてのパイプラインは、プルリクエストにこれらのラベルのいずれかがある場合にのみパイプライン実行を開始します。プルリクエストが新しいコミットで更新されると、ラベルがまだ存在する場合、Pipelines as Code はパイプライン実行を再度開始します。

bug ラベルまたは defect ラベルをプル要求に追加した場合、またはこのラベルの付いたプル要求を新しいコミットで更新する場合に、以下の例を使用して、pipeline-bug-or-defect Pipeline 実行と紐づけできます。 

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-bug-or-defect
annotations:
  pipelinesascode.tekton.dev/on-label: "[bug, defect]"
# ...
Copy to Clipboard Toggle word wrap
注記

Pipelines as Code の現行バージョンは、GitHub、Gitea、および GitLab リポジトリーのホストサービスプロバイダー専用のプルリクエストラベルとの合致イベントをサポートします。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat