保護でできること
ブランチが保護されている場合:- 直接のコミットがブロックされる。 ユーザーは保護されたブランチに変更を直接コミットできません。
- 変更はマージで取り込む必要がある。 保護されたブランチを更新するには、別のブランチで変更を行い、そのブランチを保護されたブランチにマージします。
- 管理者は必要に応じてバイパス可能。 管理者、または特定のユーザーリストに、直接コミットして保護をバイパスすることを許可できます。
保護ルールの追加
1
Branch Protection 設定を開く
上部ナビゲーションの プロフィールアバター をクリックし、Organization settings を選択します。設定サイドバーで Repositories を選択し、リポジトリ列で Branch protection を選択します。
2
リポジトリを確認
続行する前に、リポジトリ列上部のリポジトリピッカーで正しいリポジトリが選択されていることを確認します。
3
フォームを開く
Add protection rule をクリックします。
4
ブランチを選択
Add branch protection の下で、Branch ドロップダウンを開き、保護したいブランチを選択します。
5
バイパスを設定 (オプション)
Merge restriction の下で、変更がブランチに到達する方法を選択します:
- Allow merges — マージに承認は不要です。
- Require approvals to merge — マージには、選択した数 (1〜5) のレビュー承認が必要です。レビューの作成者は、自分のレビューを承認したり変更をリクエストしたりすることはできません。Count only approvals given on the latest commit にチェックを入れると、マージ対象のブランチの最新コミットより前に与えられた承認は無視されます。新しいコミットが追加されたら、レビュアーはブランチをマージする前に再度承認する必要があります。
- Block all merges — バイパスユーザー (および許可されている場合は管理者) のみがマージできます。
- Allow admins to bypass — オンにすると、リポジトリ管理者が直接コミットできるようになります。オフの場合、ヘルパーテキストには 「Admins cannot bypass protection.」 と表示されます。
- Bypass restrictions (optional) — Select users… ドロップダウンを使って、保護をバイパスしてこのブランチに直接コミットできる特定のユーザーを追加します。
6
保護を追加
Add protection をクリックします。ブランチが保護されました。
既存ルールの管理
既存の各ルールは、保護されたブランチ、そのバイパスステータス (たとえば 「No bypass allowed」)、そのマージ制限 (たとえば 「Requires 2 approval(s) on the latest commit」)、直接コミットできる Allowed users を表示します。ルールを編集するには 鉛筆 アイコンを、削除するには ゴミ箱 アイコンを使用します。保護ルールの削除
ブランチの保護を解除するには、Branch protection (プロフィールアバター → Organization settings → Repositories → Branch protection) に戻り、リポジトリピッカーで正しいリポジトリが選択されていることを確認します。そのブランチのルールを見つけ、ゴミ箱 アイコンをクリックして削除します。ブランチへの直接コミットは即座に再び許可されます。