terraform-infrastructure

Terraform インフラストラクチャ

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

Terraform を使ってスケーラブルな Infrastructure as Code を構築し、宣言型の設定、リモートステート、自動プロビジョニングを通じて、AWS、Azure、GCP、オンプレミスのリソースを管理します。

使用する場面

• クラウドインフラストラクチャのプロビジョニング
• 複数環境の管理（dev、staging、prod）
• インフラストラクチャのバージョン管理とコードレビュー
• コストの追跡とリソースの最適化
• 災害復旧と環境の複製
• インフラストラクチャの自動テスト
• クロスリージョンでのデプロイ

クイックスタート

最小限の実行可能な例：

# terraform/main.tf
terraform {
  required_version = ">= 1.0"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }

  # Remote state configuration
  backend "s3" {
    bucket         = "terraform-state-prod"
    key            = "prod/terraform.tfstate"
    region         = "us-east-1"
    encrypt        = true
    dynamodb_table = "terraform-locks"
  }
}

provider "aws" {
  region = var.aws_region

  default_tags {
// ... (see reference guides for full implementation)

リファレンスガイド

詳細な実装については、references/ ディレクトリを参照してください：

ガイド	内容
AWS インフラストラクチャモジュール	AWS インフラストラクチャモジュール
変数と出力	変数と出力
Terraform デプロイスクリプト	Terraform デプロイスクリプト

ベストプラクティス

✅ 推奨事項

• リモートステートを使用する（S3、Terraform Cloud）
• ステートロックを実装する（DynamoDB）
• コードをモジュールに整理する
• 環境にはワークスペースを使用する
• タグを一貫して適用する
• 柔軟性を高めるために変数を使用する
• apply の前にコードレビューを実施する
• 機密データを別の変数ファイルに保管する

❌ 禁止事項

• ステートファイルをローカルの git に保存する
• ハードコードされた値を使用する
• 1 つのステートで環境を混在させる
• terraform plan のレビューを省略する
• すべてにルートモジュールを使用する
• シークレットをコードに保存する
• ステートロックを無効にする