LT_TerragruntでAWS環境を構築してみた_20250220

JAWSのイベントでLTした内容

Transcript

1. TerragruntでAWS環境を構 築してみた 
 e-dash株式会社 kohekohe 2025年2月20日 ENGINEER LIGHTNING TALK @kohekohe1221
2. 佐藤幸平（こへこへ） @kohekohe1221 所属：e-dash株式会社 役割：SRE‧EM 出⾝：埼⽟県 趣味：旅⾏‧お酒 ⾃⼰紹介 ABOUT ME 2 ※本⽇の登壇資料はXにて公開します！
3. ⬅本日の登壇資料はXにて公開 • TerragruntというTerraformをラッパーしたツールを導⼊した感想を話 します。 • Terraformをある程度理解している前提で話します。 • AWSで環境を構築する想定で話します。 • ソースコードは弊社独⾃の運⽤で⽣まれたものなので、ベストプラク ティスかどうかは不明です。 LTの概要‧注意点 3
4. ⬅本日の登壇資料はXにて公開 会社について ABOUT e-dash 4 • 企業のCO2排出量可視化‧削減のSaaSを開発 • 三井物産出資のスタートアップ • 2022年設⽴‧本社は⾚坂⾒附付近 • ソフトウェアエンジニア絶賛募集中です
5. ⬅本日の登壇資料はXにて公開 • Gruntwork社がメンテしているTerraformをラッパーしたツール。 • より簡単‧簡素にTerraformを使ったIaCを運⽤することができる。 • 基本的には.tfファイルを使ってインフラを記述することはTerraformと 同じ。 • Terraform運⽤時の難点を解消することができるかも。 Terragruntって何？ 5
6. ⬅本日の登壇資料はXにて公開 Terraformは強⼒なIaCツールですが、不便だと感じる点がいくつか、、、 1. 複数環境の設定ファイルの管理が煩雑 2. Stateファイルの分割が⾯倒 3. Stateを格納するS3バケットを⼿動で作成しないといけない 4. terraform initを適宜実⾏しないといけない Terragruntを使えば、これらの難点が解消するかも？！ Terraformの難点 6
7. ⬅本日の登壇資料はXにて公開 弊社ではWorkspaceは使わずに 環境ごとにディレクトリを切っ てTerraformを運⽤。 ⇩ 各環境ごとにmain.tfを⽤意しな いといけない。 Terraformの難点：複数環境の設定ファイルの管理が煩雑 7 ※Terraformでの構築例
8. ⬅本日の登壇資料はXにて公開 モジュール毎にhclと呼ばれる設定ファイルを⽤意 ⇩ 設定ファイル数は増えているが、「ほぼコピペで 済む＆変更の頻度は少ない」 のでメンテナンスコ ストは下がる ※⼦hclは親hclを継承できる Terraformの難点：複数環境の設定ファイルの管理が煩雑 8 ※Terragruntでの構築例
9. ⬅本日の登壇資料はXにて公開 locals { environment = "${replace(replace(replace(get_path_from_repo_root(), "environments/", ""), path_relative_to_include(), ""), "/", "")}" variables = read_terragrunt_config(find_in_parent_folders("envs/env_${local.environment}.hcl")) module_name = basename(path_relative_to_include()) } remote_state { backend = "s3" generate = { path = "backend.tf" if_exists = "overwrite_terragrunt" } config = { region = "ap-northeast-1" bucket = "terragrunt-state-sugar-sample-${local.environment}" key = "${path_relative_to_include()}/terraform.tfstate" encrypt = true } } (右に続く...) Terraformの難点：複数環境の設定ファイルの管理が煩雑 9 develop環境⽤の親hclファイルの例 (....左の続き) generate "provider" { path = "provider.tf" if_exists = "overwrite_terragrunt" contents = <<EOF terraform { required_version = "= 1.9.8" required_providers { aws = { source = "hashicorp/aws" version = "5.59.0" } } } EOF } inputs = { variables = local.variables.locals }
10. ⬅本日の登壇資料はXにて公開 locals { environment = "${replace(replace(replace(get_path_from_repo_root(), "environments/", ""), path_relative_to_include(), ""), "/", "")}" variables = read_terragrunt_config(find_in_parent_folders("envs/env_${local.environment}.hcl")) module_name = basename(path_relative_to_include()) } remote_state { backend = "s3" generate = { path = "backend.tf" if_exists = "overwrite_terragrunt" } config = { region = "ap-northeast-1" bucket = "terragrunt-state-sugar-sample-${local.environment}" key = "${path_relative_to_include()}/terraform.tfstate" encrypt = true } } (右に続く...) Terraformの難点：複数環境の設定ファイルの管理が煩雑 10 develop環境⽤の親hclファイルの例 (....左の続き) generate "provider" { path = "provider.tf" if_exists = "overwrite_terragrunt" contents = <<EOF terraform { required_version = "= 1.9.8" required_providers { aws = { source = "hashicorp/aws" version = "5.59.0" } } } EOF } inputs = { variables = local.variables.locals } 環境名をディレクトリから引っ張ってくる パスからモジュール名を取得 環境変数を格納している hclファイルを指 定 inputsが子に引き継がれる tfファイルを生成する
11. ⬅本日の登壇資料はXにて公開 include { path = find_in_parent_folders() } terraform { source = "../../../modules/${path_relative_to_include()}" } Terraformの難点：複数環境の設定ファイルの管理が煩雑 11 S3⽤の⼦hclファイルの例 • inputsが親から引き継がれるので、⼦hcl⽤にわざわざ記述 しなくてよい • これを各モジュールの配下にコピペしていく
12. ⬅本日の登壇資料はXにて公開 Terraformの難点：Stateファイルの分割が⾯倒 12 • プロジェクトが⼤きくなってくるとterraform plan(apply)の実⾏時間 は⻑くなるため、適宜Stateの分割を検討するとよい。 • しかし、terraformではStateの分割は結構めんどくさい。 • Terragruntでは、既述のディレクトリ構成を採⽤するだけで モジュー ル毎にStateファイルを勝⼿に分割してくれる。
13. ⬅本日の登壇資料はXにて公開 • TerraformではStateを格納するS3バケットは⼿動で作成することが推 奨されている。 • Terragruntではterragrunt apply(terraform apply的なコマンド)を実⾏ する際に⾃動でS3バケットを作成してくれる。 Terraformの難点：State格納するS3バケットの⼿動作成 13
14. ⬅本日の登壇資料はXにて公開 Terraformの難点：terraform initの実⾏が都度必要 14 • Terraformではモジュールの新規追加を⾏なった場合は、terraform initを都度実⾏しないといけない。 • Terragruntでは、applyやplanを実⾏する際に裏側でプラグインのダ ウンロードやバックエンドの初期化が⾃動で⾏われる。
15. ⬅本日の登壇資料はXにて公開 Zennで記事を書いたのでより詳しく知りたい⽅はよければアクセスください。 ⼿を動かしてメリットを実感するTerragrunt⼊⾨1~3 https://zenn.dev/edash_tech_blog/articles/2e2482fd27647c https://zenn.dev/edash_tech_blog/articles/ebc1db4195a31d https://zenn.dev/edash_tech_blog/articles/085fe5381b99e2 「e-dash Terragrunt」でググればヒットすると思います。」 最後に 15 e-dash Terragrunt 検索
16. THANK YOU! ENGINEER LIGHTNING TALK kohekohe @kohekohe1221