保護ルール違反の確認

設定した保護ルールが本当に機能するか、わざと違反してみて確認します。

1. 違反1: mainブランチへの直接Push

保護ルールが設定された状態で、mainブランチに直接Pushしてみます。

Visual Studio CodeでREADME.mdを開き、末尾に次の1行を追加します。

保護ルール適用後に直接Pushするテストです。

保存したら、ターミナルで以下のコマンドを1つずつ実行します。

git add .
git commit -m "test: direct push after protection"
git push origin main

今回はPushが拒否されるはずです。以下のようなエラーメッセージが表示されます。

remote: error: GH013: Repository rule violations found for refs/heads/main.
remote: 
remote: - Changes must be made through a pull request.
remote: 
To https://github.com/<your-github-account-name>/devopscamp-branch-protection-handson.git
 ! [remote rejected] main -> main (push declined due to repository rule violations)
error: failed to push some refs to 'https://github.com/...'

Changes must be made through a pull request.というメッセージが表示されていれば、Rulesetが正しく動作しています。Bypass modeをPull requestsにしているため、admin権限を持っていてもCLIでの直接Pushは拒否されます。

2. 違反2: 必須ステータスチェックの失敗

次に、「CIが失敗しているPull Requestはマージできない」ことを確認します。今回のワークフローは「README.mdが存在しない場合に失敗」するよう作ってあるため、わざとREADME.mdを削除したPull Requestを作成して、チェックを失敗させます。

2.1 作業用ブランチの作成とREADME.mdの削除

先ほど確認したように、mainブランチへの直接Pushは拒否されます。一方で、mainブランチ以外の作業用ブランチであれば通常通りPushでき、そこからPull Requestを作ってmainにマージする流れになります。ここでは、READMEを削除する作業用ブランチを切ってPushします。

作業用ブランチを作成します。

git switch -c test/delete-readme

Visual Studio CodeのエクスプローラーでREADME.mdを右クリックし、「削除」を選択して削除します。

変更をステージングします。

git add .

コミットします。

git commit -m "test: delete README to trigger failure"

Pushします。

git push origin test/delete-readme

2.2 Pull Requestの作成

GitHubのリポジトリページを開き、Pull requestsタブからNew pull requestをクリックします。

base: main, compare: test/delete-readmeでPull Requestを作成します。

2.3 ワークフローの実行結果とマージボタンの確認

作成したPull Requestの画面を開くと、README Check / Check README existsのワークフローが実行されます。しばらくすると実行結果が**失敗(赤バツ)**になります。

Run Check README.md existsのステップを開くと、Error: README.md does not existというメッセージが出力されてエラー終了していることが確認できます。

Pull Requestの画面を下にスクロールすると、マージボタンの周辺にRequired status check "Check README exists" is expected.(または類似の赤いメッセージ)が表示されます。Merge pull requestボタンは灰色で無効化された状態になっており、ステータスチェックが失敗している間はマージできません。

これが「CIをパスしないコードはmainに入れない」という必須ステータスチェックの効果です。

3. 違反3: Admin bypassの動作確認

違反2の状態で、Admin権限を持つユーザがPull Request画面から例外的にマージできることを確認します。

今のPull Request画面に戻ります。マージボタンの近くに**Merge without waiting for requirements to be met (bypass rules)**というチェックボックス、または「管理者としてルールをバイパスしてマージする」といった趣旨のオプションが表示されています。

💡 ポイント
Admin bypassのUI(チェックボックスやボタン)の文言・形式は、GitHubのUI更新によって変わることがあります。「bypass rules」「管理者として強制マージ」「Required checksを無視してマージ」など、類似の表現を探してください。表示されない場合は、RulesetのBypass listでRepository adminがPull requestsモードで追加されているかを確認してください。

このチェックボックスをオンにするとMerge pull requestボタンが有効化され、本来マージできないはずのPull Request(README.mdを削除したPull Request)を強制的にマージできます。

ただし、今回はマージせずに次のステップに進んでください。実際にマージするとmainブランチのREADME.mdが消え、このあとの操作で混乱する可能性があるためです。Admin bypassの動作は「バイパス用のUIが存在していること」の確認のみで十分です。

実際には、緊急修正(hotfix)を最速で反映したい場合や、CI環境の障害で必須チェックが動かない場合などに、責任者がbypassを使います。bypass操作はGitHubのAudit logに残るため、誰がいつbypassしたかを後から追跡可能です。

4. 状態の復元

違反確認が終わったので、状態を元に戻します。作成したPull Requestをそのままにしておくと、後続の操作で邪魔になる可能性があるためです。

GitHub画面でPull Requestを開き、Close pull requestをクリックしてクローズします(マージはしません)。

ローカルでは、mainブランチに戻します。

git switch main

不要になった作業用ブランチを削除します。

git branch -D test/delete-readme

ここまで完了していれば、違反確認は完了です。