Ressourcen bereitstellen

Verwenden Sie Ihre Terraform configs, um Ihre Cloud-Ressourcen mit Schematics bereitzustellen oder zu ändern.

Ressourcen aktualisieren

Um Cloud-Ressourcen zu aktualisieren, aktualisieren Sie Ihre Terraform-Vorlage mit den erforderlichen Änderungen, die an den Ressourcen vorgenommen werden müssen.

Abhängig von der Konfigurationsänderung kann Terraform Ihre Ressource möglicherweise nicht an Ort und Stelle aktualisieren. Stattdessen muss Terraform zuerst die Ressource löschen und eine neue Ressource erstellen. Wenn Terraform eine Ressource identifiziert, die entfernt und erneut erstellt werden soll, stellen Sie sicher, dass Sie keine Arbeitsumgebung unterbrechen oder Daten löschen.

Gehen Sie wie folgt vor, um die Ressourcen zu aktualisieren:

1. Wählen Sie im Arbeitsbereich-Dashboard den Arbeitsbereich aus, der auf die von Ihnen aktualisierte Terraform-Vorlage verweist.

2. Wählen Sie die Registerkarte Einstellungen aus.

3. Klicken Sie im Abschnitt Details auf Pull latest, um die neueste Version Ihrer Terraform-Vorlage aus dem verlinkten GitHub source repository zu beziehen. Wenn Sie die Terraform-Vorlage durch Hochladen einer Bandarchivdatei (.tar) bereitgestellt haben, müssen Sie den Befehl ibmcloud schematics workspace upload verwenden, um eine neue Version der Vorlage bereitzustellen.

4. Wenn Sie die Variablenwerte ändern möchten, die Sie beim Erstellen des Arbeitsbereichs festgelegt haben, ändern Sie die Variablenwerte.

5. Klicken Sie auf Plan generieren, um einen Terraform-Ausführungsplan zu erstellen. Beachten Sie, dass Sie in dieser Zeit keine Änderungen an Ihrem Arbeitsbereich vornehmen können.

6. Klicken Sie auf Jobs, um das Protokoll Ihrer Ausführung zu überprüfen. Das Auftragsprotokoll enthält eine Übersicht über alle Ressourcen, die IBM Cloud Schematics gerade ändert. IBM Cloud Schematics kann möglicherweise einige Ihrer Ressourcen nicht ändern und schlägt vor, die Ressource zu entfernen und neu zu erstellen.

7. Klicken Sie auf Plan anwenden, um die neue Version der Terraform-Vorlage anzuwenden. Je nach den von Ihnen vorgenommenen Änderungen kann es ein paar Minuten oder ein paar Stunden dauern, bis die Vorlage übernommen wird. Beachten Sie, dass Sie in dieser Zeit keine Änderungen an Ihrem Arbeitsbereich vornehmen können.

   Wenn Sie Ihre Terraform-Vorlage nicht mehr anwenden möchten, können Sie die Schaltfläche Stoppen verwenden. Beachten Sie, dass Aktualisierungen für Ressourcen, die bereits ausgeführt wurden, nicht aufgehoben werden. Wenn eine Ressource gerade aktualisiert wird, wartet Schematics, bis die Aktualisierung abgeschlossen ist, und stoppt dann das Erstellen, Aktualisieren oder Löschen anderer Ressourcen in Ihrer Terraform-Vorlage.

8. Überprüfen Sie das Auftragsprotokoll, um sicherzustellen, dass während des Änderungsvorgangs keine Fehler aufgetreten sind.

9. Wählen Sie in der Navigation Ressourcen aus und überprüfen Sie, ob für die Ressourcen die aktualisierte Konfiguration angezeigt wird.

Verwalten von Abweichungen zwischen Ihrer Cloud-Umgebung und der Terraform-Konfiguration

Die Verwaltung von Abweichungen zwischen dem realistischen Status Ihrer Cloudumgebung und Ihres Infrastrukturcodes, der auch als drift bezeichnet wird, ist eine wesentliche Herausforderung bei der Implementierung der Infrastruktur als Code. Abweichungen können aus zahlreichen Gründen vorkommen. Zum Beispiel:

• Sie haben Ressourcen in Ihrer Terraform-Konfigurationsdatei hinzugefügt, aktualisiert oder entfernt, ohne Ihren Infrastrukturcode auszuführen.
• Sie haben IBM Cloud manuell ohne Terraform hinzugefügt, aktualisiert oder entfernt.
• Sie haben andere Automatisierungstools verwendet, z. B. Skripte, um den Zustand Ihrer Cloud-Ressourcen zu manipulieren.

