6.3. Pipelines as Code を使用したパイプライン実行の再開またはキャンセル

• /test コメントおよび /retest コメントはすべてのパイプラインの実行を再開します。
• /test <pipeline_run_name> および /retest <pipeline_run_name> コメントは、特定のパイプラインの実行を開始または再開します。このコマンドを使用すると、このパイプライン実行のイベントによってトリガーされたかどうかに関係なく、リポジトリー上の Pipelines as Code パイプライン実行を開始できます。

• /cancel コメントは、すべてのパイプライン実行をキャンセルします。
• /cancel <pipeline_run_name> コメントは、特定のパイプラインの実行をキャンセルします。

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

手順

• プルリクエストを対象にしており、GitHub アプリを使用している場合は、Checks タブに移動して Re-run all checks をクリックします。

• プルリクエストまたはマージリクエストを対象にする場合は、プルリクエスト内のコメントを使用します。

  すべてのパイプラインの実行をキャンセルするコメントの例

  This is a comment inside a pull request.
  /cancel

• プッシュリクエストを対象とする場合は、コミットメッセージ内にコメントを含めます。

  注記

  この機能は、GitHub プロバイダーのみでサポートされています。

  1. GitHub リポジトリーに移動します。
  2. Commits セクションをクリックします。
  3. パイプライン実行を再開するコミットをクリックします。

  4. コメントを追加する行番号をクリックします。

     特定のパイプラインの実行を開始または再開するコメントの例

     This is a comment inside a commit.
     /retest example_pipeline_run

     注記

     プッシュリクエスト内の複数のブランチに存在するコミットに対してコマンドを実行すると、最新のコミットを持つブランチが使用されます。

     これにより、次の 2 つの状況が発生します。

     • /test など、引数を指定せずにコミットでコマンドを実行すると、テストは main ブランチで自動的に実行されます。
     • /test branch:user-branch などのブランチ仕様を含めると、user-branch ブランチのコンテキストを使用して、コメントが配置されているコミットでテストが実行されます。