鉄壁のBitbucket運用：CI/CDの速度を殺さず、セキュリティを極限まで高める「実戦的」管理術
「セキュリティを厳しくすると開発速度が落ちる」というのは、現場を知らない管理職の妄言だ。真のDevOpsエンジニアにとって、強固なセキュリティは「安心してフルスピードでコードをデプロイするための土台」に他ならない。
今日は、Bitbucketを単なるリポジトリ置き場から、「セキュアかつ爆速な開発エンジン」へと昇華させるための極限の管理術を伝授する。
—
1. 権限管理の最適解：ワークスペースを「汚さない」設計
多くのチームが陥る罠は、リポジトリ単位で細かく権限をいじりすぎることだ。これは管理コストの増大を招き、結果として「誰がアクセスできるか不明」なブラックボックスを生む。
- 鉄則：プロジェクト単位のグループ管理
- `Admin`, `Developer`, `ReadOnly` の3つ以上のグループをプロジェクトごとに定義せよ。
- ユーザーを直接リポジトリに追加するのではなく、必ず「グループ」を介すこと。これにより、異動や退職時の権限剥奪が1クリックで完結する。
- 2FA強制は「議論の余地なし」
- ワークスペース設定の `Security` から「Require two-step verification」をオンにしろ。これを拒否するエンジニアに、本番環境のデプロイ権限を与えるべきではない。
—
2. ネットワーク制限：IPホワイトリストの自動化
IPホワイトリスト設定は、VPN経由や固定IP環境において必須の防壁だ。しかし、手動設定はミスを呼ぶ。
プロのハック：
APIを叩いてIPリストを更新するスクリプトをCIパイプラインに組み込み、会社のゲートウェイIPが変更された際に自動追従させるのが賢い。「手動で設定を直す」という運用自体を、CI/CDで排除するのだ。
—
3. 生産性を跳ね上げる「現場の神ツール・小技」
必須プラグイン：
1. Bitbucket Slack Integration: プルリクの承認状況やビルド失敗を即座に通知。「気づかない」という言い訳を物理的に消す。
2. Pull Request Template: プロジェクトルートに `.bitbucket/pull_request_template.md` を配置し、レビュー時に確認すべき項目（テスト、ドキュメント、破壊的変更の有無）をテンプレート化せよ。
キーボードショートカット（これを使わない手はない）：
- `?`：ヘルプを開く（まずはここから）
- `g` + `p`：Pull Request一覧へジャンプ
- `g` + `i`：Issue一覧へジャンプ
- `a`：コードレビュー画面で「承認」
—
4. 実戦的 `bitbucket-pipelines.yml` の構成例
CI/CDの速度を落とさないための、キャッシュとマルチステージングを意識したベストプラクティス構成だ。
bitbucket-pipelines.yml
image: node:18-alpine
definitions:
caches:
# node_modulesをキャッシュし、インストール時間を数分単位で短縮する
npm-cache: $HOME/.npm
steps:
- step: &build-test
name: Build and Test
caches:
- npm-cache
script:
- npm ci
- npm run lint
- npm run test:unit
artifacts:
- dist/ # ビルド成果物を次のステージへ引き継ぐ
pipelines:
branches:
master:
- step: build-test
- step:
name: Deploy to Production
deployment: Production
# ここでIP制限されたデプロイゲートウェイを通過させる
script:
- ./scripts/deploy.sh
—
5. チーム開発で守るべき「聖域のルール」
どれだけツールを整えても、運用が腐れば全てが終わる。以下のルールをチームに徹底せよ。
1. Branching Modelの強制:
- `master` への直接プッシュは無効化せよ。必ずプルリクエストを通す。
- `feature/` ブランチは、デプロイ後に必ず自動削除する設定（Pipelines設定内）を有効にすること。
2. レビューのボトルネックを消す:
- 「変更行数が200行を超えたPRはレビューしない」という文化を作れ。大きすぎるPRはリスクの塊だ。小さく切り出し、素早くマージする。
3. 設定の共有化:
- `.editorconfig` をプロジェクトルートに置き、インデントや改行コードを強制せよ。コードの差分が「意味のある変更」だけになるよう、環境レベルでクリーンに保つ。
—
最後に：ツールを使いこなすということ
Bitbucketの設定を最適化することは、単なる管理作業ではない。「エンジニアが書くコードに集中できる環境を、自動化で作り上げること」だ。
権限管理を厳格化し、CI/CDを洗練させれば、チームのストレスは劇的に減る。今すぐあなたのワークスペースの `Settings` を開き、不要な権限を剥ぎ取り、自動化のタネを撒いてほしい。
現場の生産性は、常に「設定の細部」に宿る。明日からではなく、今この瞬間から最適化を開始せよ。