Weitere Informationen finden Sie im Abschnitt zur Verwendung der Funktion Drifterkennung im Arbeitsbereich.

Ressourcen- und Bereitstellungsdetails überprüfen

Zeigen Sie die Details der IBM Cloud Schematics Bereitstellungen und der Cloud-Ressourcen an, die Sie derzeit mit IBM Cloud Schematics verwalten.

1. Wählen Sie im Arbeitsbereich-Dashboard den Arbeitsbereich aus, den Sie prüfen möchten.
2. Wählen Sie in der Navigation die Option Einstellungen, um eine Übersicht über die Aktivitäten in Ihrem Arbeitsbereich zu erhalten.
3. Überprüfen Sie die Protokolle der vorherigen Terraform-Ausführungspläne und die von Ihnen angewendeten Pläne.
4. Wählen Sie in der Navigation Ressourcen, um den Status der Cloud-Ressourcen zu überprüfen, die Sie mit diesem Arbeitsbereich erstellt haben.
5. Wenn Sie überprüfen möchten, wer eine Änderung an der Terraform-Vorlage vorgenommen hat, wechseln Sie in das Quellenrepository in GitHub, das mit Ihrem Arbeitsbereich verknüpft ist; überprüfen Sie die Änderungen anschließend mithilfe der integrierten Funktionen, zum Beispiel mit dem Commitprotokoll und Pull-Anforderungen.
6. Informationen zu Ereignissen, die von Schematics an IBM Cloud Activity Tracker Event Routing gesendet werden, finden Sie unter IBM Cloud Activity Tracker Event Routing-Ereignisse.

Ressourcen entfernen

Um eine Cloud-Ressource zu entfernen, die Sie mit IBM Cloud Schematics bereitgestellt haben, können Sie entweder Ihre Ressourcen mit Schematics entfernen, Ihren Arbeitsbereich löschen oder den Infrastrukturcode in der Terraform-Vorlage entfernen.

Das Entfernen einer Cloud-Ressource kann nicht rückgängig gemacht werden. Stellen Sie sicher, dass Sie die Daten gesichert haben, bevor Sie eine Ressource entfernen. Wenn Sie den Infrastrukturcode entfernen oder die Ressource in der Terraform-Konfigurationsdatei auf Kommentar setzen, stellen Sie sicher, dass Sie die Protokolldatei Ihres Ausführungsplans sorgfältig überprüfen, um sicherzustellen, dass alle Ressourcen in die Entfernung eingeschlossen sind.

Gehen Sie wie folgt vor, um Ressourcen durch Entfernen der Ressourcenkonfiguration in der Terraform-Vorlage zu entfernen:

1. Öffnen Sie die Terraform-Konfigurationsdatei in Ihrem Quellenrepository in GitHub oder auf Ihrer lokalen Maschine.

2. Entfernen Sie entweder den Infrastrukturcode aus der Datei oder setzen Sie die Ressourcen auf Kommentar, die entfernt werden sollen, indem Sie # am Anfang jeder Zeile hinzufügen.

   Beispiel zum Entfernen einer Ressource durch Auskommentieren einer Ressourcendefinition:

   # 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. Schreiben Sie die Änderung an der Terraform-Konfigurationsdatei fest.

4. Wählen Sie im Arbeitsbereichsdashboardden Arbeitsbereich für die soeben geänderte Terraform-Vorlage aus.

5. Wählen Sie in der Navigation die Option Einstellungen aus.

6. Klicken Sie im Abschnitt Details auf Pull latest, um die neueste Version Ihrer Terraform-Vorlage aus dem verlinkten GitHub source repository zu beziehen. Wenn Sie die Terraform-Vorlage durch Hochladen einer Bandarchivdatei (.tar) bereitgestellt haben, müssen Sie den Befehl ibmcloud schematics workspace upload verwenden, um eine neue Version der Vorlage bereitzustellen.

7. Klicken Sie auf Plan generieren, um einen Terraform-Ausführungsplan zu erstellen. Die Seite Arbeitsbereich Jobs wird geöffnet. Beachten Sie, dass Sie in dieser Zeit keine Änderungen an Ihrem Arbeitsbereich vornehmen können.

8. Klicken Sie auf Jobs, um das Protokoll Ihres Ausführungsplans zu überprüfen. Das Protokoll gibt einen Überblick über alle Ressourcen, die IBM Cloud Schematics demnächst entfernen wird.

