Importazione di risorse esistenti

A volte si dispone di risorse cloud create manualmente o da altri strumenti. Terraform import consente di portare queste risorse esistenti sotto la gestione di Terraform.

Ciò significa che Terraform ne terrà traccia dello stato e che le modifiche future potranno essere applicate tramite i file di configurazione. È un passaggio fondamentale per adottare l'Infrastructure as Code (IaC) in un ambiente «brownfield».

L'importazione è utile in diverse situazioni:

• Migrazione dell'infrastruttura esistente: portare nel flusso di lavoro IaC le risorse create al di fuori di Terraform.
• Adozione graduale di Terraform: iniziare dalle risorse esistenti invece di ricreare tutto.
• Recupero dopo la perdita dello stato: ricollegare Terraform alle risorse se il file di stato viene perso (anche se ciò è raro quando si utilizza uno stato remoto).

La struttura di base del comando terraform import è semplice. Indica a Terraform di trovare una risorsa esistente nel cloud provider e aggiungerla al file di stato, associandola a un blocco di risorsa nella configurazione.

Richiede due informazioni principali: l'indirizzo Terraform della risorsa e l'ID della risorsa assegnato dal cloud provider.

Il resource address è il modo in cui Terraform identifica una risorsa specifica all'interno della configurazione. Segue il modello resource_type.resource_name.

• resource_type: il tipo di risorsa (ad esempio aws_s3_bucket, azurerm_resource_group).
• resource_name: il nome locale assegnato alla risorsa nella configurazione Terraform (ad esempio my_bucket, web_app).

Questo indirizzo deve essere già presente nei file .tf.

Ogni risorsa di un cloud provider, come AWS, Azure o GCP, ha un identificatore univoco, spesso chiamato ID. Questo ID serve per indicare a Terraform *quale* risorsa esistente specifica importare.

Può trovare l'ID nella console del cloud provider, tramite la relativa CLI o attraverso la relativa API. Ad esempio, l'ID di un bucket AWS S3 è il suo nome, mentre un'istanza EC2 ha un instance ID come i-0abcdef1234567890.

Passaggio fondamentale: prima di eseguire terraform import, deve avere definito nei file di configurazione Terraform (file .tf) un blocco di risorsa corrispondente.

Questo blocco indica a Terraform quale tipo di risorsa aspettarsi e quali attributi dovrebbe avere. Terraform utilizza questa definizione per comprendere lo schema della risorsa durante l'importazione.

Supponiamo che esista già un bucket AWS S3 denominato my-existing-coddykit-bucket-123. Per prima cosa, definisca un blocco di risorsa per il bucket nel file main.tf:

Ora che dispone della definizione HCL, può eseguire il comando terraform import. Sostituisca my-existing-coddykit-bucket-123 con il nome/l'ID effettivo del bucket esistente.

Si assicuri di aver già eseguito terraform init nella directory!

Dopo un'importazione completata correttamente, Terraform avrà aggiunto la risorsa al file di stato. Può verificarlo usando terraform state show, che visualizza gli attributi della risorsa importata così come vengono rilevati da Terraform.

È fondamentale eseguire poi terraform plan per assicurarsi che non vi siano differenze impreviste tra l'HCL e lo stato effettivo della risorsa importata.

Desidera importare in Terraform un'istanza AWS EC2 esistente. Quale dei seguenti passaggi DEVE essere completato *prima* di eseguire il comando terraform import?

Ha imparato a portare le risorse cloud esistenti sotto la gestione di Terraform usando terraform import.

• Per prima cosa, definisca il blocco di risorsa nel Suo HCL.
• Quindi, individui l'ID della risorsa assegnato dal cloud provider.
• Infine, esegua terraform import ADDRESS ID.
• Completi sempre l'operazione con terraform plan per riallineare eventuali differenze.

Questo potente comando aiuta a colmare il divario tra un'infrastruttura gestita manualmente e un ambiente completamente basato sull'IaC.