Terraform×GitHub Actions複数人運用のブランチ戦略と環境分離

当ページのリンクには広告が含まれています。
Terraform×GitHub Actions複数人運用のブランチ戦略と環境分離
IT女子 アラ美IT女子 アラ美
💡 IaC実装力で海外×高単価案件を狙いなさい!
外資・グローバル特化の匿名スカウトで年収800万超の案件が届きます
自分らしく働けるエンジニア転職を目指すなら【strategy career】
この記事の結論
複数人でTerraformを運用するなら、「環境別ディレクトリ分離 × ブランチ命名規則 × PR時のterraform plan自動化」の3点セットが最も実務的なブランチ戦略です。本記事では、stateロック衝突とドリフトを抑え込み、レビュー負荷を増やさないGitHub Actions連携の設計パターンを詳しく解説します。

お疲れ様です!IT業界で働くアライグマです!

Terraformを2〜3人を超えるチームで運用しはじめると、ほぼ確実に「stateロック衝突」「PRの順番待ち」「環境間ドリフト」の3点で誰もが頭を抱えます。たとえばAWSのリソース数百個を10名で触っているチームでは、terraform planが走るたびに別メンバーの作業が止まり、レビューも追いつかず、勝手にコンソール操作されてドリフトが発生するという悪循環がよく起こります。本記事では、Terraform×GitHub Actionsの組み合わせを前提に、複数人でも衝突しないブランチ戦略と環境分離・PRレビュー設計を、実装テンプレートと導入の進め方の例つきで解説します。

目次

複数人Terraform運用で起きるstateロック衝突とドリフトの課題

IT女子 アラ美IT女子 アラ美
💡 IaCを任される社内SEへ転職しなさい!
社内SE特化エージェントで非公開求人を無料で診断できます
社内SEを目指す方必見!IT・Webエンジニアの転職なら【社内SE転職ナビ】

複数人でTerraformを触り始めると、真っ先にぶつかるのが「並列作業を前提にした運用ルールが決まっていない」という問題です。たとえば、stateファイルが1つしかないのにメンバーが同時にterraform planを実行してロックがかかったり、ブランチ名が人によってバラバラで誰のPRを先にマージすべきか迷ったり、いつの間にか本番環境で手動変更が行われてドリフトが発生したりします。

特に最近はGitHub ActionsでIaCを自動化するのが一般的ですが、ワークフローのジョブ分割を丁寧にしておかないと、planだけで15分以上待たされる重たいCI/CDになってしまいがちです。CI/CD自体の設計負債はGitHub Actionsの肥大化を防ぐCI/CD設計パターンで整理した通りですが、IaCではstateロックや順序保証といった特有の注意点も加わってきます。

チーム開発でよく遭遇する代表的な悩みには次のようなものがあります。

  • 同じstateに対するterraform plan/apply衝突によるロックエラー
  • 環境(dev/stg/prd)の差分が把握できず、本番だけドリフトが累積する
  • PRレビュー観点が共有されておらず、危険な変更が承認されてしまう
  • 手動コンソール操作が後追いコミットされず、コードと現実が乖離する

こうしたトラブルはTerraformというツールのせいではなく、ブランチ運用やCIでの役割分担が決まっていないことが原因です。仕組みで防ぐガードレールをしっかり作っていきましょう。

IT女子 アラ美IT女子 アラ美
planがコケるたびに「お前またapplyした?」って犯人探し始まるの、もうやめたいんだけど…。

ITアライグマITアライグマ
わかります。stateロック衝突は設計の問題なので、犯人ではなく仕組みを直すのが正解です。

Terraform運用に必要な前提条件(リモートstateとOIDC連携)

本記事で想定する読者は、AWS / Azure / GCP のいずれかでTerraformを2〜10名規模のチームで運用しているインフラエンジニア・SRE・PjMです。Terraform v1.6以上、リモートstate(S3+DynamoDB / AzureRM / GCS)、GitHub ActionsのOIDC連携が利用できる前提で進めます。これらが揃っていない場合は、まずローカルstateからリモートstateへの移行と、IAM Role / Service Principalの整備を先に済ませてください。

IaCツール選定そのものに迷いがあるチームは、Terraform vs Ansible vs CloudFormationの違い・選定基準・乗り換えコスト徹底比較で整理した通り、宣言的な状態管理+クラウドポータビリティを重視するならTerraformが最も無難な選択肢になります。本記事はTerraformを前提に話を進めます。

