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

5.2. パイプライン実行仕様の動的変数

パイプライン実行仕様で動的変数を使用すると、パイプライン実行をトリガーしたコミットに関する情報を提供したり、GitHub API 操作に一時的な GitHub App トークンを使用したりできます。

重要

現在、パイプラインまたはタスクパラメーターのデフォルト値に Pipelines as Code お動的変数を使用することはサポートされていません。動的変数は value: フィールドで使用できますが、default: フィールドでは使用できません。

5.2.1. コミットと URL 情報
リンクのコピー

{{<var>}} 形式の動的かつ拡張可能な変数を使用して、コミットと URL のパラメーターを指定できます。現在、以下の変数を使用できます。

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

5.2.2. GitHub API 操作用の一時的な GitHub App トークン
リンクのコピー

GitHub App から Pipelines as Code によって生成された一時インストールトークンを使用して、GitHub API にアクセスできます。GitHub App は git-provider-token キーでプライベートリポジトリーのキーを生成します。このキーにアクセスするには、パイプライン実行で {{git_auth_secret}} 動的変数を使用できます。

たとえば、パイプライン実行がプルリクエストにコメントを追加する必要がある場合は、Pipelines as Code アノテーションを使用して、Tekton Hub から github-add-comment タスク定義を取得し、次の例に示すように、コメントを追加するタスクを定義できます。 

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-with-comment
annotations:
  pipelinesascode.tekton.dev/task: "github-add-comment"
spec:
  pipelineSpec:
    tasks:
      - name: add-sample-comment
        taskRef:
          name: github-add-comment
        params:
          - name: REQUEST_URL
            value: "{{ repo_url }}/pull/{{ pull_request_number }}"
1 

          - name: COMMENT_OR_FILE
            value: "Pipelines as Code IS GREAT!"
          - name: GITHUB_TOKEN_SECRET_NAME
            value: "{{ git_auth_secret }}"
          - name: GITHUB_TOKEN_SECRET_KEY
            value: "git-provider-token"
Copy to Clipboard Toggle word wrap
1
動的変数を使用することで、Pipelines as Code で使用する任意のリポジトリーからの任意のプルリクエストに対してこのスニペットテンプレートを再利用できます。
注記

GitHub App では、生成されたインストールトークンは 8 時間利用可能で、イベントが発生したリポジトリーのみに適用されます。スコープは異なる方法で設定できますが、有効期限は GitHub によって決定されます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat