# リポジトリのルールセットの管理
リポジトリ内の既存のルールセットを編集、監視、削除して、ユーザーが特定のブランチやタグを操作する方法を変更できます。
ルールセットを作成した後も、ルールセットに変更を加えることができます。 たとえば、ブランチやタグをより適切に保護するためのルールを追加したり、リポジトリの共同作成者エクスペリエンスへの影響をテストした後にルールセットを "評価" モードから "アクティブ" に切り替。
REST および GraphQL API を使ってルールセットを管理できます。 詳細については、「[ルールの REST API エンドポイント](/ja/enterprise-cloud@latest/rest/repos/rules)」および「[リポジトリ](/ja/enterprise-cloud@latest/graphql/reference/repos#mutation-createrepositoryruleset)」を参照してください。
> \[!TIP]
> あなたが組織の所有者である場合、組織レベルでルールセットを作成できます。 これらのルールセットは、組織内の特定のリポジトリに、およびそれらのリポジトリ内の特定のブランチに適用できます。 詳しくは、「[組織内のリポジトリのルールセットを作成する](/ja/enterprise-cloud@latest/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization)」をご覧ください。
## リポジトリのルールセットの表示
\[ルールセット] ページでは、リポジトリへの読み取りアクセス権を持つすべてのユーザーが、特定のブランチ、タグ、またはプッシュ制限を対象とするアクティブなルールセットを表示できます。
"評価" モードで実行されているルールセットも表示されます。これは適用されません。
フォークされたリポジトリのプッシュ ルールセットの場合、\[ルールセット] ページには、ルールが適用されているソース リポジトリによってルール セットが管理されていることが示されます。
1. GitHub で、リポジトリのメイン ページに移動します。
2. 左側のファイル ツリー ビューで、 ブランチ ドロップダウン メニューを選んでから、**\[View all branches]** をクリックします。 統合ファイル エディターの上部にあるブランチ ドロップダウン メニューも見つかります。
3. ブランチ名の右側にある \[ ] をクリックします。
> \[!TIP] ルールセットを持つブランチにのみ、名前の隣に アイコンがあります。
4. 必要に応じて、結果をフィルター処理するには、タブをクリックするか、\[ブランチの検索] 検索バーを使用します。
5. 表示するルールセットの名前をクリックします。
アクティブなルールセットを表示することもできます。
* `/rules` スラッグをリポジトリの URL に追加します。 たとえば、オープンソース ドキュメント リポジトリの規則を GitHub で表示するには、 に移動します。
* マージ ボックスで、プルリクエストのマージを妨げる規則がある場合は。
## ルールセットの編集
> \[!NOTE]
> ルールセットが organization レベルで作成されている場合、リポジトリの設定からルールセットを編集することはできません。 ルールセットを編集する権限を持っている場合は、組織の設定でそうすることができます。 詳しくは、「[組織内のリポジトリのルールセットを管理する](/ja/enterprise-cloud@latest/organizations/managing-organization-settings/managing-rulesets-for-repositories-in-your-organization#editing-a-ruleset)」をご覧ください。
ルールセットを編集して、名前、バイパスのアクセス許可、ルールなど、ルールセットの一部を変更できます。 また、ルールセットを有効または一時的に無効にする場合など、ルールセットを編集してその状態を変更することもできます。
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. 左側のサイドバーの 「コード、計画、自動化」で、「 **ルールセット**」をクリックし、「 **ルールセット**」をクリックします。
4. \[ルールセット] ページで、編集するルールセットの名前をクリックします。
5. 必要に応じてルールセットを変更します。 使用できるルールについては、「[ルールセットで使用できるルール](/ja/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets)」を参照してください。
6. ページの下部にある **\[変更の保存]** をクリックします。
## ルールセットの削除
> \[!TIP]
> ルールセットを一時的に無効にしたいが、削除したくない場合は、ルールセットの状態を "無効" に設定できます。 詳細については、「[ルールセットの編集](#editing-a-ruleset)」を参照してください。
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. 左側のサイドバーの 「コード、計画、自動化」で、「 **ルールセット**」をクリックし、「 **ルールセット**」をクリックします。
4. 削除するルールセットの名前をクリックします。
5. ルールセットの名前の右側で、 を選んでから、**\[ Delete ruleset]** をクリックします。
![ルールセットを編集するページのスクリーンショット。 3 つのドットのラベルが付いたボタンの下に、\[ルールセットの削除\] というラベルが付いたオプションがオレンジ色の枠線で囲まれています。](/assets/images/help/repository/delete-ruleset.png)
## ルールセット履歴の使用
>
ルールセット履歴には、過去 180 日以内にルールセットに影響を与えた変更によってトリガーされたイベントが一覧表示されます。
ルールセットに対するすべての変更を表示し、特定のイテレーションに戻すことができます。 特定のイテレーションでのルールセットの構成を含む JSON ファイルをダウンロードすることもできます。 ルールセットのバイパス リストは、エクスポートされた JSON ファイルから除外されます。
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. 左側のサイドバーの 「コード、計画、自動化」で、「 **ルールセット**」をクリックし、「 **ルールセット**」をクリックします。
4. ルールセットの変更履歴を表示するには、ルールセットの名前の右側にある を選んでから、** \[History]** をクリックします。
![リポジトリ ルールセットのページのスクリーンショット。 3 つのドットのラベルが付いたボタンの下に、\[履歴\] というラベルが付いたオプションがオレンジ色の枠線で囲まれています。](/assets/images/help/repository/ruleset-history.png)
5. 特定のイテレーションの右側にある を選択し、**\[変更の比較]**、**\[復元]**、または **\[ダウンロード]** をクリックします。
## ルールセットのインポート
JSON ファイルを使って既存のルールセットをインポートできます。 これは、複数のリポジトリまたは組織に同じルールセットを適用する場合に便利です。
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. 左側のサイドバーの 「コード、計画、自動化」で、「 **ルールセット**」をクリックし、「 **ルールセット**」をクリックします。
4. **\[新しいルールセット]** ドロップダウンを選択し、**\[ルールセットのインポート]** をクリックします。
![リポジトリ ルールセットのページのスクリーンショット。 \[New ruleset\] ドロップダウン メニューが展開され、\[Import a ruleset\] オプションがオレンジ色の枠線で囲まれています。](/assets/images/help/repository/import-a-ruleset.png)
5. エクスポートされた JSON ファイルを開きます。
6. インポートしたルールセットを確認し、**\[作成]** をクリックします。
## ルールセットの分析情報の表示
ルールセットの分析情報を表示して、ルールセットがリポジトリにどのように影響しているかを確認できます。 \[ルールの分析情報] ページに、次のユーザー アクションのタイムラインが表示されます。 フィルターを使用し、探しているものを見つけることができます。
* 1 つ以上のルールセットに対してチェックされ、成功したアクション。
* 1 つ以上のルールセットに対してチェックされ、失敗したアクション。
* 他のユーザーがバイパスした 1 つ以上のルールセットに対するアクション。
ルールセットが "評価" モードで実行されている場合、ルールセットがアクティブなときに成功または失敗するアクションを確認することができます。
さらに、これらの分析情報は、ルール スイート [REST API](/ja/enterprise-cloud@latest/rest/repos/rule-suites) を介して使用できます。
![\[ルールの分析情報\] ページのスクリーンショット。 \[Pass\]、\[Bypass\]、\[Fail\] とマークされた 3 つのアクションが一覧に表示されています。 失敗したアクションには、\[Evaluate\] というラベルが付いています。](/assets/images/help/repository/rule-insights.png)
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. 左側のサイド バーの \[コードと自動化] で、 **\[ルール]** をクリックし、 **\[分析情報]** をクリックします。
![リポジトリの \[設定\] ページのサイド バーのスクリーンショット。 \[ルール\] サブメニューが展開され、\[分析情報\] オプションの枠線がオレンジ色で表示されています。](/assets/images/help/repository/ruleset-insights.png)
4. \[ルールの分析情報] ページで、ページ上部のドロップダウン メニューを使用して、ルールセット、ブランチ、アクター、期間でアクションをフィルター処理します。
5. バイパスに失敗した、またはバイパスを必要とした特定のルールを確認するには、 をクリックして、ルールセットの名前を展開します。
![\[ルールの分析情報\] ページのスクリーンショット。 \[not-allowed\] というラベルが付いたイベントの右側にある、3 つのドットが横に並んでいるアイコンが、オレンジ色の枠線で囲まれています。](/assets/images/help/repository/view-rule-runs.png)
6. 必要に応じて、同じマージ グループ内の対応する pull request のマージ キューの詳細を確認します。
### ルール分析情報ダッシュボードの表示
> \[!NOTE]
> ルール分析情報ダッシュボードは、 GitHub Team および GitHub Enterprise Cloud プランで使用できます。
ルール分析情報ダッシュボードには、リポジトリのルール評価アクティビティの概要が視覚的に表示されます。これには、次のものが含まれます。
* **時間の経過に伴う成功、失敗、バイパス**: ルールの評価結果の傾向を示すグラフで、ブロックされたプッシュや通常とは異なるパターンの急増を特定するのに役立ちます。
* **上位バイパス:** ルールセットの最もアクティブなバイパス機能の一覧。
各グラフは、フィルターが事前に入力されたルール洞察ページに戻るリンクが設定されているため、特定のステータス、バイパスしている要素、または時間範囲をすばやく詳しく調べることができます。
ダッシュボードを表示するには:
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. 左側のサイド バーの \[コードと自動化] で、 **\[ルール]** をクリックし、 **\[分析情報]** をクリックします。
4. \[Rule Insights] ページの上部で、ルール評価アクティビティの概要を示すダッシュボード グラフを表示します。
組織レベルでは、ルール分析情報ダッシュボードを表示して、組織全体のルールセットの評価アクティビティを確認できます。 「[組織内のリポジトリのルールセットを管理する](/ja/enterprise-cloud@latest/organizations/managing-organization-settings/managing-rulesets-for-repositories-in-your-organization#viewing-the-rule-insights-dashboard)」を参照してください。
## プッシュ ルールをバイパスする要求の管理
バイパス権限のすべての要求は、リポジトリの \[**ルール**設定] タブにある \[バイパス要求] ページで表示および管理できます。
1. GitHub で、リポジトリのメイン ページに移動します。
2. リポジトリ名の下にある ** \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。
![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)
3. \[**バイパス要求**] をクリックします。
承認者 (バイパス リストのメンバー)、要求者 (要求を作成する投稿者)、期間、および状態によって要求をフィルター処理できます。 要求には次の状態が割り当てられます。
| 状態 | 説明 |
| ----------- | -------------------------------------------------- |
| `Cancelled` | 要求は投稿者によって取り消されました。 |
| `Completed` | 要求が承認され、コミットがリポジトリにプッシュされました。 |
| `Denied` | 要求が審査され否認されました。 |
| `Expired` | 要求の有効期限が切れました。 要求は 7 日間有効です。 |
| `Open` | 要求はまだレビューされていないか、承認されていますが、コミットがリポジトリにプッシュされていません。 |
投稿者が制限された内容などコミットをプッシュするバイパス権限を要求すると、バイパス リストのメンバーはすべて、要求へのリンクを含む電子メールによる通知を受信します。 その後、バイパス リストのメンバーは、要求の有効期限が切れる前に、要求を確認して承認または拒否する 7 日間があります。
投稿者は電子メールで決定を通知され、必要なアクションを実行する必要があります。 要求が承認された場合、投稿者は制限された内容などコミットをリポジトリにプッシュできます。 要求が拒否された場合、投稿者はコミットから制限された内容を削除して、コミットをリポジトリに正常にプッシュする必要があります。