Terraform은 어떻게 현실을 파악하는가: 상태 동기화의 내부 동작

# Terraform이 내부적으로 호출하는 AWS API 예시
DescribeInstances          # EC2 인스턴스 목록 조회
DescribeVpcs               # VPC 목록 조회
DescribeSubnets            # 서브넷 목록 조회
GetBucketLocation          # S3 버킷 조회
DescribeSecurityGroups     # 보안 그룹 조회

{
  "Reservations": [{
    "Instances": [{
      "InstanceId": "i-0abc123def456",
      "InstanceType": "t3.large",      ← 실제 현재 타입
      "State": { "Name": "running" },
      "Tags": [{ "Key": "Name", "Value": "web-server" }]
    }]
  }]
}

$ terraform plan

  ~ aws_instance.web
      instance_type: "t3.large" -> "t3.micro"

Plan: 0 to add, 1 to change, 0 to destroy.

$ terraform plan

Error: No valid credential sources found
│ Please see https://registry.terraform.io/providers/hashicorp/aws
│ for more information about providing credentials.
│
│   with provider["registry.terraform.io/hashicorp/aws"],
│   on main.tf line 1, in terraform:

# 원인 1: AWS 자격증명 미설정
aws configure                          # Access Key, Region 설정

# 원인 2: IAM 권한 부족 (DescribeInstances 등 Read 권한 없음)
aws iam attach-role-policy \
  --role-name terraform-role \
  --policy-arn arn:aws:iam::aws:policy/ReadOnlyAccess

# 원인 3: 프로파일 불일치
export AWS_PROFILE=my-profile
terraform plan

$ terraform apply

Error: Error acquiring the state lock
│
│ Error message: ConditionalCheckFailedException: The conditional request failed
│ Lock Info:
│   ID:        f2ab5f76-1234-5678-abcd-ef1234567890
│   Path:      s3://my-state-bucket/prod/terraform.tfstate
│   Operation: OperationTypeApply
│   Who:       teamA@company.com
│   Created:   2026-06-29 08:45:00 +0000 UTC

# 1. 먼저 실제로 apply가 진행 중인지 확인
terraform force-unlock <LOCK_ID>   # 중단된 프로세스의 Lock 강제 해제

# 주의: apply가 실제로 실행 중일 때 force-unlock은 데이터 손상 위험
# 반드시 Lock을 건 당사자에게 확인 후 사용

$ terraform plan

aws_instance.web: Refreshing state... [id=i-0abc123def456]

│ Error: reading EC2 Instance (i-0abc123def456): couldn't find resource

# Terraform이 삭제된 리소스를 감지하고 재생성 계획을 세웁니다
  + aws_instance.web
      ami:           "ami-0c55b159cbfafe1f0"
      instance_type: "t3.micro"

Plan: 1 to add, 0 to change, 0 to destroy.

# 케이스 1: 재생성이 필요한 경우
terraform apply   # 그냥 apply → 삭제된 리소스 재생성

# 케이스 2: 더 이상 관리가 필요 없는 경우
terraform state rm aws_instance.web   # State에서만 제거 (실제 삭제 아님)

$ terraform plan

│ Error: reading EC2 VPCs: RequestLimitExceeded: Request limit exceeded.
│       status code: 400, request id: 1234abcd-...

# provider 설정에서 재시도 횟수와 병렬 실행 수 제한
provider "aws" {
  region = "ap-northeast-2"

  # 재시도 설정 (기본값: 25)
  max_retries = 10
}

# plan 실행 시 병렬 처리 수 제한 (기본값: 10)
terraform plan -parallelism=5

$ terraform plan

│ Error: State version 4 is not supported
│
│ Your Terraform version is 1.3.0, but the state was written by Terraform 1.6.0.
│ Please upgrade Terraform to use this configuration.

# terraform.tf에 버전 고정
terraform {
  required_version = ">= 1.6.0"   # 최소 버전 강제

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

# tfenv를 사용해 팀 전체가 동일 버전 사용
tfenv install 1.6.5
tfenv use 1.6.5

$ terraform plan

│ Error: reading EC2 Instance (i-0wrongid999): InvalidInstanceID.NotFound:
│ The instance ID 'i-0wrongid999' does not exist

# 1. 현재 State에 기록된 정보 확인
terraform state show aws_instance.web

# 2. 잘못된 리소스를 State에서 제거
terraform state rm aws_instance.web

# 3. 실제 AWS의 올바른 ID로 재import
terraform import aws_instance.web i-0correctid123

# 실제 변경 없이 State만 갱신
$ terraform apply -refresh-only

  ~ aws_instance.web
      instance_type: "t3.micro" -> "t3.large"   ← 누가 콘솔에서 바꿨네요

Do you want to update the Terraform state?
  Only 'yes' will be accepted to confirm.

Enter a value: yes

Apply complete! Resources: 0 added, 0 changed, 0 destroyed.