Bitbucketを「ただのコード置き場」にするな：テックリードが教える極限のパイプライン最適化戦略
Bitbucketを単なる「Gitのホスティング先」だと思っているなら、それは大きな損失だ。Atlassianエコシステムの中に身を置く我々にとって、BitbucketはJiraやConfluenceと有機的に結合し、開発サイクルを自動化するための「心臓部」であるべきだ。
本稿では、Bitbucketの基本を押さえつつ、現場の生産性を数倍に跳ね上げるための「プロのハック」を伝授する。
—
1. 準備：SSH鍵は「厳格」に管理せよ
初心者はHTTPSの認証で消耗するが、プロは最初からSSH鍵一択だ。ここで重要なのは、鍵の管理を疎かにしないこと。
プロのTips:
- `~/.ssh/config` を使い分けろ。複数のアカウント（個人用/仕事用）を運用する場合、Hostごとに鍵を指定するのが鉄則だ。
~/.ssh/config のベストプラクティス
Host bitbucket.org-work
HostName bitbucket.org
User git
IdentityFile ~/.ssh/id_rsa_work
Host bitbucket.org-personal
HostName bitbucket.org
User git
IdentityFile ~/.ssh/id_rsa_personal
—
2. リポジトリの生命線：`bitbucket-pipelines.yml` の極意
Bitbucket Pipelinesは、記述が簡潔であるほど良い。しかし、ただ動くだけではダメだ。キャッシュ戦略を最適化し、パイプラインの実行時間を削り取れ。
実践的：高速化のための設定例
image: node:20-alpine
pipelines:
default:
- step:
name: Build and Test
caches:
- node # 依存関係のキャッシュを有効化（必須）
script:
- npm ci # npm installよりも高速かつ安全
- npm run lint
- npm test
artifacts:
- dist/ # ビルド成果物を次のステップへ引き継ぐ
極限の最適化テクニック:
- Dockerレイヤーキャッシュ: `docker build` を使う際は `–cache-from` を活用し、イメージを再ビルドする時間を最小限にせよ。
- 並列実行: `parallel` キーワードを活用し、テストスイートを分割して実行時間を劇的に短縮せよ。
—
3. チーム開発を加速させる「神プラグイン」と設定
Bitbucket単体では足りない機能を、Atlassian Marketplaceの力で補完する。
1. Refined for Bitbucket: UIが劇的に改善される。特にプルリクエストのレビュー画面が洗練され、認知負荷が下がる。
2. Bitbucket Code Insights: テスト結果やセキュリティスキャン結果をPR上に直接表示させる。これがないと、わざわざ外部ツールを見に行くという「コンテキストスイッチ」が発生し、生産性が落ちる。
—
4. チームで共有すべき「マージ戦略」のルール
「なんとなくマージする」のが一番の悪だ。チーム全体で以下のルールを徹底せよ。
- Squash Mergeをデフォルトにせよ: 履歴をクリーンに保つため、featureブランチのコミット履歴はPRマージ時に一つにまとめろ。
- ブランチモデルの強制: `feature/`, `bugfix/`, `hotfix/` 以外のブランチ作成を禁止せよ。これを守るだけで、リリース管理の複雑性が半分になる。
- Branch Permissions: Master/Developブランチには「最低2人の承認（Approvals）」と「ビルドの成功」を必須条件（Merge Checks）として設定しろ。これは「壊れたコード」を本番に混ぜないための防波堤だ。
—
5. 現場で震えるほど役立つ「隠れたショートカット」
マウスを使っている時間はロスだ。指をホームポジションから動かすな。
- `?`: キーボードショートカット一覧を表示（まずはこれを覚えろ）
- `Shift + P`: プルリクエストの作成画面へ即座にジャンプ
- `g` + `i`: Issuesへ移動
- `g` + `p`: Pull Requestsへ移動
- `a` / `d`: レビュー中のコードで、前のファイル／次のファイルへ移動
—
テックリードからの提言
Bitbucketは、設定すればするほど「開発者の脳内の負荷」を下げてくれるツールだ。
- 設定のコード化: パイプライン設定は必ずリポジトリ内に置き、ブランチごとに挙動を変えろ。
- 自動化への執着: 「人がやらなくていいこと」をPipelineに押し込め。テスト、デプロイ、依存関係のチェック、セキュリティスキャン。これらを自動化して初めて、君は「本質的な価値を生むコード」を書く時間に集中できる。
ツールを使いこなすのではない。ツールに「思考と作業」を代行させ、君はプロダクトの未来を設計することに命を燃やせ。
さあ、今日からBitbucketのパイプラインを書き換え、ビルド時間を1秒でも短縮するところから始めよう。それが、伝説のエンジニアへの第一歩だ。