Bitbucket Code Insights：PRを「単なるコード置き場」から「最強の品質ゲート」へ変貌させる技術
多くのチームがBitbucketを単なる「Gitのホスティング場所」としてしか使っていない。これは、フェラーリを買い物カゴとして使っているようなものだ。
真のDevOpsエンジニアにとって、プルリクエスト（PR）はレビュー待ちのスタックではなく、「自動化された品質保証の最終防衛ライン」であるべきだ。今回は、Bitbucketの「Code Insights」をフル活用し、外部ツールと連携させて「マージボタンを押す前に全判断が完結する」究極のパイプライン構築術を伝授する。
—
1. なぜCode Insightsなのか？
多くのCI/CDパイプラインは、「ビルド失敗時にメールを飛ばす」だけで終わっている。これでは、レビュアーはコンソールログを掘り返し、何が原因かを自力で特定しなければならない。
Code Insightsを使えば、静的解析（SonarQube/ESLint等）、テストカバレッジ、セキュリティスキャン（Snyk等）の結果を、PRの「Code Insights」タブに構造化データとして流し込める。 レビュアーはコードから視線を逸らさずに、品質基準を瞬時に判断できるのだ。
—
2. 実装の核心：Code Insights APIへの流し込み方
外部ツールと連携させるには、BitbucketのREST APIを叩くスクリプトをCIパイプライン（Bitbucket Pipelinesなど）の最後に仕込む。
実践：JSONレポートのAPI投入テンプレート
以下は、任意の静的解析ツールが生成したJSONをCode Insightsへ投稿する際のPythonスクリプト例だ。
import requests
import os
Bitbucket APIエンドポイント
API_URL = f”https://api.bitbucket.org/2.0/repositories/{WORKSPACE}/{REPO}/commit/{COMMIT_HASH}/reports/my-linter-001″
payload = {
“title”: “Static Analysis Report”,
“details”: “ESLintによる品質チェック結果”,
“report_type”: “BUG”,
“reporter”: “CI-Bot”,
“link”: “https://ci-tool.example.com/build/123”,
“result”: “FAILED”, # PASSED/FAILEDでPRのステータスを制御可能
“data”: [
{“title”: “Issues Found”, “type”: “NUMBER”, “value”: 5},
{“title”: “Coverage”, “type”: “PERCENTAGE”, “value”: 82.4}
]
}
認証にはApp Passwordを使用すること
response = requests.put(API_URL, json=payload, auth=(USER, APP_PASSWORD))
—
3. マージを自動ブロックする「品質ゲート」設定
Code Insightsを投稿するだけでは不十分だ。「品質を満たさないコードは物理的にマージさせない」という制約が不可欠である。
1. Repository Settings > Branch restrictions を開く。
2. 「Add branch restriction」から、対象ブランチ（main/develop）を選択。
3. 「Check for at least one successful build」 および 「Code Insights」の特定のレポートが成功していることを必須条件として追加する。
これで、CIでエラーが出た瞬間にマージボタンがグレーアウトする「鉄壁のゲート」が完成する。
—
4. チーム生産性を爆速化する「神ハック」
① キーボードショートカットの徹底
マウスを使っている暇はない。Bitbucketで最も使うべきは以下の2つだ。
- `a` : PR内でファイルを開いた状態で `a` を押すと、即座にコメント入力モードになる。
- `j` / `k` : ファイルリストの上下移動。
- `?` : 全ショートカットを表示。これを見ていないメンバーには、強制的に覚えるよう促せ。
② Bitbucket Pipelinesのキャッシュ戦略
`bitbucket-pipelines.yml` でキャッシュを定義していないのは罪である。`node_modules` や `pip` のキャッシュを効かせるだけで、パイプライン時間は秒単位で短縮できる。
definitions:
caches:
node: ~/.npm
pipelines:
default:
- step:
caches:
- node
script:
- npm ci # npm installではなくciを使うこと（高速かつ堅牢）
- npm run lint
③ 必須プラグイン：Code Insights連携の決定版
- SonarQube for Bitbucket: 静的解析のデファクト。Code Insightsとの統合が極めて深く、複雑なコードの技術的負債を可視化する。
- Slack Integration (Official): CIのステータスをSlackに通知させるだけでなく、PRのコメントもチャンネルに流すことで、非同期コミュニケーションの解像度を上げる。
—
5. テックリードからの提言：設定の「コード化」
設定を手動でポチポチ変えるのは今日で終わりにしよう。チームで共有すべきは「設定ファイル」そのものだ。
リポジトリのルートに `.bitbucket/` ディレクトリを切り、そこに `pipelines.yml` のスニペットや、CIで使用するLint設定、`CODEOWNERS` ファイルを配置する。「ドキュメントを読むな、設定ファイルを見ろ」と言える環境こそが、最強のエンジニアリングチームの証だ。
Code Insightsを使いこなせば、PRレビューは「バグ探し」から「アーキテクチャの対話」へと進化する。さあ、今すぐパイプラインに「目」を搭載し、人間が本来やるべき創造的な仕事に集中する環境を作り上げよう。