# Riferimento rapido Terraform

*Provider, risorse, variabili, state, moduli*

> Source: Terraform Documentation (developer.hashicorp.com/terraform) · MIT

## Nozioni di base

### Flusso di lavoro principale

```
terraform init      # install providers & modules
terraform plan      # preview changes
terraform apply     # apply changes
terraform destroy   # tear down all resources
```

### Comandi essenziali

| Command | Description |
|---------|-------------|
| `terraform init` | Inizializza la directory di lavoro, scarica i provider |
| `terraform plan` | Mostra il piano di esecuzione senza applicarlo |
| `terraform apply` | Applica le modifiche all'infrastruttura |
| `terraform destroy` | Elimina tutte le risorse gestite |
| `terraform fmt` | Formatta i file `.tf` secondo lo stile canonico |
| `terraform validate` | Controlla la sintassi della configurazione |
| `terraform show` | Mostra lo stato corrente o il piano |
| `terraform output` | Stampa i valori di output |

## Provider

### Configurazione del provider

```
terraform {
  required_providers {
    aws = { source = "hashicorp/aws", version = "~> 5.0" }
  }
}
provider "aws" {
  region = "us-east-1"
}
```

### Note sui provider

| Command | Description |
|---------|-------------|
| `source` | Indirizzo nel registry (`hashicorp/aws`, `hashicorp/google`) |
| `version` | Vincolo di versione (`~> 5.0`, `>= 3.0, < 4.0`) |
| `.terraform.lock.hcl` | File di lock — da committare nel controllo versione |
| `alias` | Usa più configurazioni per lo stesso provider |

## Risorse

### Blocchi di risorse

```
resource "aws_instance" "web" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
  tags = { Name = "web-server" }
}
```

### Meta-argomenti delle risorse

| Command | Description |
|---------|-------------|
| `depends_on` | Dipendenza esplicita da un'altra risorsa |
| `count` | Crea più istanze (`count = 3`) |
| `for_each` | Crea istanze da una mappa o set |
| `provider` | Seleziona un alias di provider non predefinito |
| `lifecycle` | Personalizza il comportamento di creazione/aggiornamento/distruzione |

### Riferimento alle risorse

```
# type.name.attribute
aws_instance.web.id
aws_instance.web.public_ip
aws_vpc.main.cidr_block
```

## Variabili

### Dichiarazione delle variabili

```
variable "region" {
  type    = string
  default = "us-east-1"
}
variable "instance_count" {
  type        = number
  description = "Number of instances"
}
```

### Impostazione dei valori delle variabili

| Command | Description |
|---------|-------------|
| `-var 'region=us-west-2'` | Flag da riga di comando |
| `-var-file=prod.tfvars` | Carica da un file `.tfvars` |
| `terraform.tfvars` | Caricato automaticamente se presente |
| `TF_VAR_region` | Variabile d'ambiente |
| `Prompt interattivo` | Richiesto durante plan/apply se non c'è default |

### Tipi di variabile

| Command | Description |
|---------|-------------|
| `string` | `"us-east-1"` |
| `number` | `42` |
| `bool` | `true` / `false` |
| `list(string)` | `["a", "b"]` |
| `map(string)` | `{ key = "val" }` |
| `object({...})` | Tipo strutturato con attributi denominati |

## Output

### Definizione degli output

```
output "instance_ip" {
  value       = aws_instance.web.public_ip
  description = "Public IP of the web server"
}
output "db_password" {
  value     = random_password.db.result
  sensitive = true
}
```

### Comandi per gli output

| Command | Description |
|---------|-------------|
| `terraform output` | Stampa tutti gli output |
| `terraform output instance_ip` | Stampa un output specifico |
| `terraform output -json` | Formato JSON per gli script |
| `sensitive = true` | Nasconde il valore dall'output CLI |
| `module.vpc.vpc_id` | Accede agli output del modulo figlio |

## State

### Backend remoto

```
terraform {
  backend "s3" {
    bucket = "my-tf-state"
    key    = "prod/terraform.tfstate"
    region = "us-east-1"
  }
}
```

### Comandi per lo state

| Command | Description |
|---------|-------------|
| `terraform state list` | Elenca tutte le risorse nello state |
| `terraform state show <addr>` | Mostra gli attributi di una risorsa |
| `terraform state mv <src> <dst>` | Rinomina / sposta una risorsa nello state |
| `terraform state rm <addr>` | Rimuove la risorsa dallo state (mantiene l'infrastruttura) |
| `terraform state pull` | Scarica lo state remoto su stdout |
| `terraform import <addr> <id>` | Importa l'infrastruttura esistente nello state |

## Moduli

### Utilizzo dei moduli

```
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.0"
  cidr    = "10.0.0.0/16"
}
```

### Sorgenti dei moduli

| Command | Description |
|---------|-------------|
| `"./modules/vpc"` | Percorso locale |
| `"terraform-aws-modules/vpc/aws"` | Terraform Registry |
| `"github.com/org/repo//module"` | Repository GitHub |
| `"s3::https://bucket/module.zip"` | Bucket S3 |

### Struttura del modulo

```
modules/vpc/
  main.tf          # resources
  variables.tf     # input variables
  outputs.tf       # output values
```

## Sorgenti dati

### Lettura di risorse esistenti

```
data "aws_ami" "ubuntu" {
  most_recent = true
  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd/*"]
  }
  owners = ["099720109477"]
}
```

### Sorgenti dati comuni

| Command | Description |
|---------|-------------|
| `data.aws_ami` | Cerca un'AMI tramite filtri |
| `data.aws_vpc` | Cerca un VPC esistente |
| `data.aws_caller_identity` | ID account AWS corrente |
| `data.aws_region` | Regione AWS corrente |
| `data.terraform_remote_state` | Legge gli output da un altro file state |
| `data.external` | Esegue un programma esterno per i dati |

## Lifecycle

### Regole lifecycle

```
resource "aws_instance" "web" {
  lifecycle {
    create_before_destroy = true
    prevent_destroy       = true
    ignore_changes        = [tags]
  }
}
```

### Opzioni lifecycle

| Command | Description |
|---------|-------------|
| `create_before_destroy` | Crea il sostituto prima di distruggere il vecchio |
| `prevent_destroy` | Errore se `terraform destroy` punta a questa risorsa |
| `ignore_changes` | Non rileva le derive sugli attributi elencati |
| `replace_triggered_by` | Forza la sostituzione quando la risorsa referenziata cambia |
| `precondition` | Valida le assunzioni prima dell'apply |
| `postcondition` | Valida i risultati dopo l'apply |

## Pattern comuni

### Cicli e condizionali

```
# for_each with a map
resource "aws_iam_user" "users" {
  for_each = toset(["alice", "bob"])
  name     = each.value
}
# conditional resource
count = var.create_db ? 1 : 0
```

### Funzioni utili

| Command | Description |
|---------|-------------|
| `file("key.pub")` | Legge il contenuto del file |
| `join(", ", list)` | Unisce una lista in una stringa |
| `lookup(map, key, default)` | Ricerca in una mappa con fallback |
| `length(list)` | Numero di elementi |
| `toset(["a", "b"])` | Converte una lista in set (per for_each) |
| `try(expr, fallback)` | Restituisce fallback se expr genera errori |
| `templatefile(path, vars)` | Renderizza un file template |