チームで導入を進めるにあたって、事前に用意しておきたい環境のチェックリストは次の通りです。

  • Terraform v1.6以上(プロバイダーロックファイルが安定して扱える)
  • S3 / DynamoDBやAzureRM / GCSなどのリモートstateバックエンド
  • GitHub Actions側のOIDCで一時クレデンシャル発行(長期キーをSecretsに置かない)
  • 環境ごとに分離されたIAM RoleまたはService Principal(最小権限原則)
  • 本番applyを実行できるユーザー / Teamの定義(CODEOWNERSやenvironment protection rules)

これらが準備できていれば、今回のブランチ戦略とPRレビュー設計をスムーズにそのまま取り入れられます。もし抜けている部分があれば、まずはリモートstateの導入や環境分離から手をつけていくのが安全です。

IT女子 アラ美IT女子 アラ美
リモートstateにDynamoDBのロックテーブル作るの忘れて、初日からみんなで上書き合戦した思い出ある…。

ITアライグマITアライグマ
あるあるです。DynamoDBロックは最小コストで導入できるので、最優先で入れておきましょう。

環境別ディレクトリ分離とPR時terraform plan自動化の基本設計

最初に固めるべきは「環境ごとのディレクトリ分離」「ブランチ命名規則」「PR時に必ず動くterraform planワークフロー」の3点です。実際のプロジェクトで迷わないよう、具体的な設定例を見ながら順番に決めていきましょう。

ディレクトリ構成は、環境ごとにstateとtfvarsを分け、共通モジュールはmodules/配下にまとめるのが最もシンプルでトラブルが起きにくい構成です。


infra/
├── environments/
│   ├── dev/
│   │   ├── main.tf
│   │   ├── backend.tf
│   │   └── terraform.tfvars
│   ├── stg/
│   │   └── ...
│   └── prd/
│       └── ...
├── modules/
│   ├── network/
│   ├── compute/
│   └── data/
└── .github/workflows/
    ├── iac-plan.yml
    └── iac-apply.yml

ブランチ命名規則は、変更対象の環境とリソース種別がひと目で分かるようにfeature/<env>/<scope>-<summary>の形を推奨します(例: feature/stg/network-add-subnet)。mainブランチは常に本番(prd)と一致させ、stg / dev はそれぞれのlong-livedブランチに対するPRで反映する運用にすると、planの対象環境がブランチから判別できます。

GitHub Secretsの扱いは、IaC運用では特に厳格にしたい部分です。長期シークレットを直接Secretsに置くのではなく、OIDC連携で短期トークンを取得する構成にしてください。

PR時に動かすiac-plan.ymlの最小構成は次のようになります。


name: iac-plan
on:
  pull_request:
    paths:
      - "infra/**"
permissions:
  id-token: write
  contents: read
  pull-requests: write
jobs:
  plan:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        env: [dev, stg, prd]
    steps:
      - uses: actions/checkout@v4
      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/gha-iac-${{ matrix.env }}
          aws-region: ap-northeast-1
      - uses: hashicorp/setup-terraform@v3
      - run: terraform init
        working-directory: infra/environments/${{ matrix.env }}
      - run: terraform plan -no-color -out=tfplan
        working-directory: infra/environments/${{ matrix.env }}