9. Klicken Sie auf Plan anwenden, um die Cloud-Ressourcen von Ihrem Konto zu entfernen.

   Wenn Sie Ihre Terraform-Vorlage nicht mehr anwenden möchten, können Sie die Schaltfläche Stoppen verwenden. Beachten Sie, dass alle bereits entfernten Ressourcen nicht erneut erstellt werden. Wenn eine Ressource gerade gelöscht wird, wartet Schematics, bis das Löschen abgeschlossen ist, und stoppt dann das Erstellen, Aktualisieren oder Löschen anderer Ressourcen in Ihrer Terraform-Vorlage.

10. Überprüfen Sie die Protokolldateien, um sicherzustellen, dass während des Löschprozesses keine Fehler aufgetreten sind.

11. Wählen Sie im Navigationsbereich Ressourcen aus und überprüfen Sie, ob die Ressourcen gelöscht werden.

12. Optional: Entfernen Sie den Arbeitsbereich, nachdem Sie alle Ressourcen entfernt haben.

13. Öffnen Sie das Arbeitsbereich-Dashboard und suchen Sie den Arbeitsbereich, den Sie entfernen möchten.

14. Klicken Sie auf die Registerkarte Aktionen und wählen Sie die Option Arbeitsbereich löschen aus.

15. Geben Sie den Namen Ihres Arbeitsbereichs in das Textfeld Type workspace_name to confirm ein.

16. Klicken Sie auf die Schaltfläche Löschen.

Gehen Sie wie folgt vor, um Ressourcen über die Schematics-Konsole zu entfernen:

1. Suchen Sie im Arbeitsbereich-Dashboard den Arbeitsbereich, der die Ressourcen enthält, die Sie löschen möchten.
2. Klicken Sie auf die Registerkarte " Aktionen" und wählen Sie die Option " Ressourcen zerstören".
3. Geben Sie den Namen Ihres Arbeitsbereichs in das Textfeld Type workspace_name to confirm ein. Beachten Sie, dass durch das Löschen von Ressourcen die Ressourcen aus Ihrem Arbeitsbereich und IBM Cloudentfernt werden. Diese Aktion kann nicht rückgängig gemacht werden.
4. Klicken Sie auf die Schaltfläche Löschen.
5. Wählen Sie in der Navigation die Option Jobs, um die Protokolle für die Löschung Ihrer Ressource zu prüfen. Stellen Sie sicher, dass während des Löschvorgangs keine Fehler aufgetreten sind.
6. Nach erfolgreicher Auftragsausführung wählen Sie in der Navigation die Option Ressourcen und überprüfen Sie, ob Ihre Ressourcen entfernt wurden.

Wenn das Entfernen Ihrer Ressourcen abgeschlossen ist, kann der Arbeitsbereich Schematics gelöscht werden.

Ressourcen über die Befehlszeilenschnittstelle bereitstellen

Verwenden Sie Ihre Terraform configs, um Ihre Cloud-Ressourcen mit Schematics bereitzustellen oder zu ändern.

Vorbereitende Schritte:

• Erstellen Sie einen Arbeitsbereich über die Befehlszeilenschnittstelle oder erstellen Sie einen Arbeitsbereich über die Befehlszeilenschnittstelle.
• Stellen Sie sicher, dass Sie über die erforderlichen IAM-Berechtigungen verfügen, um die Ressourcen in IBM Cloud bereitzustellen.

Gehen Sie wie folgt vor, um Ressourcen bereitzustellen:

1. Richten Sie über Ihre lokale Befehlszeilenschnittstelle Ihre CLI und Ihr Schematics-Plug-in ein.

2. Listen Sie Ihren Arbeitsbereich mit dem Befehl ibmcloud schematics workspace list auf.

3. Rufen Sie Ihren Arbeitsbereich mit dem Befehl ibmcloud schematics workspace get ab.

4. Wenn Sie Ihre Terraform-Vorlage durch Hochladen einer Bandarchivdatei (.tar) bereitgestellt haben, müssen Sie den Befehl ibmcloud schematics workspace upload verwenden.

5. Erstellen Sie mithilfe des Befehls ibmcloud schematics plan einen Terraform-Ausführungsplan.

6. Verwenden Sie Ihre Arbeitsbereichs-ID, um die Protokolle mit dem Befehl ibmcloud schematics logs abzurufen.

7. Wenn Sie bereit sind, führen Sie den Befehl ibmcloud schematics apply aus.

   Wenn Sie die Anwendung Ihrer Terraform-Vorlage stoppen möchten, verwenden Sie den Befehl ibmcloud schematics job delete. Beachten Sie, dass alle bereits erstellten Ressourcen nicht entfernt werden. Wenn eine Ressource gerade bereitstellt wird, wartet Schematics, bis die Bereitstellung abgeschlossen ist, und stoppt dann das Erstellen, Aktualisieren oder Löschen anderer Ressourcen in Ihrer Terraform-Vorlage.

8. Überprüfen Sie das Auftragsprotokoll, um sicherzustellen, dass während des Bereitstellungs-, Änderungs- oder Löschvorgangs keine Fehler aufgetreten sind.

9. Wählen Sie im Navigationsbereich die Option Ressourcen, um eine Übersicht über die Cloud-Ressourcen zu erhalten, die in Ihrem IBM Cloud Konto verfügbar sind.

Ressourcen über die Befehlszeilenschnittstelle aktualisieren

Um Cloud-Ressourcen zu aktualisieren, aktualisieren Sie Ihre Terraform-Vorlage mit den erforderlichen Änderungen, die an den Ressourcen vorgenommen werden müssen.

Abhängig von der Konfigurationsänderung kann Terraform Ihre Ressource möglicherweise nicht an Ort und Stelle aktualisieren. Stattdessen muss Terraform zuerst die Ressource löschen und eine neue Ressource erstellen. Wenn Terraform eine Ressource identifiziert, die entfernt und erneut erstellt werden soll, stellen Sie sicher, dass Sie keine Arbeitsumgebung unterbrechen oder Daten löschen.

Gehen Sie wie folgt vor, um die Ressourcen zu aktualisieren:

1. Richten Sie über die Befehlszeilenschnittstelle Ihre CLI und Ihr Schematics-Plug-in ein.

2. Listen Sie Ihren Arbeitsbereich mit dem Befehl ibmcloud schematics workspace list auf.

3. Rufen Sie Ihren Arbeitsbereich mit dem Befehl ibmcloud schematics workspace get ab.

4. Wenn Sie Ihre Terraform-Vorlage durch Hochladen einer Bandarchivdatei (.tar) bereitgestellt haben, müssen Sie den Befehl ibmcloud schematics workspace upload verwenden.

5. Erstellen Sie mithilfe des Befehls ibmcloud schematics plan einen Terraform-Ausführungsplan.

6. Verwenden Sie Ihre Arbeitsbereichs-ID, um die Protokolle mit dem Befehl ibmcloud schematics logs abzurufen.

7. Wenn Sie bereit sind, führen Sie den Befehl ibmcloud schematics apply aus.

   Wenn Sie die Anwendung Ihrer Terraform-Vorlage stoppen möchten, verwenden Sie den Befehl ibmcloud schematics job delete. Beachten Sie, dass alle bereits erstellten Ressourcen nicht entfernt werden. Wenn eine Ressource gerade bereitstellt wird, wartet Schematics, bis die Bereitstellung abgeschlossen ist, und stoppt dann das Erstellen, Aktualisieren oder Löschen anderer Ressourcen in Ihrer Terraform-Vorlage.

8. Überprüfen Sie das Auftragsprotokoll, um sicherzustellen, dass während des Bereitstellungs-, Änderungs- oder Löschvorgangs keine Fehler aufgetreten sind.

9. Wählen Sie im Navigationsbereich die Option Ressourcen, um eine Übersicht über die Cloud-Ressourcen zu erhalten, die in Ihrem IBM Cloud Konto verfügbar sind.

Abweichung zwischen Ihrer Cloudumgebung und der Terraform-Konfiguration über die Befehlszeilenschnittstelle verwalten

Die Verwaltung von Abweichungen zwischen dem realistischen Status Ihrer Cloudumgebung und Ihres Infrastrukturcodes, der auch als drift bezeichnet wird, ist eine wesentliche Herausforderung bei der Implementierung der Infrastruktur als Code. Abweichungen können aus zahlreichen Gründen vorkommen. Zum Beispiel:

• Sie haben Ressourcen in Ihrer Terraform-Konfigurationsdatei hinzugefügt, aktualisiert oder entfernt, ohne Ihren Infrastrukturcode auszuführen.
• Sie haben IBM Cloud manuell ohne Terraform hinzugefügt, aktualisiert oder entfernt.
• Sie haben andere Automatisierungstools verwendet, z. B. Skripte, um den Zustand Ihrer Cloud-Ressourcen zu manipulieren.

Weitere Informationen finden Sie im Abschnitt zur Verwendung der Funktion Drifterkennung im Arbeitsbereich.

Ressourcen-und Bereitstellungsdetails über die Befehlszeilenschnittstelle überprüfen

Zeigen Sie die Details der IBM Cloud Schematics Bereitstellungen und der Cloud-Ressourcen an, die Sie derzeit mit IBM Cloud Schematics verwalten.

1. Richten Sie über die Befehlszeilenschnittstelle Ihre CLI und Ihr Schematics-Plug-in ein.
2. Wählen Sie im Navigationsbereich die Option Ressourcen, um eine Übersicht über die Cloud-Ressourcen zu erhalten, die in Ihrem IBM Cloud Konto verfügbar sind.
3. Wenn Sie überprüfen möchten, wer eine Änderung an der Terraform-Vorlage vorgenommen hat, wechseln Sie in das Quellenrepository in GitHub, das mit Ihrem Arbeitsbereich verknüpft ist; überprüfen Sie die Änderungen anschließend mithilfe der integrierten Funktionen, zum Beispiel mit dem Commitprotokoll und Pull-Anforderungen.
4. Informationen zu Ereignissen, die von Schematics an IBM Cloud Activity Tracker Event Routing gesendet werden, finden Sie unter IBM Cloud Activity Tracker Event Routing-Ereignisse.

Ressourcen über die Befehlszeilenschnittstelle entfernen

Um eine Cloud-Ressource zu entfernen, die Sie mit IBM Cloud Schematics bereitgestellt haben, können Sie entweder Ihre Ressourcen mit Schematics entfernen, Ihren Arbeitsbereich löschen oder den Infrastrukturcode in der Terraform-Vorlage entfernen.

Das Entfernen einer Cloud-Ressource kann nicht rückgängig gemacht werden. Stellen Sie sicher, dass Sie die Daten gesichert haben, bevor Sie eine Ressource entfernen. Wenn Sie den Infrastrukturcode entfernen oder die Ressource in der Terraform-Konfigurationsdatei auf Kommentar setzen, stellen Sie sicher, dass Sie die Protokolldatei Ihres Ausführungsplans sorgfältig überprüfen, um sicherzustellen, dass alle Ressourcen in die Entfernung eingeschlossen sind.

Um Ihre Ressourcen zu entfernen, löschen Sie den Infrastrukturcode aus Ihrer Terraform-Vorlage:

1. Öffnen Sie die Terraform-Konfigurationsdatei in Ihrem Quellenrepository in GitHub oder auf Ihrer lokalen Maschine.

2. Entfernen Sie entweder den Infrastrukturcode aus der Datei oder setzen Sie die Ressourcen auf Kommentar, die entfernt werden sollen, indem Sie # am Anfang jeder Zeile hinzufügen.

   Beispiel für das Auskommentieren einer Ressource:

   
   #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. Schreiben Sie die Änderung an der Terraform-Konfigurationsdatei fest.

4. Richten Sie über die Befehlszeilenschnittstelle Ihre CLI und Ihr Schematics-Plug-in ein.

5. Rufen Sie Ihren Arbeitsbereich mit dem Befehl ibmcloud schematics workspace get ab.

6. Wenn Sie Ihre Terraform-Vorlage durch Hochladen einer Bandarchivdatei (.tar) bereitgestellt haben, müssen Sie den Befehl ibmcloud schematics workspace upload verwenden.

7. Erstellen Sie mithilfe des Befehls ibmcloud schematics plan einen Terraform-Ausführungsplan.

8. Verwenden Sie Ihre Arbeitsbereichs-ID, um die Protokolle mit dem Befehl ibmcloud schematics logs abzurufen.

9. Wenn Sie bereit sind, führen Sie den Befehl ibmcloud schematics apply aus.

   Wenn Sie die Anwendung Ihrer Terraform-Vorlage stoppen möchten, verwenden Sie den Befehl ibmcloud schematics job delete. Beachten Sie, dass alle bereits erstellten Ressourcen nicht entfernt werden. Wenn eine Ressource gerade bereitstellt wird, wartet Schematics, bis die Bereitstellung abgeschlossen ist, und stoppt dann das Erstellen, Aktualisieren oder Löschen anderer Ressourcen in Ihrer Terraform-Vorlage.

10. Überprüfen Sie das Auftragsprotokoll, um sicherzustellen, dass während des Bereitstellungs-, Änderungs- oder Löschvorgangs keine Fehler aufgetreten sind.

11. Wählen Sie im Navigationsbereich die Option Ressourcen, um eine Übersicht über die Cloud-Ressourcen zu erhalten, die in Ihrem IBM Cloud Konto verfügbar sind.

12. Optional: Entfernen Sie nach dem Entfernen aller Ressourcen Ihren Arbeitsbereich mithilfe des Befehls ibmcloud schematics workspace delete.