組織内のリポジトリのルールセットを管理する

組織のルールセットの管理について

組織レベルでルールセットを作成した後にルールセットを変更して、ユーザーがターゲットリポジトリと対話する方法を変更できます。たとえば、ルールを追加してそれらのリポジトリのブランチやタグの保護を強化することができます。リポジトリのブランチに適用される組織のルールセットでは、リポジトリ管理者がターゲットリポジトリのブランチの名前を変更したり、既定のブランチを別のブランチに変更したりすることができなくなります。リポジトリ管理者は、適切なアクセス許可を持っている限り、ブランチを作成および削除できます。

REST および GraphQL API を使ってルールセットを管理できます。詳細については、「ルールの REST API エンドポイント」および「ミューテーション」を参照してください。

メモ

リポジトリの読み取りアクセス権を持つすべてのユーザーは、そのリポジトリで動作しているアクティブなルールセットを見ることができます。

ルールセットの編集

ルールセットを編集して、名前、バイパスのアクセス許可、ルールなど、ルールセットの一部を変更できます。また、ルールセットを有効または一時的に無効にする場合など、ルールセットを編集してその状態を変更することもできます。

GitHub の右上隅でプロフィール写真を選んでから、 [Your organizations] をクリックします。
組織の隣の [設定] をクリックします。
左のサイドバーの [コード、計画、自動化] セクションで、[ リポジトリ] をクリックし、[ルールセット] をクリックします。
[ルールセット] ページで、編集するルールセットの名前をクリックします。
必要に応じてルールセットを変更します。使用できるルールについては、「ルールセットで使用できるルール」を参照してください。
ページの下部にある [変更の保存] をクリックします。

ルールセットの削除

ヒント

ルールセットを一時的に無効にしたいが、削除したくない場合は、ルールセットの状態を "無効" に設定できます。詳細については、「ルールセットの編集」を参照してください。

GitHub の右上隅でプロフィール写真を選んでから、 [Your organizations] をクリックします。
組織の隣の [設定] をクリックします。
左のサイドバーの [コード、計画、自動化] セクションで、[ リポジトリ] をクリックし、[ルールセット] をクリックします。
削除するルールセットの名前をクリックします。
ルールセットの名前の右側にあるを選び、 [ルールセットの削除] をクリックします。

ルールセット履歴の使用

メモ

ルールセット履歴には、2023 年 10 月 11 日のパブリックプレビューのリリースより後にルールセットに加えられた変更のみが含まれます。

ルールセットに対するすべての変更を表示し、特定のイテレーションに戻すことができます。特定のイテレーションでのルールセットの構成を含む JSON ファイルをダウンロードすることもできます。ルールセットのバイパスリストは、エクスポートされた JSON ファイルから除外されます。

GitHub の右上隅でプロフィール写真を選んでから、 [Your organizations] をクリックします。
組織の隣の [設定] をクリックします。
左のサイドバーの [コード、計画、自動化] セクションで、[ リポジトリ] をクリックし、[ルールセット] をクリックします。
ルールセットの変更履歴を表示するには、ルールセットの名前の右側にあるを選択し、[ 履歴] をクリックします。
特定のイテレーションの右側にあるを選択し、[変更の比較]、[復元]、または [ダウンロード] をクリックします。

ルールセットのインポート

前のセクションからエクスポートした JSON ファイルを使用して、別のリポジトリまたは組織からルールセットをインポートできます。これは、複数のリポジトリまたは組織に同じルールセットを適用する場合に便利です。

GitHub の右上隅でプロフィール写真を選んでから、 [Your organizations] をクリックします。
組織の隣の [設定] をクリックします。
左のサイドバーの [コード、計画、自動化] セクションで、[ リポジトリ] をクリックし、[ルールセット] をクリックします。
[新しいルールセット] ドロップダウンを選択し、[ルールセットのインポート] をクリックします。
エクスポートされた JSON ファイルを開きます。
インポートしたルールセットを確認し、[作成] をクリックします。