ビルド時間がチームの死因になる前に：Bitbucket Pipelines「キャッシュ戦略」の真髄
CI/CDが「開発の加速装置」ではなく「待ち時間の元凶」になっていないか？
Bitbucket Pipelinesで数分、あるいは10分以上のビルド待ちが発生しているなら、それはツールが遅いのではなく、あなたのキャッシュ戦略が「甘い」だけだ。
今日は、現場のテックリードとして、ビルド時間を限界まで削り取り、チームのフィードバックループを爆速化させるための「キャッシュの極意」を伝授する。
—
1. なぜCIが遅いのか？「非効率な再生産」を特定せよ
パイプラインが遅い最大の理由は、毎回ゼロから環境を構築しているからだ。
`npm install` や `pip install` が毎回フルで走っているなら、それはあなたの貴重な時間をドブに捨てているのと同じだ。
最適化の第一歩：
まずは `bitbucket-pipelines.yml` の各ステップに `time` コマンドや、ステップ実行時間のログを詳細に確認し、「どのコマンドに時間がかかっているか」を可視化せよ。依存関係の解決が全体の8割を占めているはずだ。
—
2. Pipelinesキャッシュを「魔法の箱」に変えるYAMLパターン
Bitbucket Pipelinesには強力なキャッシュ機能がある。これを使いこなすのがプロの最低条件だ。
ベストプラクティス：依存関係キャッシュの最適化
以下の設定は、Node.jsプロジェクトにおいて依存関係を永続化し、変更がない限り再インストールをスキップする鉄板構成だ。
definitions:
caches:
# カスタムキャッシュキーの定義
node-modules: node_modules
pipelines:
default:
- step:
name: Build and Test
caches:
- node # Bitbucket標準のnodeキャッシュ
script:
# キャッシュキーが一致すれば、ここでのインストールは瞬時に終わる
- npm ci –prefer-offline –no-audit
- npm run build
ここがプロのポイント：
- `npm ci` を使う：`npm install` ではなく、ロックファイルから確定した依存関係をインストールする `npm ci` を強制せよ。
- `–prefer-offline`：ネットワークにアクセスする前にキャッシュを最大限活用させる。
- `–no-audit`：CI環境でセキュリティスキャンを毎回走らせるな。それは別のステップでやるべきだ。
—
3. 「神」設定：ビルド高速化のためのYAMLハック
さらに一段上の高速化を目指すなら、以下のテクニックを導入せよ。
① マルチステージビルドで無駄を削る
テストとビルドを分け、キャッシュを最適化する。
pipelines:
branches:
main:
- step:
name: Install Dependencies
caches:
- node
script:
- npm ci
artifacts:
- node_modules/ # 依存関係を後続ステップに引き継ぐ
- step:
name: Run Tests
script:
- npm test
- step:
name: Build Application
script:
- npm run build
② プロ専用の「隠し味」
- キャッシュの分割: フロントエンドとバックエンドが同リポジトリにある場合、キャッシュキーを分けるのは基本中の基本。
- Dockerイメージの固定: `image: node:18-alpine` のように、必ずタグを固定せよ。`latest` を使うエンジニアは即座に修正すべきだ。キャッシュのヒット率と環境の再現性が劇的に変わる。
—
4. チームで共有すべき「開発の作法」
ツールを導入するだけでは不十分だ。チーム全体で「速度を正義とする」文化を作れ。
1. ショートカットで脳を直結する:
Bitbucketのダッシュボードで `.` (ドット) を押せ。Web IDEが立ち上がる。修正→コミットのサイクルをブラウザ上で完結させるのが最も速い。
2. `bitbucket-pipelines.yml` のLintを自動化:
設定ファイル自体にエラーがあるとビルドが始まらない。`atlassian-pipelines-runner` をローカルに入れて、プッシュ前に検証する習慣をつけよ。
3. キャッシュの「パージ」を知る:
依存関係の巨大な変更時にはキャッシュが汚染されることがある。Bitbucket UIからキャッシュを手動削除する方法をチーム全員が把握しておくこと。
—
5. 結論：時間は「投資」である
CI/CDの速度は、そのままチームの「開発体験（DX）」に直結する。
ビルドが速いことは、エンジニアがより多くの試行錯誤を繰り返せることを意味する。
今日紹介した設定は、明日からのあなたのパイプラインを劇的に変えるだろう。しかし、満足してはいけない。常にパイプラインのログを監視し、ボトルネックを潰し続けること。
「速さは技術力である」
この言葉を胸に、今日も最高のパイプラインを構築してほしい。質問があればいつでもコメント欄で待っている。君たちのプルリクエストが、かつてない速度で通過することを願っている。