第6章 パイプライン実行の管理

• {{repo_owner}}: リポジトリーの所有者。
• {{repo_name}}: リポジトリー名。
• {{repo_url}}: リポジトリーの完全な URL。
• {{revision}}: コミットの完全 SHA リビジョン。
• {{sender}}: コミットの送信者のユーザー名またはアカウント ID。
• {{source_branch}}: イベントが発生したブランチ名。
• {{target_branch}}: イベントが対象とするブランチ名。プッシュイベントの場合、これは source_branch と同じです。
• {{pull_request_number}}: pull_request イベントタイプに対してのみ定義されたプルまたはマージリクエスト番号。
• {{git_auth_secret}}: プライベートリポジトリーをチェックアウトするための Git プロバイダーのトークンで自動的に生成されるシークレット名。

• 作成者がリポジトリーの所有者である。
• 作成者がリポジトリーのコラボレーターである。
• 作成者がリポジトリーの組織のパブリックメンバーである。
• コメントの作成者が Kubernetes ドキュメント で定義されているように、リポジトリーのルートにある OWNERS ファイルの approvers または reviewers のセクションにリストされている。Pipelines as Code は OWNERS および OWNERS_ALIASES ファイルの仕様をサポートします。OWNERS ファイルに フィルター セクションが含まれている場合、Pipelines as Code は approvers と reviewers を .* フィルターに対してのみ照合します。

• main ブランチを対象とし、wip ブランチからの pull_request イベントを一致させるには、次のようにします。

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && target_branch == "main" && source_branch == "wip"
  ...

• パスが変更された場合にのみパイプラインを実行するには、glob パターンで .pathChanged 接尾辞関数を使用できます。

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr-pathchanged
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && "docs/\*.md".pathChanged() 1
  # ...

  1

  docs ディレクトリー内のすべてのマークダウンファイルと一致します。

• [DOWNSTREAM] で始まるすべてのプルリクエストとマッチさせるには、以下を実行します。

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr-downstream
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request && event_title.startsWith("[DOWNSTREAM]")
  # ...

• pull_request イベントでパイプラインを実行し、experimental ブランチを省略するには、以下を実行します。

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr-not-experimental
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && target_branch != experimental"
  # ...

• event: push または pull_request イベント。
• target_branch: ターゲットブランチ。
• source_branch: 元の pull_request イベントのブランチ。push イベントの場合は、target_branch と同じです。
• event_title: push イベントのコミットタイトルや、pull_request イベントのプルまたはマージリクエストのタイトルなど、イベントのタイトルとマッチします。現在、サポートされているプロバイダーは GitHub、Gitlab、および Bitbucket Cloud のみです。
• .pathChanged: 文字列への接尾辞関数です。文字列は、パスが変更されたかどうかを確認するパスの glob にすることができます。現在、GitHub と Gitlab のみがプロバイダーとしてサポートされています。

• プルリクエストは main ブランチをターゲットとしています。
• プルリクエストの作成者は superuser です。
• アクションは synchronize です。このアクションは、プルリクエストで更新が発生したときにトリガーされます。

関連情報

• CEL language specification