Configurare i moduli Terraform

Tutte le risorse di computazione, networking e infrastruttura di storage necessarie per questa soluzione sono definite nei moduli Terraform.

Operazioni preliminari

Prima di iniziare a configurare i moduli Terraform, effettuare le operazioni riportate di seguito.

  1. Apprendere le nozioni di base di Terraform.

    Leggere come minimo l'introduzione della documentazione di Terrraform.

  2. Tenere presenti le seguenti informazioni:
    • L'OCID della tenancy.

      Puoi trovare l'OCID della tua tenancy nella console Web di Oracle Cloud Infrastructure. Selezionare Amministrazione dal menu Servizi, quindi fare clic su Dettagli tenancy.

    • L'OCID dell'utente che dovrà essere usato da Terraform per l'autenticazione con Oracle Cloud Infrastructure.

      Per trovare l'OCID dell'utente, selezionare Identità dal menu Servizi, quindi selezionare Utenti. Individuare il proprio nome utente nella lista e copiare il relativo OCID.

    • L'OCID del compartimento in cui si desidera creare le risorse.

      Per trovare l'OCID di un compartimento, selezionare Identità dal menu Servizi, quindi selezionare Compartimenti. Individuare il compartimento necessario nella lista e copiarne l'OCID.

    • L'ID dell'area in cui si desidera creare le risorse.

      Ad esempio, l'ID dell'area US East (Ashburn) è us-ashburn-1.

      Vedere Aree e domini di disponibilità.

  3. Scegliere quanto segue:
  4. Verificare che i limiti di servizio della tenancy siano adeguati a tutte le risorse che si desidera creare.

Scarica codice Terraform

Il codice Terraform per questa soluzione è disponibile in GitHub.

  1. Nel riquadro di navigazione a sinistra fare clic su Codice download.
  2. Fare clic su Repository Git.
  3. Duplicare o scaricare il repository nel computer locale.

Informazioni sul codice Terraform

Il codice Terraform scaricato ha la struttura seguente:

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • Directory _docs: contiene i diagrammi dell'architettura.
  • *.tf: i file di configurazione Terraform utilizzati dalla soluzione. Non modificare questi file.
  • env-vars: uno script per impostare le variabili di ambiente per Terraform.
  • LICENSE.md: i termini di licenza per il codice.
  • modules: directory che contengono le configurazioni di base di Terraform per le risorse create utilizzando questa soluzione. Non modificarli.
  • orm: contiene un file zip che è possibile utilizzare per creare uno stack in Oracle Cloud Infrastructure Resource Manager anziché utilizzare Terraform per distribuire la soluzione.
  • README.md: documentazione di avvio rapido del codice.
  • schema.yaml: i vincoli e le convalide per le variabili utilizzate nel codice Terraform. Questo file viene utilizzato quando si distribuiscono le risorse mediante Oracle Resource Manager. Non modificare questo file.
  • terraform.tfvars: le variabili Terraform. In seguito sarà possibile impostare i valori per le variabili in questo file.
  • userdata: contiene uno script che viene eseguito sulle istanze di calcolo dopo che sono state create. Non modificare i file in questa directory.

Impostare le variabili di ambiente Terraform

Il codice Terraform include un file di script che è possibile utilizzare per memorizzare i valori di alcuni parametri Terraform come variabili di ambiente.

  1. Assicurarsi di aver completato i prerequisiti descritti in precedenza.
  2. Sul computer locale, andare alla directory in cui è stato scaricato il codice Terraform.
  3. Nella directory di livello superiore del codice individuare e aprire il file env-vars in un editor di testo non codificato.
  4. Immettere i valori appropriati per le variabili nel file.

    Nota:

    Quando si specifica il valore per ogni variabile, ricordarsi di rimuovere il commento dalla riga, che rimuove il carattere # (hash) all'inizio della riga.
  5. Verificare i valori specificati.
    Se si omettono valori, viene richiesto di immettere un input quando si esegue Terraform. Se si forniscono valori non corretti, Terraform si verificherà un errore.
  6. Quando tutti i valori sono corretti, salvare e chiudere il file.
  7. Impostare le variabili di ambiente eseguendo il comando seguente dalla directory che contiene il file delle variabili di ambiente, eseguendo il comando seguente:
    source ./env-vars
  8. Verificare di aver impostato tutte le variabili di ambiente eseguendo il comando seguente:
    env | grep TF
    Vengono visualizzate le variabili di ambiente impostate.

Imposta i parametri di distribuzione

Specificare le risorse di computazione, rete, database e storage da creare e le relative proprietà.

  1. Assicurarsi di aver completato i prerequisiti descritti in precedenza.
  2. Nella directory di livello superiore del codice scaricato o duplicato, individuare il file terraform.tfvars e aprirlo in un editor di testo non codificato.
  3. Impostare i valori per le variabili elencate in terraform.tfvars.
    Il file README nel codice scaricato contiene le descrizioni delle variabili e include un esempio di file terraform.tfvars completato.
  4. Salvare e chiudere terraform.tfvars.