注: GitHub ホステッド ランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。
リポジトリの GitHub Actions 権限について
既定では、GitHub Actions が 上で有効化されると、 はすべてのリポジトリと Organization で有効になります。 GitHub Actions を無効にするか、または Enterprise のアクションに制限することができます。 GitHub Actions の詳細については、「GitHub Actions について」を参照してく� さい。
リポジトリで GitHub Actions を有効化できます。 GitHub Actions を有効にすると、ワークフローは、リポジトリ内および他のパブリックまたは内部リポジトリに配置されているアクションを実行できます。 リポジトリの GitHub Actions を完全に無効化することができます。 GitHub Actionsを無効化すると、リポジトリでワークフローが実行されなくなります。
または、リポジトリで GitHub Actions を有効にしながら、ワークフローが実行できるアクションを制限することもできます。
リポジトリの GitHub Actions 権限を管理する
リポジトリの GitHub Actions を無効にしたり、リポジトリで使用できるアクションを構成するポリシーを設定したりすることもできます。
注: Organization に優先ポリシーがある� �合、または優先ポリシーのある Enterprise によって管理されている� �合は、これらの設定を管理できない� �合があります。 詳細については、「Organization の GitHub Actions の無効化または制限」または「Enterprise での GitHub Actions に対するポリシーの適用」を参照してく� さい。
-
で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [ 設定] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。
-
[Actions permissions] で、オプションを選択します。
[Allow select actions](選択したアクションを許可する) を選択した� �合、エンタープライズ内のアクションが許可され、追� のオプションで、その他の特定のアクションも許可されます。 詳細については、「選択したアクションの実行の許可」を参照してく� さい。
![このリポジトリのアクション ポリシーを設定する](/assets/images/help/repository/actions-policy.png)
- [保存] をクリックします。
選択したアクションの実行の許可
[ [Allow select actions](選択したアクションを許可する) ] を選ぶと、ローカル アクションが許可され、他の特定のアクションを許可するための追� のオプションがあります。
-
[GitHub によって作成されたアクションを許可する]: GitHub によって作成されたすべてのアクションを、ワークフローで使用できるようにします。 GitHub によって作成されたアクションは、
actions
およびgithub
組織にあります。 詳しくは、actions
およびgithub
の Organization をご覧く� さい。 -
[検証済みの作成者による Marketplace アクションを許可する]: このオプションは、GitHub Connect が有効になっていて、GitHub Actions で構成されている� �合に使用できます。 詳細については、「GitHub Connect を使用して GitHub.com アクションへの自動アクセスを有効にする」を参照してく� さい。検証済みの作成者によって作成されたすべての GitHub Marketplace アクションを、ワークフローで使用できるようにします。 GitHubがアクションの作者をパートナーOrganizationとして検証すると、GitHub Marketplaceでアクションの隣にバッジが表示されるようになります。
-
[指定したアクションを許可する]: ワークフローで使用できるアクションを、特定の組織とリポジトリのものに制限します。
アクションの特定のタグまたはコミット SHA へのアクセスを制限するには、ワークフローで使われているのと同じ構文を使って、アクションを選びます。
- アクションの� �合の構文は、
<OWNER>/<REPO>@<TAG OR SHA>
です。 たとえば、タグを選択するにはactions/javascript-action@v1.0.1
を使用し、SHA を選択するにはactions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89
を使用します。 詳細については、「アクションの検索とカスタマイズ」を参照してく� さい。
パターンのマッチには、ワイルドカード文字
*
を使用できます。 たとえば、space-org
で始まる Organization のすべてのアクションを許可するには、space-org*/*
と指定できます。 octocat で始まるリポジトリのすべてのアクションを許可するには、*/octocat**@*
を使用できます。*
ワイルドカードの使用の詳細については、「GitHub Actions のワークフロー構文」を参照してく� さい。 - アクションの� �合の構文は、
この手� �では、特定のアクションを許可リストに追� する方法を示します。
-
で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [ 設定] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。
-
[アクションのアクセス許可] で、[ [Allow select actions](選択したアクションを許可する) ] を選択して、必要なアクションを一覧に追� します。
-
[保存] をクリックします。
プライベート リポジトリのフォークに対するワークフローを有効にする
プライベート リポジトリのフォークの利用に依存している� �合、pull_request
イベントの際にユーザーがどのようにワークフローを実行できるかを制御するポリシーを構成できます。 プライベート リポジトリと内部リポジトリでのみ使用でき、エンタープライズ、組織、またはリポジトリに対してこれらのポリシー設定を構成できます。
Enterprise または Organization でポリシーが無効になっている� �合、リポジトリに対して有効にすることはできません。
- フォーク pull request からワークフローを実行する - 読み取り専用権限を持ち、シークレットへのアクセス権を持たない
GITHUB_TOKEN
を使用して、フォーク pull request からワークフローを実行できます。 - pull request からワークフローに書き込みトークンを送信する - フォークからの pull request で書き込み権限を持つ
GITHUB_TOKEN
を使用できます。 - pull request からワークフローにシークレットを送信する - すべてのシークレットを pull request で利用できるようにします。
プライベート リポジトリのフォーク ポリシーを構成する
-
で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [ 設定] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。 1. [Fork pull request workflows](pull request ワークフローのフォーク) で、オプションを選択します。 例:
-
[保存] をクリックして設定を適用します。
リポジトリに対する GITHUB_TOKEN
のアクセス許可の設定
GITHUB_TOKEN
に付与される既定のアクセス許可を設定できます。 GITHUB_TOKEN
の詳細については、「自動トークン認証」を参照してく� さい。 デフォルトとして制限付きアクセス許可セットを選択するか、より幅広く許可をする設定を適用できます。
既定のアクセス許可は、Organization の設定でも構成できます。 ご利用のリポジトリが組織に属し、その組織の設定でより制限の厳しい既定値が選択されている� �合、リポジトリの設定で同じオプションが選択されて、制限の緩いオプションは無効になります。
リポジトリへの書き込みアクセス権を持っている人は誰でも、ワークフロー ファイルの permissions
キーを編集して、GITHUB_TOKEN
に付与されたアクセス許可を変更でき、必要に応じて追� または削除できます。 詳細については、permissions
をご覧く� さい。
既定の GITHUB_TOKEN
のアクセス許可の構成
-
で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [ 設定] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。
-
[ワークフローのアクセス許可] で、
GITHUB_TOKEN
に対して、すべてのスコープでの読み取りと書き込みアクセスを許可するか、contents
スコープでの読み取りアクセスのみを許可するかを選択します。 -
[保存] をクリックして設定を適用します。
リポジトリ内の GitHub Actions の成果物とログの保持期間を構成する
リポジトリ内の GitHub Actions アーティファクトとログの保持期間を設定できます。
デフォルトでは、ワークフローによって生成された成果物とログファイルは、90日間保持された後自動的に削除されます。 この保持時間を 1 から 400 日の間で変更できます。
保持期間をカスタマイズした� �合、適用されるのは新しい成果物とログファイルに対してであり、既存のオブジェクトにさかのぼっては適用されません。 管理されたリポジトリ及びOrganizationについては、最大の保持期間は管理するOrganizationあるいはEnterpriseによって設定された上限を超えることはできません。
ワークフローによって作成された特定のアーティファクトのカスタ� 保存期間を定義することもできます。 詳細については、「成果物の保持期間を設定する」を参照してく� さい。
リポジトリの保持期間を設定する
- で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [ 設定] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。 1. [成果物とログの保持] で、新しい値を入力します。
- [保存] をクリックして変更を適用します。