Distribuzione delle tue risorse

Distribuisci il tuo Terraform configs per fornire o modificare le tue risorse cloud con Schematics.

Aggiornamento delle tue risorse

Per aggiornare le risorse Cloud, aggiornare il modello Terraform con le modifiche richieste che devono essere eseguite sulle risorse.

A seconda della modifica della configurazione, Terraform potrebbe non essere in grado di aggiornare la tua risorsa sul posto. Invece, Terraform deve prima eliminare la risorsa e creare una nuova risorsa. Se Terraform identifica una risorsa da rimuovere e ricreare, assicurarsi di non interrompere un ambiente di lavoro o eliminare i dati.

Per aggiornare le tue risorse:

1. Dalla dashboard dello spazio di lavoro, selezionare lo spazio di lavoro che punta al modello Terraform aggiornato.

2. Seleziona la scheda Settings.

3. Nella sezione Dettagli, fare clic su Pull latest per ottenere l'ultima versione del modello Terraform dal repository sorgente GitHub collegato. Se hai fornito il tuo modello Terraform caricando un file di archivio nastro (.tar), devi utilizzare il comando ibmcloud schematics workspace upload per fornire una nuova versione del tuo modello.

4. Se si desidera modificare i valori delle variabili impostati durante la creazione dello spazio di lavoro, modificare i valori delle variabili.

5. Fai clic su Genera piano per creare un piano di esecuzione Terraform. Si noti che durante questo periodo non è possibile apportare modifiche all'area di lavoro.

6. Fare clic su Lavori per esaminare il log dell'esecuzione. Il log del lavoro fornisce un riepilogo di tutte le risorse che IBM Cloud Schematics sta per modificare. IBM Cloud Schematics potrebbe non essere in grado di modificare alcune delle tue risorse e suggerire di rimuovere e ricreare la risorsa.

7. Fai clic su Applica piano per applicare la nuova versione del modello Terraform. A seconda delle modifiche apportate, l'applicazione del modello potrebbe richiedere alcuni minuti o alcune ore. Si noti che durante questo periodo non è possibile apportare modifiche all'area di lavoro.

   Se vuoi smettere di applicare il tuo modello Terraform, puoi usare il pulsante Arresta. Tenere presente che gli aggiornamenti alle risorse già eseguite non vengono ripristinati. Se una risorsa è attualmente in aggiornamento, Schematics attende il completamento dell'aggiornamento e quindi arresta la creazione, l'aggiornamento o l'eliminazione di qualsiasi altra risorsa nel tuo modello Terraform.

8. Esaminare il registro del lavoro per verificare che non si siano verificati errori durante il processo di modifica.

9. Dalla navigazione, seleziona Risorse e verifica che le tue risorse mostrino la configurazione aggiornata.

Gestione della deviazione tra il tuo ambiente cloud e la configurazione Terraform

Gestire le deviazioni tra lo stato reale del tuo ambiente cloud e il codice dell'infrastruttura, a cui si fa riferimento anche come drift, è una sfida fondamentale quando si implementa l'infrastruttura come codice. Le deviazioni possono verificarsi per molti motivi, come:

• Hai aggiunto, aggiornato o rimosso le risorse nel tuo file di configurazione Terraform senza eseguire il tuo codice dell'infrastruttura.
• Hai aggiunto, aggiornato o rimosso manualmente IBM Cloud senza Terraform.
• Hai utilizzato altri strumenti di automazione, come gli script, per manipolare lo stato delle tue risorse cloud.

Fare riferimento all'utilizzo della funzione rilevamento della deviazione dello spazio di lavoro.

Revisione dei dettagli della risorsa e della distribuzione

Visualizzare i dettagli delle implementazioni di IBM Cloud Schematics e delle risorse Cloud attualmente gestite con IBM Cloud Schematics.

1. Dalla dashboard dell'area di lavoro, selezionare l'area di lavoro che si desidera ispezionare.
2. Dalla navigazione, selezionare Impostazioni per trovare un riepilogo delle attività nell'area di lavoro.
3. Esamina i log dei piani di esecuzione Terraform precedenti e i piani che hai applicato.
4. Dalla navigazione, selezionare Risorse per esaminare lo stato delle risorse Cloud create con questo spazio di lavoro.
5. Per vedere chi ha apportato una modifica al tuo modello Terraform, passa al repository di origine in GitHub collegato al tuo spazio di lavoro e utilizza le funzionalità integrate quali la cronologia di commit e le richieste di estrazione per rivedere le modifiche.
6. Per riesaminare gli eventi che Schematics ha inviato a IBM Cloud Activity Tracker Event Routing, vedi Eventi IBM Cloud Activity Tracker Event Routing.

Rimozione delle tue risorse

Per rimuovere una risorsa Cloud che è stata fornita con IBM Cloud Schematics, si possono rimuovere le risorse con Schematics, cancellare l'area di lavoro o rimuovere il codice dell'infrastruttura nel modello Terraform.

La rimozione di una risorsa Cloud non può essere annullata. Assicurati di eseguire il backup dei tuoi dati prima di eliminare una risorsa. Se scegli di rimuovere il codice dell'infrastruttura o di impostare come commento la risorsa nel tuo file di configurazione Terraform, accertati di rivedere attentamente il file di log del tuo piano di esecuzione, per verificare che tutte le tue risorse siano comprese nella rimozione.

Per rimuovere le risorse rimuovendo la configurazione della risorsa nel tuo modello Terraform:

1. Apri il file di configurazione Terraform nel tuo repository di origine in GitHub o sulla tua macchina locale.

2. Rimuovi il codice dell'infrastruttura dal file o imposta come commento le risorse che desideri rimuovere aggiungendo # all'inizio di ciascuna riga.

   Esempio per rimuovere una risorsa commentando una definizione di risorsa:

   # resource ibm_is_instance "vsi1" {
   #  name    = "${local.BASENAME}-vsi2"
   #  vpc     = ibm_is_vpc.vpc.id
   #  zone    = "${local.ZONE}"
   #  keys    = [data.ibm_is_ssh_key.ssh_key_id.id]
   #  image   = data.ibm_is_image.ubuntu.id
   #  profile = "cc1-2x4"
   
   #  primary_network_interface {
   #    subnet          = ibm_is_subnet.subnet1.id
   #    security_groups = [ibm_is_security_group.sg1.id]
   #  }
   #}
   

3. Esegui il commit della modifica al tuo file di configurazione Terraform.

4. Dal dashboard dello spazio di lavoro, seleziona lo spazio di lavoro per il template Terraform che hai appena modificato.

5. Dalla navigazione, selezionare Impostazioni.

6. Nella sezione Dettagli, fare clic su Pull latest per ottenere l'ultima versione del modello Terraform dal repository sorgente GitHub collegato. Se hai fornito il tuo modello Terraform caricando un file di archivio nastro (.tar), devi utilizzare il comando ibmcloud schematics workspace upload per fornire una nuova versione del tuo modello.

7. Fai clic su Genera piano per creare un piano di esecuzione Terraform. Si apre la pagina Lavori dell'area di lavoro. Si noti che durante questo periodo non è possibile apportare modifiche all'area di lavoro.

8. Fare clic su Lavori per esaminare il registro del piano di esecuzione. Il registro fornisce un riepilogo di tutte le risorse che IBM Cloud Schematics sta per rimuovere.

9. Fare clic su Applica piano per rimuovere le risorse cloud dal proprio account.

   Se vuoi smettere di applicare il tuo modello Terraform, puoi usare il pulsante Arresta. Si noti che tutte le risorse già rimosse non vengono ricreate. Se una risorsa è attualmente in fase di eliminazione, Schematics attende il completamento dell'eliminazione e quindi arresta la creazione, l'aggiornamento o l'eliminazione di qualsiasi altra risorsa nel tuo modello Terraform.

10. Esamina i file di log per assicurarti che non si siano verificati errori durante il processo di eliminazione.

11. Dalla navigazione, seleziona Risorse e verifica che le tue risorse siano state rimosse.

12. Facoltativo: dopo aver rimosso tutte le tue risorse, rimuovi il tuo spazio di lavoro.

13. Aprire la dashboard dello spazio di lavoro e individuare lo spazio di lavoro che si desidera rimuovere.

14. Fare clic sulla scheda Azioni e selezionare l'opzione Elimina spazio di lavoro.

15. Immettere il nome dello spazio di lavoro in Tipo workspace_name per confermare la casella di testo.

16. Fare clic sul pulsante Elimina.

Per rimuovere le risorse utilizzando la console Schematics:

1. Dalla dashboard dell'area di lavoro, individua l'area di lavoro che include le risorse che desideri eliminare.
2. Fare clic sulla scheda Azioni e selezionare l'opzione Elimina risorse.
3. Immettere il nome dello spazio di lavoro in Tipo workspace_name per confermare la casella di testo. Tieni presente che l'eliminazione delle risorse rimuove le risorse dal tuo workspace e da IBM Cloud. Questa azione non può essere annullata.
4. Fare clic sul pulsante Elimina.
5. Dalla navigazione, selezionare Lavori per esaminare i registri dell'eliminazione della risorsa. Assicurati che non si siano verificati errori durante il processo di eliminazione.
6. Dopo l'esecuzione del lavoro, dalla navigazione selezionare Risorse e verificare che le risorse siano state rimosse.

Dopo che la rimozione delle tue risorse è stata completata, lo spazio di lavoro Schematics può essere eliminato.

Distribuzione delle tue risorse tramite la CLI

Distribuisci il tuo Terraform configs per fornire o modificare le tue risorse cloud con Schematics.

Prima di iniziare:

• Crea uno spazio di lavoro dalla CLI o crea uno spazio di lavoro utilizzando la CLI.
• Assicurarsi di avere le autorizzazioni IAM necessarie per distribuire le risorse in IBM Cloud.

Per distribuire le tue risorse:

1. Dalla tua interfaccia riga di comando locale imposta la tua CLI e il plugin Schematics.

2. Elenca il tuo workspace utilizzando il comando ibmcloud schematics workspace list.

3. Ottieni il tuo workspace utilizzando il comando ibmcloud schematics workspace get.

4. Se hai fornito il tuo modello Terraform caricando un file di archivio nastro (.tar), devi utilizzare il comando ibmcloud schematics workspace upload.

5. Crea un piano di esecuzione Terraform utilizzando il comando ibmcloud schematics plan.

6. Utilizzare il proprio ID spazio di lavoro per richiamare i log utilizzando il comando ibmcloud schematics logs.

7. Quando si è pronti, eseguire il comando ibmcloud schematics apply.

   Se vuoi interrompere l'applicazione del tuo modello Terraform, puoi utilizzare il comando ibmcloud schematics job delete. Notare che tutte le risorse già create non vengono rimosse. Se una risorsa sta attualmente eseguendo il provisioning, Schematics attende il completamento del provisioning e quindi arresta la creazione, l'aggiornamento o l'eliminazione di qualsiasi altra risorsa nel tuo modello Terraform.

8. Esaminare il job log per verificare che non si siano verificati errori durante il processo di provisioning, modifica o eliminazione.

9. Nel riquadro di navigazione, selezionare Risorse per trovare un riepilogo delle risorse Cloud disponibili nell'account IBM Cloud.

Aggiornamento delle tue risorse tramite la CLI

Per aggiornare le risorse cloud, aggiornare il modello Terraform con le modifiche richieste che devono essere eseguite sulle risorse.

A seconda della modifica della configurazione, Terraform potrebbe non essere in grado di aggiornare la tua risorsa sul posto. Invece, Terraform deve prima eliminare la risorsa e creare una nuova risorsa. Se Terraform identifica una risorsa da rimuovere e ricreare, assicurarsi di non interrompere un ambiente di lavoro o eliminare i dati.

Per aggiornare le tue risorse:

1. Dalla tua interfaccia riga di comando configura la tua CLI e il plugin Schematics.

2. Elenca il tuo workspace utilizzando il comando ibmcloud schematics workspace list.

3. Ottieni il tuo workspace utilizzando il comando ibmcloud schematics workspace get.

4. Se hai fornito il tuo modello Terraform caricando un file di archivio nastro (.tar), devi utilizzare il comando ibmcloud schematics workspace upload.

5. Crea un piano di esecuzione Terraform utilizzando il comando ibmcloud schematics plan.

6. Utilizzare il proprio ID spazio di lavoro per richiamare i log utilizzando il comando ibmcloud schematics logs.

7. Quando si è pronti, eseguire il comando ibmcloud schematics apply.

   Se vuoi interrompere l'applicazione del tuo modello Terraform, puoi utilizzare il comando ibmcloud schematics job delete. Notare che tutte le risorse già create non vengono rimosse. Se una risorsa sta attualmente eseguendo il provisioning, Schematics attende il completamento del provisioning e quindi arresta la creazione, l'aggiornamento o l'eliminazione di qualsiasi altra risorsa nel tuo modello Terraform.

8. Esaminare il job log per verificare che non si siano verificati errori durante il processo di provisioning, modifica o eliminazione.

9. Nel riquadro di navigazione, selezionare Risorse per trovare un riepilogo delle risorse Cloud disponibili nell'account IBM Cloud.

Gestione della deviazione tra il tuo ambiente cloud e la configurazione Terraform tramite la CLI

Gestire le deviazioni tra lo stato reale del tuo ambiente cloud e il codice dell'infrastruttura, a cui si fa riferimento anche come drift, è una sfida fondamentale quando si implementa l'infrastruttura come codice. Le deviazioni possono verificarsi per molti motivi, come:

