Terraform installieren und Ressourcen für Secrets Manager konfigurieren

Bevor Sie eine Berechtigung mit Terraform erstellen können, stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:

• Stellen Sie sicher, dass Sie über den erforderlichen Zugriff verfügen, um Secrets Manager-Ressourcen erstellen und damit arbeiten zu können.
• Installieren Sie die Terraform-CLI und konfigurieren Sie das Provider-Plug-in IBM Cloud für Terraform. Weitere Informationen finden Sie im Lernprogramm zur Einführung in Terraform auf IBM Cloud. Das Plug-in abstrahiert die IBM Cloud APIs, die zur Erfüllung dieses Tasks verwendet werden.
• Erstellen Sie eine Terraform-Konfigurationsdatei mit dem Namen main.tf. In dieser Datei definieren Sie Ressourcen mithilfe der Konfigurationssprache HashiCorp. Weitere Informationen finden Sie in der Terraform-Dokumentation.

1. Nachdem Sie Ihre Konfigurationsdatei erstellt haben, initialisieren Sie die Terraform-CLI. Weitere Informationen finden Sie unter Arbeitsverzeichnisse initialisieren.

   terraform init
   

2. Erstellen Sie eine Secrets Manager-Instanz mithilfe des Ressourcenarguments ibm_resource_instance in Ihrer Datei main.tf.

   • Die Secrets Manager-Instanz im folgenden Beispiel hat den Namen secrets-manager-london und wird mit dem Testplan in der eu-gb-Region erstellt. user@ibm.com wird die Administratorrolle in der IAM-Zugriffsrichtlinie zugewiesen. Weitere unterstützte Regionen finden Sie unter Regionen und Endpunkte. Zu den Planoptionen gehören trial und standard.

       resource "ibm_resource_instance" "sm_instance" {
           name = "Secrets Manager-London"
           service = "secrets-manager"
           plan = "trial"
           location = "eu-gb"
           timeouts {
            create = "60m"
            delete = "2h"
        },
       }
   

   Eine vollständige Liste der unterstützten Attribute finden Sie unter ibm_resource_instance.

   Optional können Sie eine Datenquelle erstellen, um Informationen zu einer vorhandenen Instanz von Secrets Manager aus IBM Cloudabzurufen, indem Sie den folgenden Befehl ausführen:

        data "ibm_resource_instance" "sm_resource_instance" {
            name              = "Secrets Manager-London"
            location          = "eu-gb"
            service           = "secrets-manager"
        }
   

   Eine vollständige Liste der unterstützten Attribute finden Sie unter ibm_resource_instance.

3. Stellen Sie die Ressourcen aus der Datei main.tf bereit. Weitere Informationen finden Sie unter Infrastruktur mit Terraform bereitstellen.

   1. Führen Sie terraform plan aus, um einen Terraform-Ausführungsplan für die Vorschau der vorgeschlagenen Aktionen zu generieren.

        terraform plan
   

   2. Führen Sie terraform apply aus, um die Ressourcen zu erstellen, die im Plan definiert sind.

        terraform apply
   

4. Definieren Sie lokale Werte für Ihre Secrets Manager-Instanz, die beim Erstellen von Ressourcen verwendet werden sollen.

        locals {
            instance_id = data.ibm_resource_instance.sm_resource_instance.guid
            region = data.ibm_resource_instance.sm_resource_instance.location
        }
   

5. Wählen Sie in der Benutzeroberfläche unter „ IBM Cloud “ die von Ihnen erstellte „ Secrets Manager “-Instanz aus und notieren Sie sich die Instanz-ID.

6. Überprüfen Sie, ob die Zugriffsrichtlinie erfolgreich zugeordnet wurde. Weitere Informationen finden Sie unter Zugewiesene Zugriffsberechtigungen in der Konsole überprüfen.

Ressourcenabweichung verwalten

Mit Terraform können Sie den Lebenszyklus Ihrer Infrastruktur mithilfe deklarativer Konfigurationsdateien sicher und vorhersehbar verwalten. Eine Herausforderung, die besteht, wenn Sie Infrastruktur als Code verwalten, ist Drift. Eine Abweichung tritt auf, wenn Ressourcen hinzugefügt, gelöscht oder geändert werden, während Terraform-Konfigurationsänderungen angewendet werden. Beispiel: Wenn ein geheimer Schlüssel abläuft oder rotiert wird. Verwenden Sie zur Vermeidung von Abweichungen immer Terraform zum Verwalten von Ressourcen, die ursprünglich mit Terraform erstellt wurden.

Die Terraform-Statusdatei ist ein Datensatz aller Ressourcen, die von Terraform verwaltet werden. Sie dürfen keine manuellen Änderungen an Ressourcen vornehmen, die von Terraform gesteuert werden, da dadurch die Statusdatei aus der realen Infrastruktur nicht mehr synchron oder nicht mehr synchron ist. Wenn Ihr Status und Ihre Konfiguration nicht mit Ihrer Infrastruktur übereinstimmen, versucht Terraform, Ihre Infrastruktur abzustimmen. Dies kann dazu führen, dass Ressourcen versehentlich gelöscht oder erneut erstellt werden.

Wenn Sie den Terraform-Provider Secrets Manager verwenden, kann in folgenden Fällen eine Abweichung auftreten:

• Ablauf des geheimen Schlüssels
• Automatische Rotation geheimer Schlüssel
• Externe Änderungen an Secret Manager-Ressourcen, die von Terraform gesteuert werden

Wenn Sie Ihr Terraform-Projekt entwerfen, befolgen Sie die Terraform Best Practices für die Verwaltung von Drift und Lebenszyklusänderungen, um eine unbeabsichtigte Zerstörung oder Wiederherstellung von Secrets Manager Ressourcen zu vermeiden.

Weitere Schritte

Nachdem Sie nun erfolgreich Ihre erste Secrets Manager-Serviceinstanz mit Terraform in IBM Clouderstellt haben, können Sie die Secrets Manager-Ressourcen und -Datenquellen in der Terraform-Registryüberprüfen. Sie können auch prüfen, wie Sie Ihre Secrets Manager-Ressourcen verwalten, indem Sie die im Abschnitt 'Vorgehensweise' enthaltenen Terraform-Schritte ausführen. Sie können beispielsweise den Anweisungen zum Erstellen beliebiger geheimer Schlüssel mit Terraform folgen.

Für den Einsatz in der Produktion sollten Sie die IBM Cloud® Secrets Manager die unternehmenstaugliche Konfigurationen bietet. Erfahren Sie mehr über Terraform IBM Module.