必要なワークフロー

注: GitHub は、GitHub Actions に必要なワークフローをサポートしなくなりました。マージ前にパスするようにワークフローに要求するには、GitHub Enterprise Server を最新バージョンにアップグレードし、代わりにリポジトリルールセットを使用します。

GitHub Enterprise Server のアップグレードの詳細については、「新しいリリースへのアップグレードについて」を参照してください。

ルールセットの詳細は、「ルールセットで使用できるルール」をご覧ください。

概要

任意のターゲットブランチに対して開かれたすべての pull request に、組織内のリポジトリで実行する必要があるワークフローを構成できます。必要なワークフローを使用すると、現在および将来のリポジトリに適用される組織全体の CI/CD ポリシーを実装できます。必要なワークフローは pull_request と pull_request_target 既定のイベントによってトリガーされ、必須の状態チェックとして表示されます。これにより、必要なワークフローが成功するまで pull request をマージする機能がブロックされます。

必要なワークフローは、再利用可能なワークフローと同じではありません。再利用可能なワークフローは、別のワークフローによって呼び出すことができます。必要なワークフローは、組織の所有者によってリポジトリに適用されます。

前提条件

必要なワークフローを構成する前に、次の前提条件にご注意ください。

必要なワークフローが実行されるように、Organization の設定で、リポジトリに対して GitHub Actions を有効にする必要があります。 Organization レベルで有効にすると、リポジトリの設定で GitHub Actions が無効になっている場合にも、必要なワークフローが実行されます。組織のリポジトリでの GitHub Actions の管理の詳細については、「Organization について GitHub Actions を無効化または制限する」を参照してください。
必要なワークフローは、必須ステータスチェックが Organization の計画でサポートされているリポジトリ内でのみ、Organization で使うことができます。必須ステータスチェックがサポートされていない場合、ワークフローは引き続き実行されますが、必須のチェックにはならず、マージはブロックされません。必要なステータスチェックのサポートの詳細については、「保護されたブランチについて」を参照してください。
必要なワークフローが必須ステータスチェックとして実行されるように、リポジトリの既定のブランチは、Organization の既定のブランチの設定と一致している必要があります。既定のブランチ名が一致していない場合、ワークフローは引き続き実行されますが、必須チェックにはなりません。既定のブランチ名の管理の詳細については、「Organization のリポジトリのデフォルブランチ名を管理する」と「デフォルトブランチを変更する」を参照してください。
必要なワークフローを実行するには、pull request のソースリポジトリがターゲットリポジトリと同じ Organization に存在している必要があります。 GitHub Enterprise Server は、ワークフローを含むリポジトリの指定されたブランチ、タグ、またはコミット SHA から必要なワークフローをソースにします。
必要なワークフローで使うシークレットは、Organization レベルかターゲットリポジトリ内で作成する必要があります。
ソースリポジトリ内のシークレットは、ワークフローがターゲットリポジトリ内で実行される場合にはフェッチされません。
あるワークフローが必須のワークフローとして実行されるとき、on: セクションのすべてのフィルターが無視されます。たとえば、branches、branches-ignore、paths、types などです。必須のワークフローは、既定のイベントである pull_request と pull_request_target に対してのみ実行されます。既定のアクティビティの種類について詳しくは、「ワークフローをトリガーするイベント」をご覧ください。
必須のワークフローは、求められるチェックとして自動的に表示される場合であっても、既存の pull request で自動的にトリガーされることはありません。既存の pull request に対して必須のワークフローをトリガーするには、その pull request に新しい変更をプッシュします。

ソースリポジトリの制限と動作

ソースリポジトリとワークフローに関する次の制限と動作にご注意ください。

必要なワークフローは、任意のリポジトリフォルダーに格納可能で、通常のワークフローのように .github/workflows フォルダーに限定されることはありません。必要なワークフローが再利用可能なワークフローを呼び出す場合は、その再利用可能なワークフローを .github/workflows フォルダーに格納する必要があります。再利用可能なワークフローを呼び出すときは、再利用可能なワークフローへの完全なパスと参照を、必要なワークフローで使う必要があります。たとえば、{owner}/{repo}/.github/workflows/{filename}@{ref} のようにします。
必要なワークフローがプライベートリポジトリか内部リポジトリに含まれている場合は、リポジトリ内のワークフローが Organization 内の他のリポジトリからアクセスできるようにする必要があります。詳細については、「リポジトリの GitHub Actions の設定を管理する」を参照してください。
パブリックリポジトリに格納されているワークフローは、Organization 内の任意のリポジトリの必要なワークフローとして構成できます。プライベートリポジトリに格納されているワークフローは、Organization 内の他のプライベートリポジトリの必要なワークフローとして構成できます。内部リポジトリに格納されているワークフローは、Organization 内の内部リポジトリとプライベートリポジトリの必要なワークフローとして構成できます。
CodeQL でリポジトリレベルでの構成が必要なため、CodeQL は必要なワークフローでサポートされていません。コードスキャンの構成については、「コードスキャンの高度なセットアップの構成」を参照してください。
必要なワークフローは、ワークフローファイルを含むリポジトリから任意のブランチ、タグ、またはコミット SHA を使用して参照できます。

ターゲットリポジトリの制限と動作

ターゲットリポジトリの次の制限と動作にご注意ください。

必要なワークフローをすべてのリポジトリで、または選択したリポジトリで実行されるように構成する場合、この必要なワークフローを含むリポジトリの可視性は、ワークフローを実行している Organization 内のリポジトリに影響します。パブリックリポジトリに格納されている必要なワークフローは、すべてのリポジトリで実行されます。プライベートリポジトリに格納されている必要なワークフローは、他のプライベートリポジトリで実行されます。内部リポジトリに格納されている必要なワークフローは、内部リポジトリとプライベートリポジトリで実行されます。
必要なワークフローを、このワークフローが作成されたリポジトリで実行されるように構成することはできません。必要なワークフローを格納するには、別のリポジトリの作成を検討する必要があります。
必要なワークフローをすべてのリポジトリで、または選択したリポジトリで実行されるように構成する場合、必要なワークフローは、Organization の設定でアクションが無効になっているリポジトリでは実行されません。