保護でできること
ブランチが保護されている場合:- 直接のコミットがブロックされる。 ユーザーは保護されたブランチに変更を直接コミットできません。
- 変更はマージで取り込む必要がある。 保護されたブランチを更新するには、別のブランチで変更を行い、そのブランチを保護されたブランチにマージします。
- 管理者は必要に応じてバイパス可能。 管理者、または特定のユーザーリストに、直接コミットして保護をバイパスすることを許可できます。
ブランチ保護は現在、変更がマージ経由で到達することを強制します。マージにレビューまたは承認を先に通す要件はロードマップにあり、まだ強制されていません。この機能がリリースされ次第、このページは更新されます。
保護ルールの追加
1
Branch Protection 設定を開く
上部ナビゲーションの プロフィールアバター をクリックし、Your organizations を選択します。設定サイドバーで Repositories を選択し、リポジトリ列で Branch protection を選択します。
2
リポジトリを確認
続行する前に、リポジトリ列上部のリポジトリピッカーで正しいリポジトリが選択されていることを確認します。
3
フォームを開く
Add protection rule をクリックします。
4
ブランチを選択
Add branch protection の下で、Branch ドロップダウンを開き、保護したいブランチを選択します。
5
バイパスを設定 (オプション)
Merge restriction の下で、変更がブランチに到達する方法を選択します: マージを許可、マージに承認を必須、またはすべてのマージをブロック。次に、保護されたブランチに直接コミットできる人 (いれば) を選択します:
- Allow admins to bypass — オンにすると、リポジトリ管理者が直接コミットできるようになります。オフの場合、ヘルパーテキストには 「Admins cannot bypass protection.」 と表示されます。
- Bypass restrictions (optional) — Select users… ドロップダウンを使って、保護をバイパスしてこのブランチに直接コミットできる特定のユーザーを追加します。
6
保護を追加
Add protection をクリックします。ブランチが保護されました。
既存ルールの管理
既存の各ルールは、保護されたブランチ、そのバイパスステータス (たとえば 「No bypass allowed」)、直接コミットできる Allowed users を表示します。ルールを編集するには 鉛筆 アイコンを、削除するには ゴミ箱 アイコンを使用します。保護ルールの削除
ブランチの保護を解除するには、Branch protection (プロフィールアバター → Your organizations → Repositories → Branch protection) に戻り、リポジトリピッカーで正しいリポジトリが選択されていることを確認します。そのブランチのルールを見つけ、ゴミ箱 アイコンをクリックして削除します。ブランチへの直接コミットは即座に再び許可されます。