このワークフローはPRに含まれるパスがinfra/**の場合のみ走り、3環境のplanを並列実行します。OIDCで環境ごとのRoleをAssumeする構成なので、長期シークレットは一切使いません。planの結果は次のステップ2でPRコメントに自動投稿する形に拡張します。

IT女子 アラ美IT女子 アラ美
環境ごとにディレクトリ切るのめんどくさいって言う人いるけど、stateを混ぜたら絶対に後悔するわよね…。

ITアライグマITアライグマ
同感です。stateを混ぜると本番だけ巻き戻したい時に詰みます。最初から分けておくのが鉄則です。

PRコメント自動連携・ドリフト検知・本番apply承認の実践パターン

基本のplanワークフローが動くようになったら、次は「PRコメントへのplan結果投稿」「ドリフト検知の定期実行」「本番applyの承認フロー」を順に積み上げます。これによってレビュー負荷を抑えつつ、ドリフト・不正applyを検知できる体制になります。

PRコメントへのplan結果投稿は、レビュアーが差分をPR上で確認できるようにする仕組みです。hashicorp/setup-terraformのラッパーアクションやgithub-scriptを使い、terraform planの出力をMarkdownでactions/github-scriptからPRにコメントします。差分が長い場合は<details>タグで折りたたみ、No changesの場合はコメントを省略するとPRが見やすくなります。

ドリフト検知はnightly cronで全環境のterraform planを実行し、差分が検出された場合のみSlack通知+GitHub Issueを自動起票する構成が現実的です。手動コンソール操作はゼロにできない以上、検知の仕組みを入れておくと「気づかないうちに本番だけドリフトする」状態を防げます。Secrets経由で漏れた認証情報が悪用された場合の検知体制は、GitHubにシークレットを混入させない多層防御ガイドでカバーした多層防御と合わせて整備すると安心です。

本番applyの承認フローは、GitHub Actionsのenvironment機能とprotection rulesを組み合わせます。prd環境のapplyジョブをenvironment: productionに紐付け、必須レビュアー2名・待機時間5分などのルールを設定すると、人間の二重チェックなしには本番applyが走らない構成になります。

このセクションで押さえておきたい大切なポイントをまとめると、以下のようになります。

  • plan結果はPRコメントに自動投稿し、レビュアーが差分のみを見て判断できるようにする
  • ドリフト検知はnightly cronで全環境を回し、差分のみSlack通知+Issue起票
  • 本番applyはGitHub Environmentsのprotection rulesで必須レビュアーと待機時間を設定する
  • OPA / Conftestでpolicy as codeを導入し、危険なリソース変更を自動ブロックする
  • applyログはCloudWatch / Cloud LoggingやS3に集約し、いつ誰が何を変えたかを監査可能にする

特にPolicy as Codeは、s3:PublicAccessBlockの解除やセキュリティグループの全開放、本番DBのprevent_destroy解除といった、人間が見落としがちなミスをCIが自動で弾いてくれるので、チームの人数が増えるほど導入するメリットが大きいです。

セキュリティグループのSSH許可を手で絞りすぎて、自分たちがEC2に入れなくなる事故も、コード化とPRレビューで減らせます。それでも繋がらなくなったときの切り分けは、EC2にSSH接続できない原因と対処法にエラーメッセージ別にまとめています。

IT女子 アラ美IT女子 アラ美
applyの承認フロー入れたら、深夜に「お願いだから今すぐapproveして」って連絡来るようになったんだけど…。

ITアライグマITアライグマ
あるあるですね。承認フローと同時に「日中以外applyしない運用ルール」もセットで作ると平和になります。

stateロック衝突とPR滞留を減らすブランチ戦略の進め方の例

IT女子 アラ美IT女子 アラ美
💡 IaC経験で年収300万円アップを狙いなさい!
ハイクラス特化のTechGoは完全無料・3分の年収診断で逆スカウトが届きます
ITエンジニアのハイクラス転職なら【TechGo(テックゴー)】

10名ほどのSREチームが、数百個のAWSリソースをTerraformで管理している場面を例に、ブランチ戦略と環境分離を入れる順番を整理します。

よくある状態

  • 環境(dev/stg/prd)が1つのstateにまとまっていて、terraform planに時間がかかる
  • ブランチの名前がメンバーごとにばらばらで、どのPRを先にレビューすべきか判断できない
  • 本番のapplyを「Slackで一声かけて手で実行」していて、ドリフトが起きやすい
  • planの衝突によるやり直しや調整に時間を取られ、本来のインフラ改善に手が回らない

「本番で手動変更されたリソースを、誰がいつ直したのか追えない」という状態になったら、運用を見直す合図です。

進める順番

  • 環境別のディレクトリ構成へ移行し、肥大化していたstateを3つ(dev/stg/prd)に分割しました
  • ブランチ命名規則をfeature/<env>/<scope>-<summary>に統一し、レビュー観点を環境単位で明確にしました
  • PR時のterraform planをマトリックス実行にし、実行結果が自動でPRコメントに届くようにしました
  • nightly cronによるドリフト検知を導入し、差分を検知したら即座にSlack通知とGitHub Issueが立つようにしました
  • 本番applyはGitHub Environmentsの保護ルールを使い、レビュアー2名の承認と5分の待機時間を必須化しました
  • OPA / Conftestを導入して、セキュリティグループの全開放や本番DBの削除禁止設定の解除を自動で弾くようにしました

「モジュールの参照関係が増えて面倒になる」「PRコメントが増えて見づらい」といった声が出ることもあります。まずは影響の小さいdev環境で試し、効果を確かめてからstg・prdへ広げると進めやすくなります。

効果を確かめる

入れる前と後で、次の項目を記録して比べます。

  • terraform planの待ち時間
  • planの衝突によるやり直しと、その調整にかかった時間
  • ドリフト検知で見つかった差分の件数
  • 新しいメンバーが一人でPRを出せるようになるまでの日数

順番も大切です。stateを分ける前に承認フローだけを入れても、衝突は減りません。環境分離を最初に行ってください。IaC運用設計の経験は、レガシー手動運用から脱却したい多くの企業で求められているスキルセットであり、サーバー基盤の刷新を進める法人案件にもそのまま転用できます。基盤選定そのものに関わるなら、法人向けサーバー・インフラサービス5社比較のような選定軸を持っておくと、IaC運用と地続きで提案できるようになります。

IT女子 アラ美IT女子 アラ美
planの衝突とやり直しの時間が減れば、インフラの改善に手が回るようになりそうね。

ITアライグマITアライグマ
はい。入れる前の待ち時間と調整時間を記録しておけば、効果を数字で示せます。

よくある質問

Q. 2〜3人の小規模チームでも、ここまで本格的なブランチ戦略は必要ですか?

A. 全部入れる必要はありませんが、環境別ディレクトリ分離・リモートstate・PR時のterraform plan自動化の3点は人数に関わらず最初から導入をおすすめします。これだけでstateロック衝突とドリフトの大半は防げます。承認フロー・Policy as Codeは5名超えくらいから検討で十分です。

Q. terraform planの結果をPRコメントに自動投稿する具体的な方法は?

A. hashicorp/setup-terraform@v3の組み込み機能で出力を取得し、actions/github-scriptでPR本文にコメント投稿する構成が一般的です。差分が長くなりやすいので、<details>タグで折りたたみ・No changes時はコメントをスキップする処理を入れると、PR画面が見やすくなります。

Q. ドリフト検知でドリフトが見つかった場合、自動でTerraformコードに反映してもいいですか?

A. 自動反映は推奨しません。ドリフトの多くは「コンソールで一時対応した結果」であり、根本原因の調査前にコード反映すると、本来戻すべき変更を正規化してしまう恐れがあります。検知→Issue起票→人間がレビュー→コード反映 or ロールバック、という流れに留めるのが安全です。

Q. GitHub ActionsではなくGitLab CIやCircleCIを使っている場合でも同じ設計は適用できますか?

A. 適用できます。OIDC連携・環境別ジョブのマトリックス実行・承認フローはどのCI/CDサービスでも実装可能です。本記事のYAML例はGitHub Actions形式ですが、概念(環境分離・PR時plan・本番apply承認)はそのまま他のCI/CDに移植できます。

Q. 既存のmonolithic stateから環境別stateへ分割する場合、ダウンタイムは発生しますか?

A. terraform state mvまたはterraform state rm + terraform importで論理的に分割するだけならダウンタイムは発生しません。ただしバックエンド設定の切り替えで一時的にstateが2系統存在する瞬間があるため、メンバー全員に作業時間を周知し、その間は他のapplyを止める運用が必要です。

IT女子 アラ美IT女子 アラ美
FAQ読んでて思ったけど、小規模チームほど「最初の設計」をサボると後で痛い目見るんだよね…。

ITアライグマITアライグマ
はい。少人数のうちに環境分離とリモートstateを入れておけば、人数が増えても運用が破綻しません。

さらなる発展:stateモジュール分割とAtlantis導入の判断基準

ブランチ戦略が安定したあとに次に取り組みたいのは、「stateモジュール分割」「Atlantis / Spaceliftの導入判断」「IaC運用経験のキャリアへの転換」の3点です。実際の開発現場での優先度を見ながら、一つずつ見ていきましょう。

stateモジュール分割は、リソースが500を超えてからplan時間が再び肥大化するタイミングで検討します。network・compute・data・securityのように責務単位でstateを分け、各stateごとにバージョン管理する形にすると、影響範囲が局所化されてレビューも楽になります。ただし最初から細かく分けすぎると、依存解決の手間でかえって運用負荷が上がるため、痛みを感じてから分割するくらいの方が現実的です。

Atlantis / Spaceliftの導入は、PRコメント駆動のterraform plan / applyを専用基盤に任せる選択肢です。GitHub Actionsで自前構築するよりUIが洗練されており、複数stateの依存関係も可視化できます。ただし月数万円〜のコストがかかるため、チーム規模・state数・運用人件費を計算して比較する必要があります。社内向けに本気のIaCプラットフォームを構築する段階で初めて検討に値する選択肢です。

IaC運用経験のキャリア転換は、本記事の読者にとって意外に大きなテーマです。Terraform / GitHub ActionsでマルチアカウントAWSを安定運用できるエンジニアは、社内SE・SRE・プラットフォームエンジニアいずれの求人でも引く手あまたで、レガシー手動運用から脱却したい企業の指名買いが起きやすい層です。社内SE転職市場での具体的な動き方は社内SEになるには?転職エージェント比較とキャリア設計ガイドで整理しているので、IaC運用設計の主導経験がある方は一度市場価値を測ってみる価値があります。年収重視で動くならエンジニアのハイクラス転職エージェント3社比較を、ハイクラス特化型のエージェントを横並びで見比べると判断が早くなります。

ここで、レガシー手動運用からIaC運用への転換を進めたいエンジニア向けに、キャリアチェンジを支援するエージェントを比較した一覧を用意しました。「SES脱出」「SIer→Web系」「レガシー環境からの転換」のいずれかに当てはまる方は、まず自分の市場価値を匿名でチェックしてから動くのが最短ルートです。

SES・SIerから自社開発企業へのキャリアチェンジや、年収アップを目指すなら、IT経験者向けの転職エージェントを活用しましょう。

比較項目 ユニゾンキャリア TechClipsエージェント レバテックキャリア
年収アップ実績 100万円単位のUP事例年収交渉に強い 9割以上が年収UP離職ゼロ実績 IT専門の条件交渉大手の安心感
求人の特徴 ◎優良企業を厳選 ◎自社開発企業特化 ◎SaaS・Web系豊富
カウンセリング ◎Google★4.8の高評価 ◎現役エンジニア対応 ◯専任アドバイザー
おすすめ度 S年収UPなら必須 A自社開発狙いなら A幅広く探すなら
公式サイト 無料相談する - -
IT女子 アラ美IT女子 アラ美
SESから自社開発に転職したいんですが、年収も下げたくないです…
ITアライグマITアライグマ
ユニゾンキャリアは年収交渉にめちゃくちゃ強いのでおすすめ!自社開発企業に絞りたいならTechClipsエージェントも鉄板ですよ。

まとめ

複数人でTerraformを運用する際の悩みの大半は、ツールの使い方ではなく「並列開発を前提にした設計が抜けている」ことが原因です。本記事で紹介した環境分離・ブランチ命名規則・PR時terraform plan自動化の3点を最初に固め、そのうえでドリフト検知・本番apply承認フロー・Policy as Codeを段階的に積み上げていけば、stateの衝突や本番事故に取られていた時間を減らしていけます。

明日からの一歩として、まずは次のどれか1つから着手してみてください。

  • 環境別ディレクトリへの分離とリモートstateの導入(最優先)
  • ブランチ命名規則feature/<env>/<scope>-<summary>の統一
  • PR時のterraform plan自動実行ワークフロー作成
  • nightly cronによるドリフト検知Issue起票の仕組み化
  • 本番applyのGitHub Environments protection rules設定

IaCの運用設計はチーム全体の開発スピードを上げるだけでなく、手動運用に困っている現場から頼りにされる貴重なスキルになります。ぜひできるところから少しずつ仕組みを整えて、快適なチーム開発環境を作っていきましょう!

IT女子 アラ美IT女子 アラ美
結局、Terraform運用って「ツール選び」じゃなくて「仕組み作り」が本体なんだね。納得した。

ITアライグマITアライグマ
はい。ツールはあくまで土台で、安定運用を左右するのは設計です。今日から1つずつ整えていきましょう。

厳しめIT女子 アラ美による解説ショート動画はこちら

この記事をシェアする
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

ITアライグマのアバター ITアライグマ ITエンジニア / PM

都内の事業会社で働くPM兼Webエンジニアです(IT業界10年以上、既婚・子持ち)。
スマホや決済アプリ、Wi-Fi、スマートスピーカーなど、身近なITの「困った」を、公式のヘルプやサポート情報で確かめたうえで、原因の切り分けから直し方までまとめています。設定で直らないときは、回線やサービスの見直しも含めて紹介しています。

目次