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

1.3.6. トリガー

Trigger をパイプラインと併用して、Kubernetes リソースで CI/CD 実行全体を定義する本格的な CI/CD システムを作成します。Trigger は外部イベントをキャプチャーし、それらのイベントを処理して情報の主要な部分を抽出します。このイベントデータを事前に定義されたパラメーターのセットにマップすると、Kubernetes リソースを作成およびデプロイし、パイプラインをインスタンス化できる一連のタスクがトリガーされます。

たとえば、アプリケーションの Red Hat OpenShift Pipelines を使用して CI/CD ワークフローを定義します。アプリケーションリポジトリーで新たな変更を有効にするには、パイプラインを開始する必要があります。トリガーは変更イベントをキャプチャーし、処理することにより、また新規イメージを最新の変更でデプロイするパイプライン実行をトリガーして、このプロセスを自動化します。

Trigger は、再利用可能で分離した自律型 CI/CD システムを設定するように連携する以下の主なリソースで設定されています。

  • TriggerBinding リソースはイベントを検証し、イベントペイロードからフィールドを抽出し、それらをパラメーターとして保存します。
  • TriggerTemplate リソースは、リソースの作成方法の標準として機能します。これは、TriggerBinding リソースからのパラメーター化されたデータが使用される方法を指定します。トリガーテンプレートは、トリガーバインディングから入力を受信し、新規パイプラインリソースの作成および新規パイプライン実行の開始につながる一連のアクションを実行します。
  • EventListener は、JSON ペイロードを含む受信 HTTP ベースイベントをリッスンするエンドポイントまたはイベントシンクを提供します。これは各 TriggerBinding リソースからイベントパラメーターを抽出し、次にこのデータを処理し、対応する TriggerTemplate リソースによって指定される Kubernetes リソースを作成します。EventListener リソースは、イベントの interceptors を使用してペイロードで軽量イベント処理または基本的なフィルターを実行します。これはペイロードのタイプを特定し、オプションでこれを変更します。現時点で、パイプライントリガーは Webhook インターセプター、 GitHub インターセプター、 GitLab インターセプター、および Common Expression Language (CEL) インターセプター の 4 種類のインターセプターをサポートします。
  • Trigger リソースは TriggerBinding および TriggerTemplate リソースを接続し、この Trigger リソースは EventListener 仕様で参照されます。

以下の例は、TriggerBinding リソースのコードスニペットを示しています。これは、受信イベントペイロードから Git リポジトリー情報を抽出します。 

apiVersion: triggers.tekton.dev/v1alpha1
1 

kind: TriggerBinding
2 

metadata:
  name: vote-app
3 

spec:
  params:
4 

  - name: git-repo-url
    value: $(body.repository.url)
  - name: git-repo-name
    value: $(body.repository.name)
  - name: git-revision
    value: $(body.head_commit.id)
Copy to Clipboard Toggle word wrap
1
TriggerBinding リソースの API バージョン。この例では、v1alpha1 です。
2
Kubernetes オブジェクトのタイプを指定します。この例では、TriggerBinding です。
3
この TriggerBinding を識別する一意の名前。
4
受信イベントペイロードから抽出され、 TriggerTemplate に渡されるパラメーターの一覧。この例では、Git リポジトリー URL、名前、およびリビジョンはイベントペイロードの本体から抽出されます。

以下の例は、TriggerTemplate リソースのコードスニペットを示しています。これは、作成した TriggerBinding リソースから受信される Git リポジトリー情報を使用してパイプライン実行を作成します。 

apiVersion: triggers.tekton.dev/v1alpha1
1 

kind: TriggerTemplate
2 

metadata:
  name: vote-app
3 

spec:
  params:
4 

  - name: git-repo-url
    description: The git repository url
  - name: git-revision
    description: The git revision
    default: master
  - name: git-repo-name
    description: The name of the deployment to be created / patched

  resourcetemplates:
5 

  - apiVersion: tekton.dev/v1beta1
    kind: PipelineRun
    metadata:
      name: build-deploy-$(tt.params.git-repo-name)-$(uid)
    spec:
      serviceAccountName: pipeline
      pipelineRef:
        name: build-and-deploy
      params:
      - name: deployment-name
        value: $(tt.params.git-repo-name)
      - name: git-url
        value: $(tt.params.git-repo-url)
      - name: git-revision
        value: $(tt.params.git-revision)
      - name: IMAGE
        value: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/$(tt.params.git-repo-name)
      workspaces:
      - name: shared-workspace
        volumeClaimTemplate:
         spec:
          accessModes:
           - ReadWriteOnce
          resources:
            requests:
              storage: 500Mi
Copy to Clipboard Toggle word wrap
1
TriggerTemplate リソースの API バージョン。この例では、v1alpha1 です。
2
Kubernetes オブジェクトのタイプを指定します。この例では、TriggerTemplate です。
3
TriggerTemplate リソースを識別するための一意の名前。
4
TriggerBinding または EventListerner リソースによって提供されるパラメーター。
5
TriggerBinding または EventListener リソースを使用して受信されるパラメーターを使用してリソースを作成する必要がある方法を指定するテンプレートの一覧。

以下の例は、TriggerBinding および TriggerTemplate リソースを接続する vote-trigger という名前の Trigger リソースのコードスニペットを示しています。 

apiVersion: triggers.tekton.dev/v1alpha1
1 

kind: Trigger
2 

metadata:
  name: vote-trigger
3 

spec:
  serviceAccountName: pipeline
4 

  bindings:
    - ref: vote-app
5 

  template:
6 

     name: vote-app
Copy to Clipboard Toggle word wrap
1
Trigger リソースの API バージョン。この例では、v1alpha1 です。
2
Kubernetes オブジェクトのタイプを指定します。この例では、Trigger です。
3
この Trigger リソースを識別するための一意の名前。
4
使用されるサービスアカウント名。
5
TriggerTemplate リソースに接続する TriggerBinding リソースの名前。
6
TriggerBinding リソースに接続するための TriggerTemplate リソースの名前。

以下の例は、vote-trigger という名前の Trigger リソースを参照する EventListener リソースを示しています。 

apiVersion: triggers.tekton.dev/v1alpha1
1 

kind: EventListener
2 

metadata:
  name: vote-app
3 

spec:
  serviceAccountName: pipeline
4 

  triggers:
    - triggerRef: vote-trigger
5
Copy to Clipboard Toggle word wrap
1
EventListener リソースの API バージョン。この例では、v1alpha1 です。
2
Kubernetes オブジェクトのタイプを指定します。この例では、EventListener です。
3
EventListener リソースを識別するための一意の名前。
4
使用されるサービスアカウント名。
5
EventListener リソースによって参照される Trigger リソースの名前。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat