こんにちは。現場の最前線でコードと戦い続けているエンジニアの皆さん。
今日は、Bitbucketという強力な武器を「ただのコード置き場」から「チームの規律を守る鉄壁の要塞」へと進化させる方法を伝授します。
多くのチームが「誰でもどこにでもプッシュできる」という自由の代償として、本番環境の破壊やマージの衝突という地獄を味わっています。しかし、Bitbucketの「ブランチ制限（Branch Restrictions）」を正しく使いこなせば、そんな悲劇は過去のものになります。
さあ、あなたのリポジトリを、ミスを許さない「堅牢なシステム」へと作り替えましょう。
—
1. Bitbucketにおける「権限」の本質とは？
Bitbucketの権限管理は、単なる「アクセス制限」ではありません。「開発プロセスの自動強制」です。
Gitは柔軟ですが、柔軟すぎるとチーム開発では崩壊します。Bitbucketのブランチ制限を使うことで、開発者がコードを書く前に「ルール」をシステムに理解させ、物理的に間違いが起きない状態を作ります。
2. まずはここから！「鉄壁のブランチ制限」基本セットアップ
まずは、Bitbucket上で最も神聖な場所である `main`（または `master`）ブランチを守る設定から始めましょう。
設定手順:
1. リポジトリのサイドバーから [Repository settings] を開く。
2. [Branch restrictions] を選択。
3. [Add branch restriction] をクリック。
ここで、以下の設定を適用してください。
- Branch pattern: `main` (または `master`)
- Prevent changes: 「Push」を禁止し、「Delete」も禁止する。
- Require pull request: これが重要。`main` への直接プッシュを完全に封じます。
なぜこれが必要か？
人間はミスをする生き物です。キーボードの打ち間違いで `main` にゴミコードをプッシュする可能性を、システムレベルで排除する。これが平和な開発の第一歩です。
—
3. レビューアーの強制と「承認の重み」
ただPR（プルリクエスト）を通すだけでは不十分です。「誰が承認したか」をコントロールしましょう。
高度な設定:
- Require minimum number of approvals: 少なくとも「2名」の承認を必須にする。
- Require successful builds: CI（Bitbucket Pipelines）がグリーン（成功）にならない限り、マージボタンを無効化する。
- Reset approvals when new commits are made: コードが変更されたら、既存の承認をリセットする。
これらを設定すると、「テストが通っていない汚いコード」や「誰にも見られていない不安なコード」は、絶対に本番系に紛れ込まなくなります。
—
4. 特定ディレクトリへの書き込みを制御せよ（CODEOWNERSの活用）
「インフラ設定ファイルには、特定のシニアエンジニアしか触らせたくない」ということはありませんか？
Bitbucketでは `CODEOWNERS` ファイルをルートディレクトリに配置することで、これを実現できます。
.bitbucket/CODEOWNERS
インフラ関連のファイルは、特定のチームの承認が必須
/infrastructure/ @DevOps-Team
/docs/ @Technical-Writer-Team
この設定により、`infrastructure` 以下のファイルに変更を加えた場合、指定したチームのメンバーの承認がない限りマージがブロックされます。これにより、組織の専門性をコードベースで維持できるのです。
—
5. タグの保護：リリースの聖域を守る
タグ（`v1.0.0`など）を不用意に上書きしたり削除したりすると、リリース履歴が崩壊します。
- Branch pattern: `v` または `release/`
- Prevent changes: 「Delete」と「Push」を禁止。
タグへの変更を制限することで、「昨日までは動いていたのに、なぜか今朝動かない」という怪奇現象を未然に防ぎます。
—
6. 初心者へのアドバイス：まずは「失敗できない環境」を作る
ここまで読んで「厳しすぎる」と感じたかもしれません。しかし、「厳しいルールは、開発者の自由を奪うのではなく、不安から解放するためにある」のです。
1. まずは `main` ブランチの保護から始めてください。
2. 次に、CI/CDとの連携（マージ前のテスト自動化）を組み込んでください。
3. 最後に、`CODEOWNERS` で責務を明確にしましょう。
これらを導入するだけで、チームのコード品質は劇的に向上します。レビューの際に「このコードは本当にテストした？」と聞く必要はもうありません。Bitbucketが代わりに聞いてくれているからです。
—
最後に：エンジニアとしての心構え
ツールはただの設定項目ではありません。「チームがどうあるべきか」という哲学を投影するキャンバスです。
今日紹介した設定を適用すれば、あなたは「コードを書くこと」から、「価値を生み出す仕組みを作ること」へ一歩近づきます。最初は抵抗があるかもしれませんが、一度この快適さを味わえば、もう元には戻れませんよ。
何か不明点があれば、いつでも聞いてください。あなたのプロジェクトが、より堅牢で、より幸せなものになることを心から願っています。
さあ、Bitbucketの設定画面を開いて、最強のルールを書き込んでみましょう！