こんにちは。現場の最前線でコードとインフラの狭間を走り続けているエンジニアです。
「手元のPCでは動くのに、サーバーに上げると動かない」。そんな悪夢のような状況を過去のものにする魔法、それがCI/CDです。今回は、Bitbucketを使っているチームのために、Bitbucket Pipelinesを使って、わずか10分で「自動化の聖域」を構築する方法を伝授します。
難しいことは一切考えなくて大丈夫。この10分が、あなたのエンジニア人生の「手作業による退屈とミス」を一生分削減するきっかけになります。
—
1. Bitbucket Pipelinesとは何か？（本質を理解する）
多くの人は「ビルドを自動化するツール」と捉えていますが、本質は違います。「あなたのリポジトリの中に、24時間365日休まない最強の品質管理担当者を雇うこと」です。
コードをプッシュした瞬間に、そのコードが「本当に壊れていないか」を自動で検証し、安全な状態で本番環境へ送り出す。このサイクルを確立することで、あなたは「コードを書く」という、最もクリエイティブで楽しい作業に100%集中できるようになります。
—
2. たった10分で構築する「最強の初手」
準備は簡単です。リポジトリのルートディレクトリに `bitbucket-pipelines.yml` という名前のファイルを作るだけ。これがパイプラインの「設計図」になります。
まずは、最もシンプルなNode.js環境でのテスト自動化を実装してみましょう。
bitbucket-pipelines.yml
image: node:18 # コンテナ環境の指定。ここが「誰のPCでも同じ環境」を保証します
pipelines:
default: # どのブランチにプッシュしても走る基本のパイプライン
- step:
name: Build and Test # ステップに名前をつけると失敗時に特定しやすい
caches:
- node # node_modulesをキャッシュして爆速化する魔法
script:
- npm install # 依存関係のインストール
- npm test # テストの実行（ここが失敗するとパイプラインは停止する）
ここがポイント：
- image: Dockerイメージを指定します。これで環境差異によるトラブルはゼロになります。
- caches: これを忘れると毎回 `npm install` が走り、待ち時間でコーヒーを飲む羽目になります。必ず設定しましょう。
—
3. デプロイを自動化する（一歩先の運用へ）
テストが通るようになったら、次は「自動デプロイ」です。例えば、`main` ブランチにマージされたら自動的にサーバーへ反映させる設定を追加します。
pipelines:
branches:
main: # mainブランチ専用のパイプライン
- step:
name: Build and Test
script:
- npm install
- npm test
- step:
name: Deploy to Production
deployment: Production # Bitbucketのデプロイ追跡機能と連携
script:
- echo “デプロイコマンドをここに記述”
- ./deploy.sh # 実際はここにrsyncやAWS CLIなどのデプロイコマンドが入ります
—
4. 現場で震えるほど役立つ「3つのベストプラクティス」
ただ動くものを作るだけではプロとは言えません。現場の事故を防ぐための「極意」を伝授します。
① 「失敗」を恐れない、むしろ喜ぶ
パイプラインが赤く光る（失敗する）のは、「本番環境で事故る前にバグを発見できた」という勝利のサインです。失敗を隠そうとせず、テストコードを充実させて「早く失敗させる」環境を作りましょう。
② シークレットは絶対に書かない
APIキーやパスワードをコードに書くのは論外です。Bitbucketの [Repository settings] > [Deployments] > [Repository variables] に登録し、パイプラインからは `$API_KEY` のように環境変数として呼び出してください。
③ デプロイは「冪等性（べきとうせい）」を確保せよ
「何回実行しても同じ結果になる」状態を保つこと。デプロイ中に中断されても、再実行すれば必ず正常な状態に戻るようなスクリプトを心がけてください。
—
最後に：自動化は「あなたの時間」を取り戻す投資です
最初は設定ファイルを書くのが面倒に感じるかもしれません。しかし、一度このパイプラインを組んでしまえば、あなたは「デプロイの手順書」を読み上げる作業から解放されます。
「自動化」とは単なる効率化ではありません。「人間がやるべきではない退屈な作業を機械に任せ、人間は人間らしい仕事に没頭する」ための贅沢な選択です。
さあ、今すぐ `bitbucket-pipelines.yml` を作成して、あなたのリポジトリに魂を吹き込みましょう。何か詰まったら、いつでも戻ってきてくださいね。あなたのエンジニアライフが、今日から劇的に楽になることを応援しています。