Jeffallan/claude-skills / skills/terraform-engineer
terraform-engineer
FlaggedUse when implementing infrastructure as code with Terraform across AWS, Azure, or GCP. Invoke for module development (create reusable modules, manage module versioning), state management (migrate backends, import existing resources, resolve state conflicts), provider configuration, multi-environment workflows, and infrastructure testing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.5 KB |
| references/best-practices.md | markdown | 13.3 KB |
| references/module-patterns.md | markdown | 6.0 KB |
| references/providers.md | markdown | 10.6 KB |
| references/state-management.md | markdown | 9.0 KB |
| references/testing.md | markdown | 11.6 KB |
references/providers.md
View on GitHub# Terraform Provider Configuration
## AWS Provider
**Basic Configuration**
```hcl
terraform {
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 6.0"
}
}
}
provider "aws" {
region = var.aws_region
default_tags {
tags = {
Environment = var.environment
ManagedBy = "Terraform"
Project = var.project_name
}
}
}
```
**Multiple AWS Accounts/Regions**
```hcl
provider "aws" {
alias = "primary"
region = "us-east-1"
assume_role {
role_arn = "arn:aws:iam::123456789012:role/TerraformRole"
session_name = "terraform-session"
}
}
provider "aws" {
alias = "secondary"
region = "us-west-2"
assume_role {
role_arn = "arn:aws:iam::987654321098:role/TerraformRole"
}
}
# Use aliased provider
resource "aws_vpc" "primary" {
provider = aws.primary
cidr_block = "10.0.0.0/16"
}
resource "aws_vpc" "secondary" {
provider = aws.secondary
cidr_block = "10.1.0.0/16"
}
```
**AWS Authentication Methods**
```hcl
# Method 1: Short-lived credentials from the environment (recommended for CI/CD)
# Prefer OIDC federation (for example GitHub Actions -> IAM role) so that no
# long-lived keys exist; the workflow exports temporary AWS_ACCESS_KEY_ID,
# AWS_SECRET_ACCESS_KEY and AWS_SESSION_TOKEN
# Method 2: Shared credentials file
provider "aws" {
region = "us-east-1"
shared_credentials_files = ["~/.aws/credentials"]
profile = "production"
}
# Method 3: IAM role (recommended for EC2/ECS)
provider "aws" {
region = "us-east-1"
# Automatically uses instance profile
}
# Method 4: Assume role
provider "aws" {
region = "us-east-1"
assume_role {
role_arn = var.terraform_role_arn
session_name = "terraform-${var.environment}"
external_id = var.external_id
}
}
```
**AWS Provider Features**
```hcl
provider "aws" {
region = "us-east-1"
# Default tags applied to all resources
default_tags {
tags = {
Environment = "production"
ManagedBy = "Terraform"
CostCenter = "engineering"
}
}
# Ignore specific tags (useful for auto-scaling)
ignore_tags {
keys = ["aws:autoscaling:groupName"]
}
# Custom endpoint for localstack/testing
endpoints {
s3 = "http://localhost:4566"
ec2 = "http://localhost:4566"
}
# Rate limiting
max_retries = 3
# HTTP proxy
http_proxy = "http://proxy.example.com:8080"
}
```
## Azure Provider (azurerm)
**Basic Configuration**
```hcl
terraform {
required_providers {
azurerm = {
source = "hashicorp/azurerm"
version = "~> 5.0"
}
}
}
provider "azurerm" {
features {
resource_group {
prevent_deletion_if_contains_resources = true
}
key_vault {
purge_soft_delete_on_destroy = false
recover_soft_deleted_key_vaults = true
}
virtual_machine {
delete_os_disk_on_deletion = true
graceful_shutdown = false
skip_shutdown_and_force_delete = false
}
}
# Always set the subscription explicitly (or via ARM_SUBSCRIPTION_ID)
subscription_id = var.subscription_id
tenant_id = var.tenant_id
}
```
**Multiple Azure Subscriptions**
```hcl
provider "azurerm" {
alias = "production"
subscription_id = var.prod_subscription_id
tenant_id = var.tenant_id
features {}
}
provider "azurerm" {
alias = "development"
subscription_id = var.dev_subscription_id
tenant_id = var.tenant_id
features {}
}
resource "azurerm_resource_group" "prod" {
provider = azurerm.production
name = "prod-rg"
location = "East US"
}
```
**Azure Authentication Methods**
```hcl
# Method 1: OIDC / workload identity federation (recommended for CI/CD)
# No stored secret; the pipeline supplies the token.
provider "azurerm" {
features {}
use_oidc = true
subscription_id = var.subscription_id
tenant_id = var.tenant_id
client_id = var.client_id
}
# Method 2: Service Principal with Client Secret (avoid; prefer OIDC)
# Pass the secret via the ARM_CLIENT_SECRET environment variable rather than a
# Terraform variable, so it never lands in state or plan files.
provider "azurerm" {
features {}
subscription_id = var.subscription_id
tenant_id = var.tenant_id
client_id = var.client_id
}
# Method 2b: Service Principal with Certificate
provider "azurerm" {
features {}
subscription_id = var.subscription_id
tenant_id = var.tenant_id
client_id = var.client_id
client_certificate_path = var.client_certificate_path
client_certificate_password = var.client_certificate_password
}
# Method 3: Managed Identity (for Azure VMs)
provider "azurerm" {
features {}
use_msi = true
client_id = var.client_id # only for a user-assigned identity
subscription_id = var.subscription_id
tenant_id = var.tenant_id
}
# Method 4: Azure CLI (local development)
provider "azurerm" {
features {}
use_cli = true
subscription_id = var.subscription_id
}
```
## GCP Provider
**Basic Configuration**
```hcl
terraform {
required_providers {
google = {
source = "hashicorp/google"
version = "~> 8.0"
}
}
}
provider "google" {
project = var.project_id
region = var.region
zone = var.zone
default_labels = {
environment = var.environment
managed_by = "terraform"
}
}
```
**Multiple GCP Projects**
```hcl
provider "google" {
alias = "production"
project = var.prod_project_id
region = "us-central1"
}
provider "google" {
alias = "development"
project = var.dev_project_id
region = "us-central1"
}
resource "google_compute_network" "prod" {
provider = google.production
name = "prod-vpc"
}
```
**GCP Authentication Methods**
```hcl
# Method 1: Service Account Key (avoid; long-lived key material)
# Keep the key file outside the repository and pass its path via the
# GOOGLE_APPLICATION_CREDENTIALS environment variable instead of file().
# Method 2: Application Default Credentials (recommended)
# Locally: gcloud auth application-default login
# CI/CD: Workload Identity Federation, no key file required
provider "google" {
project = var.project_id
region = var.region
}
# Method 3: Impersonate Service Account
provider "google" {
project = var.project_id
region = var.region
impersonate_service_account = "terraform@project-id.iam.gserviceaccount.com"
scopes = [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/userinfo.email"
]
}
# Method 4: Workload Identity (for GKE)
provider "google" {
project = var.project_id
region = var.region
# Automatically uses workload identity
}
```
**GCP Beta Resources**
```hcl
terraform {
required_providers {
google = {
source = "hashicorp/google"
version = "~> 8.0"
}
google-beta = {
source = "hashicorp/google-beta"
version = "~> 8.0"
}
}
}
provider "google-beta" {
project = var.project_id
region = var.region
}
# Use beta provider for features not in stable
resource "google_compute_security_policy" "policy" {
provider = google-beta
name = "my-policy"
# Beta-only features here
}
```
## Kubernetes Provider
Use an `exec` credential plugin so that a fresh short-lived token is fetched on
every run. Reading a token from a data source (for example
`aws_eks_cluster_auth`) stores it in state.
**With AWS EKS**
```hcl
data "aws_eks_cluster" "cluster" {
name = module.eks.cluster_name
}
provider "kubernetes" {
host = data.aws_eks_cluster.cluster.endpoint
cluster_ca_certificate = base64decode(data.aws_eks_cluster.cluster.certificate_authority[0].data)
exec = {
api_version = "client.authentication.k8s.io/v1beta1"
command = "aws"
args = ["eks", "get-token", "--cluster-name", module.eks.cluster_name]
}
}
```
**With GKE**
```hcl
data "google_client_config" "default" {}
data "google_container_cluster" "cluster" {
name = var.cluster_name
location = var.region
}
provider "kubernetes" {
host = "https://${data.google_container_cluster.cluster.endpoint}"
token = data.google_client_config.default.access_token
cluster_ca_certificate = base64decode(
data.google_container_cluster.cluster.master_auth[0].cluster_ca_certificate
)
}
```
## Helm Provider
Helm provider 3.x changed block syntax to attribute syntax: `kubernetes = { ... }`
on the provider and `set = [ ... ]` on `helm_release`. The 2.x nested blocks
(`kubernetes { }`, `set { }`) no longer validate.
```hcl
provider "helm" {
kubernetes = {
host = data.aws_eks_cluster.cluster.endpoint
cluster_ca_certificate = base64decode(data.aws_eks_cluster.cluster.certificate_authority[0].data)
exec = {
api_version = "client.authentication.k8s.io/v1beta1"
command = "aws"
args = ["eks", "get-token", "--cluster-name", module.eks.cluster_name]
}
}
}
resource "helm_release" "nginx" {
name = "nginx-ingress"
repository = "https://kubernetes.github.io/ingress-nginx"
chart = "ingress-nginx"
version = "4.8.0"
values = [
file("${path.module}/values.yaml")
]
set = [
{
name = "controller.service.type"
value = "LoadBalancer"
}
]
}
```
## Provider Version Constraints
```hcl
terraform {
required_version = ">= 1.14"
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 6.0" # >= 6.0.0, < 7.0.0
}
azurerm = {
source = "hashicorp/azurerm"
version = "~> 5.0"
}
google = {
source = "hashicorp/google"
version = "~> 8.0"
}
kubernetes = {
source = "hashicorp/kubernetes"
version = "~> 3.0"
}
helm = {
source = "hashicorp/helm"
version = "~> 3.0"
}
random = {
source = "hashicorp/random"
version = "~> 3.7"
}
}
}
```
Use the latest major of each provider unless the lock file or another module
constrains it. Provider majors move quickly, so check the registry before pinning,
and read the upgrade guide before crossing a major version (for example, azurerm 4
to 5). Commit `.terraform.lock.hcl`; refresh it with `terraform init -upgrade`.
## Best Practices
- Always pin provider versions with constraints
- Use provider aliases for multi-region/account setups
- Leverage default tags for consistent resource tagging
- Use environment variables for credentials (CI/CD)
- Use IAM roles/managed identities when possible
- Never hardcode credentials in code
- Use separate providers for different environments
- Document provider requirements in README
- Test provider upgrades in non-production first
- Use official providers from HashiCorp registry
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |