terraform-upgrade-assistant

Terraform Upgrade Assistant

This skill helps safely upgrade Terraform and provider versions.

When to Use

Use this skill when:

• Upgrading Terraform CLI version
• Updating provider versions
• Fixing deprecated syntax warnings
• Migrating to new provider features
• Preparing for major version upgrades

Upgrade Process

1. Check Current Versions

# Check Terraform version
terraform version

# Check provider versions in use
terraform providers

# Check for available updates
terraform init -upgrade

2. Review Upgrade Guides

Before upgrading, review:

• Terraform Upgrade Guides
• Provider changelog (e.g., AWS provider releases)
• Breaking changes documentation

3. Upgrade Strategy

Incremental approach (recommended):

1. Upgrade one minor version at a time
2. Test thoroughly between upgrades
3. Fix deprecation warnings before major upgrades

Example path: 1.0 → 1.1 → 1.2 → 1.3 → 1.4 → 1.5

4. Update Version Constraints

# Before
terraform {
  required_version = ">= 1.0"
  
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 4.0"
    }
  }
}

# After
terraform {
  required_version = ">= 1.5"
  
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

Handling Deprecation Warnings

Identify Warnings

# Run plan to see warnings
terraform plan

# Example output:
# Warning: Argument is deprecated
#   Use aws_s3_bucket_acl resource instead

Upgrade Checklist

Pre-Upgrade

• Backup state file
• Review upgrade guides for target version
• Check provider changelogs
• Test in non-production environment first
• Ensure team is aware of upgrade

During Upgrade

• Update version constraints in code
• Run terraform init -upgrade
• Run terraform plan and review changes
• Fix any deprecation warnings
• Update CI/CD pipelines with new version