https://blog.plzhans.com/ja/categories/devops/Recent content in Devops on plzhans blogHugojaSun, 30 Aug 2026 01:20:00 +0000https://blog.plzhans.com/ja/posts/103-terraform-practical-guide-aws-sso-assumerole-state-backend/Wed, 06 May 2026 13:52:00 +0000https://blog.plzhans.com/ja/posts/103-terraform-practical-guide-aws-sso-assumerole-state-backend/<p><picture> <source srcset="https://blog.plzhans.com/posts/103-terraform-practical-guide-aws-sso-assumerole-state-backend/assets/1_38322a0f-7e83-804b-a963-f4d395ba7a9c_hu_44eac8c373d362af.webp" type="image/webp"> <img src="https://blog.plzhans.com/posts/103-terraform-practical-guide-aws-sso-assumerole-state-backend/assets/1_38322a0f-7e83-804b-a963-f4d395ba7a9c_hu_4b9c6c2e39371448.png" alt="Terraformでインフラをコードとして宣言し、AWS認証情報とリモートstateを構成して運用する流れを表したカバー画像" width="1200" height="670" loading="eager" fetchpriority="high"> </picture></p> <h2 id="概要">概要</h2> <p>Terraform は HCL でインフラを宣言し、<code>plan</code> と <code>apply</code> で変更を適用する IaC ツールです。チーム単位の運用では、**リモートステート（remote state）**と <strong>AssumeRole ベースの資格情報</strong>を組み合わせて構成するパターンが一般的です。</p> <h3 id="terraform-とは">Terraform とは？</h3> <ul> <li>サーバー、ネットワーク、権限などのインフラをコード（HCL）で宣言し、同じ方法で再現します</li> <li><code>plan</code> で変更内容を事前に確認し、<code>apply</code> で実際のリソースを作成・変更します</li> <li>state ファイルで「現在のインフラの状態」を追跡し、コードと実際のリソースの差分を管理します</li> </ul> <blockquote> <p>:white_check_mark: 推奨フローは init → fmt → validate → plan → apply の順番です。</p> </blockquote> <hr> <h2 id="インストール">インストール</h2> <h3 id="macos">macOS</h3> <ul> <li>Homebrew の確認: <code>brew --version</code></li> <li>Terraform のインストール <ul> <li><code>brew tap hashicorp/tap</code></li> <li><code>brew install hashicorp/tap/terraform</code></li> </ul> </li> <li>インストール確認: <code>terraform version</code></li> <li>オートコンプリート（任意）: <code>terraform -install-autocomplete</code></li> </ul> <h3 id="linux">Linux</h3> <p>ディストリビューションパッケージのインストールまたはバイナリインストールのいずれかを選択します。</p> <details> <summary>Ubuntu / Debian パッケージインストール</summary> <ul> <li><code>sudo apt-get update</code></li> <li><code>sudo apt-get install -y gnupg software-properties-common</code></li> <li><code>wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor | sudo tee /usr/share/keyrings/hashicorp-archive-keyring.gpg &gt;/dev/null</code></li> <li><code>echo &quot;deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main&quot; | sudo tee /etc/apt/sources.list.d/hashicorp.list</code></li> <li><code>sudo apt-get update &amp;&amp; sudo apt-get install -y terraform</code></li> <li>インストール確認: <code>terraform version</code></li> </ul> </details> <details> <summary>バイナリインストール</summary> <ul> <li><a href="https://developer.hashicorp.com/terraform/downloads" target="_blank" rel="noopener noreferrer">https://developer.hashicorp.com/terraform/downloads</a> から Linux amd64 または arm64 をダウンロード</li> <li>解凍後 PATH に配置: <code>sudo install terraform /usr/local/bin/terraform</code></li> <li>インストール確認: <code>terraform version</code></li> </ul> </details> <h3 id="windows">Windows</h3> <details> <summary>winget</summary> <ul> <li>PowerShell を管理者権限で実行</li> <li><code>winget install Hashicorp.Terraform</code></li> </ul> </details> <details> <summary>Chocolatey</summary> <ul> <li><code>choco install terraform</code></li> </ul> </details> <details> <summary>手動インストール</summary> <ul> <li><a href="https://developer.hashicorp.com/terraform/downloads" target="_blank" rel="noopener noreferrer">https://developer.hashicorp.com/terraform/downloads</a> から Windows amd64 zip をダウンロード</li> <li>terraform.exe を任意のフォルダに配置し、そのフォルダを PATH に追加</li> <li>インストール確認: <code>terraform version</code></li> </ul> </details> <hr> <h2 id="基本的な使い方の流れコマンドベース">基本的な使い方の流れ（コマンドベース）</h2> <h3 id="1-プロジェクトの初期化">1) プロジェクトの初期化</h3> <ul> <li><code>terraform init</code></li> </ul> <p>provider プラグインと backend 構成を初期化します。</p>