git worktree上の開発環境を整備した話

git worktreeを使った並列開発環境の整備レポートです。
worktreeを作成するコマンドは既にあったものの、各worktree上で独立した開発環境を立ち上げる仕組みがなく、並列開発がしにくい状態でした。そこで compose.override.yml を活用し、既存の compose.yml を使い回しつつネットワークをworktree毎に独立させることで、ポート競合やコンテナ間の名前解決問題を解消しています。
AI Agentとの相性も良く、複数ブランチでの並列開発が現実的に回せる環境が整いました。

Transcript

1. git worktree上の開発環境を整備した話
2. 自己紹介 名前: 寺田邦人 入社日: 2025/12/01 所属: プロダクトディベロップメントユニット メディアディベロップメントA2チーム ITトレンドリプレイスPJ 趣味: 筋トレ、サイクリング、e-sports観戦 slack: #times_kuni
3. git worktree使ってますか？
4. git worktreeとは 1つのリポジトリに対して複数の作業ディレクトリを作成できる機能 異なるブランチを同時にチェックアウトして作業できる ブランチ切り替えのオーバーヘッドを削減 AI Agentと相性が良い 各worktreeが独立した作業環境のため、AIエージェントが別々のブランチで並 行作業しやすい コンテキストの混在を防げる
5. 整備のきっかけ 対象: it-trend-apiリポジトリ worktreeを作るコマンドは既に存在したが... make wt-2 it-trend-api/ └── .worktrees/ └── feature-a/ └── feature-b/ worktree上の開発環境を作るコマンドがなく、並列開発がやりにくかった → worktree上で独立した開発ができるように環境を整備
6. 既存の環境 db, redis, networkは旧システムと共通利用しています。
7. 今回整備した環境
8. 整備する際に問題になったこと 1. ホストに開けるポートの競合 → 未使用のポートをworktree環境に割り当てるスクリプトで対応 2. 同一ネットワーク内におけるコンテナ間の名前解決 compose.ymlを使い回そうとして問題が発生
9. 同一ネットワーク内におけるコンテナ間の名前解決 初期案: compose.ymlを使い回して環境 構築してみた
10. 同一ネットワーク内におけるコンテナ間の名前解決 → コンテナ間の通信は サービス名で行ってお り、同一ネットワーク に配置してしまうと意 図したコンテナに通信 できなくなった
11. 解決策: networkを独立したものに分ける 既存のcompose.ymlを使い回しつつ一部の設定を変えるために compose.override.yml を使用してコンテナを構築(各worktreeで独立したnetworkを作成) # compose.yml services: api: networks: - it-trend-api-network api-nginx: networks: - it-trend-api-network ︙ # compose.override.yml services: api: networks: !override - worktree-network api-nginx: networks: !override - worktree-network ︙ networks: worktree-network: driver: bridge
12. db, redisへの接続方法 worktree環境から見て、db, redis は別networkにある →ホストに開けたポート経由で 接続する # compose.override.yml api: extra_hosts: - "host.docker.internal:host-gateway" ︙
13. 再掲: 今回整備した環境 各worktreeで独立した開発環境が構築できました！ 補足: worktreeを複数作っても各々networkが作成されるため独立して動きます
14. まとめ overrideファイルを活用して、既存のcomposeフ ァイルを使いつつ一部を上書き worktree毎にnetworkを作ることで独立した環境 を実現 複数のworktreeで並列開発が可能になった 並列開発の様子
15. ご清聴ありがとうございました！