• Hai aggiunto, aggiornato o rimosso le risorse nel tuo file di configurazione Terraform senza eseguire il tuo codice dell'infrastruttura.
• Hai aggiunto, aggiornato o rimosso manualmente IBM Cloud senza Terraform.
• Hai utilizzato altri strumenti di automazione, come gli script, per manipolare lo stato delle tue risorse cloud.

Fare riferimento all'utilizzo della funzione rilevamento della deviazione dello spazio di lavoro.

Revisione dei dettagli della risorsa e della distribuzione tramite la CLI

Visualizzare i dettagli delle implementazioni di IBM Cloud Schematics e delle risorse Cloud attualmente gestite con IBM Cloud Schematics.

1. Dalla tua interfaccia riga di comando configura la tua CLI e il plugin Schematics.
2. Nel riquadro di navigazione, selezionare Risorse per trovare un riepilogo delle risorse Cloud disponibili nell'account IBM Cloud.
3. Per vedere chi ha apportato una modifica al tuo modello Terraform, passa al repository di origine in GitHub collegato al tuo spazio di lavoro e utilizza le funzionalità integrate quali la cronologia di commit e le richieste di estrazione per rivedere le modifiche.
4. Per riesaminare gli eventi che Schematics ha inviato a IBM Cloud Activity Tracker Event Routing, vedi Eventi IBM Cloud Activity Tracker Event Routing.

Rimozione delle tue risorse tramite la CLI

Per rimuovere una risorsa Cloud che è stata fornita con IBM Cloud Schematics, si possono rimuovere le risorse con Schematics, cancellare l'area di lavoro o rimuovere il codice dell'infrastruttura nel modello Terraform.

La rimozione di una risorsa Cloud non può essere annullata. Assicurati di eseguire il backup dei tuoi dati prima di eliminare una risorsa. Se scegli di rimuovere il codice dell'infrastruttura o di impostare come commento la risorsa nel tuo file di configurazione Terraform, accertati di rivedere attentamente il file di log del tuo piano di esecuzione, per verificare che tutte le tue risorse siano comprese nella rimozione.

Per rimuovere le risorse eliminando il codice dell'infrastruttura dal modello di Terraform:

1. Apri il file di configurazione Terraform nel tuo repository di origine in GitHub o sulla tua macchina locale.

2. Rimuovi il codice dell'infrastruttura dal file o imposta come commento le risorse che desideri rimuovere aggiungendo # all'inizio di ciascuna riga.

   Esempio impostazione come commento di una risorsa:

   
   #resource ibm_is_instance "vsi1" {
   #  name    = "${local.BASENAME}-vsi2"
   #  vpc     = ibm_is_vpc.vpc.id
   #  zone    = "${local.ZONE}"
   #  keys    = [data.ibm_is_ssh_key.ssh_key_id.id]
   #  image   = data.ibm_is_image.ubuntu.id
   #  profile = "cc1-2x4"
   
   #  primary_network_interface {
   #    subnet          = ibm_is_subnet.subnet1.id
   #    security_groups = [ibm_is_security_group.sg1.id]
   #  }
   #}
   

3. Esegui il commit della modifica al tuo file di configurazione Terraform.

4. Dalla tua interfaccia riga di comando configura la tua CLI e il plugin Schematics.

5. Ottieni il tuo workspace utilizzando il comando ibmcloud schematics workspace get.

6. Se hai fornito il tuo modello Terraform caricando un file di archivio nastro (.tar), devi utilizzare il comando ibmcloud schematics workspace upload.

7. Crea un piano di esecuzione Terraform utilizzando il comando ibmcloud schematics plan.

8. Utilizzare il proprio ID spazio di lavoro per richiamare i log utilizzando il comando ibmcloud schematics logs.

9. Quando si è pronti, eseguire il comando ibmcloud schematics apply.

   Se vuoi interrompere l'applicazione del tuo modello Terraform, puoi utilizzare il comando ibmcloud schematics job delete. Notare che tutte le risorse già create non vengono rimosse. Se una risorsa sta attualmente eseguendo il provisioning, Schematics attende il completamento del provisioning e quindi arresta la creazione, l'aggiornamento o l'eliminazione di qualsiasi altra risorsa nel tuo modello Terraform.

10. Esaminare il job log per verificare che non si siano verificati errori durante il processo di provisioning, modifica o eliminazione.

11. Nel riquadro di navigazione, selezionare Risorse per trovare un riepilogo delle risorse Cloud disponibili nell'account IBM Cloud.

12. Facoltativo: dopo aver rimosso tutte le risorse, rimuovere lo spazio di lavoro utilizzando il comando ibmcloud schematics workspace delete.