Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Terraform 0 to 100:100個以上のリポジトリを常に最新にし続けるための自動化

Sponsored · Ship Features Fearlessly Turn features on and off without deploys. Used by thousands of Ruby developers. →
sue445
November 19, 2026

Terraform 0 to 100:100個以上のリポジトリを常に最新にし続けるための自動化

CloudNative Days Winter 2026(https://cloudnativedays.jp/) の発表資料です。

https://cloudnativedays.jp/sessions/3188

sue445

November 19, 2026

Transcript

68 slides
  1. 自己紹介 sue445 シニアテックリード 2 • Go Sueyoshi (a.k.a. sue445, sue-san)

    ◦ https://x.com/sue445 ◦ https://github.com/sue445 ◦ https://gitlab.com/sue445 • ピクシブ株式会社 (2018年〜) ◦ Infrastructure Unit所属 • CloudNative Daysは何回かProposalを出し ていて4回目で初採択🎉
  2. Terraformについて • Terraformは、クラウドなどの構成をコードで管理する Infrastructure as Code (IaC) のツール ◦ https://developer.hashicorp.com/terraform

    • 今でこそピクシブ社内のデファクトスタンダードだが、社内で最初に導入 したのはsue445 16
  3. IaC導入時に比較したもの • CloudFormation (AWS), Deployment Manager (Google Cloud) • 入社時点では、AWSとGoogle

    Cloudの利用率がだいたい同じくらいだっ た • 両方を同じツールとエコシステムで運用した方が楽なので、両方に対応し ているTerraformを採用した(2018年) • 余談:Deployment Managerは2026/3/31にサポート終了になっていて、 今はTerraformベースのInfrastructure Managerへの移行が推奨されてい る 17
  4. 1つ目のTerraformリポジトリでの運用 • Terraformの実行は全てGitLab CIで行っていた ◦ MR(Merge Request, GitHubのPull RequestのGitLab版)で terraform

    plan (dry run)を実行 ◦ MRのマージ後にデフォルトブランチで自動 terraform apply (本実行) ◦ 必要に応じてMRで手動 terraform apply • 1つ目の時点では .gitlab-ci.yml (GitLab CIの設定ファイル)は特に共通化 していなかった 18
  5. terraform-templateで実装した機能 • terraform plan • terraform fmt で差分があった時にエラーにする ◦ MRでも実行することにより、デフォルトブランチには常に整形済のtf

    ファイルが入ることが保証される • MRのマージ後にデフォルトブランチで自動 terraform apply • 必要に応じてMRで手動 terraform apply 22
  6. Setup Terraform for Google Cloud • 当初はDeployment ManagerでTerraformをセットアップしていた • 前述の通りサポート終了したので、同じ処理を

    setup-terraform.sh に書 き直した • 公式はInfrastructure Managerへの移行を推奨してるが採用しなかった のは、Terraformのセットアップのために別のTerraformを使うのが微妙 だったため 31
  7. ピクシブでのGoogle Cloud用の Terraformの初期セットアップ手順 1. Google Cloudプロジェクト開設 2. テンプレートリポジトリを元にTerraformリポジトリを作成 3. テンプレートリポジトリ内に含まれている

    setup-terraform.sh をローカ ルで実行 4. Terraform内のbackendバケットなどのプロジェクト固有の設定修正 5. CIでTerraformが実行できるようになる 32
  8. for GitHub • GitHub派な人はOSS版を使ってください ◦ https://github.com/sue445/terraform-aws-template ◦ https://github.com/sue445/terraform-gcp-template • OSS版をベースに社内版を作っているので、構成はほぼ同じ

    ◦ 違いはGitHub ActionsかGitLab CIかくらい • 前述のCloudFormationのテンプレートファイルや setup-terraform.sh もGitHub版はOSSで公開している 33
  9. Terraform本体を自動でバージョンアッ プする for GitLab • ざっくりとした方針 ◦ バージョンは .terraform-version のようなファイルに書いて、CIでも

    そのバージョンを参照させる ◦ このファイルを更新するだけでバージョンアップできるようにする 37
  10. 補足 • ただしGitLab CIの仕様上 .terraform-version の内容を直接 image で使 うことが難しかった。(できないことはないがjobの構成がちょっと複雑に なる)

    • そのため .terraform-version と TERRAFORM_VERSION の2箇所にバー ジョンを定義しつつ、バージョンアップ時に一緒に書き換えるようにした (後述) 38
  11. Renovateでバージョンアップする • .terraform-version に関しては実はRenovateで対応している ◦ https://docs.renovatebot.com/modules/manager/terraform-versi on/ • しかし社内のTerraformの定期バージョンアップを導入した時期にはまだ Renovateは対応してなかったため、ピクシブでは別の仕組みでバージョ

    ンアップしている ◦ 発表概要に「既存ツールだとTerraform本体のバージョンアップができ なかった」と書いていたのはRenovate対応前に社内導入したため🙏 • 前述の .terraform-version と TERRAFORM_VERSION の2箇所を同時に 更新するのも頑張れば可能 39
  12. 複数リポジトリ版 (for GitLab) • リポジトリが1つなら、そのリポジトリにCIの設定を書けばいい • しかし弊社にはTerraformリポジトリがたくさんあるので、全部に同じ設 定を書いて回るのは大変 ◦ 今ならCoding

    Agentを使えばパッチを量産するコストは下がるが、そ れでも大変 • 設定は1箇所で管理しつつ、複数のリポジトリに terraform-version-updater と create-merge-request を透過的に実行 したい 43
  13. Scheduled pipeline execution policiesとは • 通常のGitLab CIは、.gitlab-ci.yml(かそのinclude先)に設定を書かな いとjobが定義されない ◦ GitHubでいうと、.github/workflows/

    にymlを書かないとjobが定義さ れないのと同じ • この機能を使うと、各リポジトリにjob定義が無くても、Security Policy 側のjobを定期実行できる 47
  14. Scheduled pipeline execution policiesとは • 社内のTerraformリポジトリは基本的に名前が -terraform で終わり、リ ポジトリ内に .terraform-version

    が含まれている ◦ この条件に合う全リポジトリに対して透過的に terraform-version-updater と create-merge-request を実行してい る 48
  15. 1. .terraform-version を hashicorp/setup-terraform でも使う • GitHub ActionsでTerraformを使う時は https://github.com/hashicorp/setup-terraform を使うことが多いと思

    うが、hashicorp/setup-terraform は .terraform-version に対応してい ない ◦ cf. https://github.com/hashicorp/setup-terraform/issues/298 • そのため、後述のような工夫が必要 51
  16. 2. いい感じに .terraform-version を更新す る • 単一リポジトリなら下記のいずれか ◦ https://github.com/sue445/terraform-version-updater +

    https://github.com/peter-evans/create-pull-request ◦ https://docs.renovatebot.com/modules/manager/terraform-versi on/ • 前者の場合、複数リポジトリなら Reusable workflows でworkflowの定 義を集約しておくと楽 ◦ cf. https://docs.github.com/ja/actions/how-tos/reuse-automations/ reuse-workflows 53
  17. for GitHub • https://github.com/sue445/terraform-plan-changes-count • GitHub Actionsで terraform plan の差分件数を取得するAction

    • 個人でもTerraformリポジトリを10個以上メンテしており、手動マージが 大変になったので、自動マージの準備として作った • cf. https://sue445.hatenablog.com/entry/2026/01/04/005312 61
  18. まとめ • ピクシブ社内では100個以上のTerraformリポジトリを運用している • 増えるたびにボトルネックが変わったので、その都度仕組みを足した ◦ 1→10: CI定義の集約 ◦ 10→50:

    リポジトリ作成と、本体・Providerのバージョンアップの自動 化 ◦ 50→100: plan差分が無いMRの自動マージ • 人が見るのは、差分が出たときだけになった 68

More Decks by sue445

Other Decks in Technology