Documentazione dell'infrastruttura Oracle Cloud

Introduzione al provider Terraform

Informazioni sul software Terraform e sul provider Terraform OCI.

Terraform è un software "infrastructure-as-code" che ti consente di definire le risorse OCI in file che puoi rendere persistenti, creare versioni e condividere. Questi file descrivono i passi necessari per eseguire il provisioning dell'infrastruttura e mantenerne lo stato:

  • Le risorse creano oggetti dell'infrastruttura OCI, come le reti cloud virtuali o le istanze di computazione. La prima applicazione della configurazione crea gli oggetti e le applicazioni successive li aggiornano o li eliminano.
  • Le origini dati rappresentano viste di sola lettura dell'infrastruttura OCI esistente.
  • Le variabili rappresentano i parametri per Terraform.
Attenzione

I file di stato Terraform contengono tutti gli attributi delle risorse specificati come parte dei file di configurazione. Se gestisci dati riservati con Terraform, ad esempio password di database o utenti o chiavi private dell'istanza, considera il file di stato stesso come dati riservati. Per ulteriori informazioni, vedere Memorizzazione dei dati riservati.

Esempio di uso

Terraform esegue i passi e crea l'infrastruttura descritta nei file di configurazione.

Ad esempio, quando viene applicata la configurazione riportata di seguito, Terraform si connette alla tenancy e recupera una lista dei relativi domini di disponibilità. Poiché non sono state definite risorse in questa configurazione, non viene creata o modificata alcuna infrastruttura.

# Configure the OCI provider with an API Key
# tenancy_ocid is the compartment OCID for the root compartment
provider "oci" {
  tenancy_ocid = var.tenancy_ocid
  user_ocid = var.user_ocid
  fingerprint = var.fingerprint
  private_key_path = var.private_key_path
  region = var.region
}

# Get a list of Availability Domains
data "oci_identity_availability_domains" "ads" {
  compartment_id = var.tenancy_ocid
}

# Output the result
output "show-ads" {
  value = data.oci_identity_availability_domains.ads.availability_domains
}

Per ulteriori informazioni sui requisiti di configurazione di Terraform, vedere Creazione delle configurazioni.