Terraform für Direct Link konfigurieren

Terraform auf IBM Cloud® ermöglicht die vorhersehbare und konsistente Erstellung von IBM Cloud Diensten, so dass Sie schnell komplexe, mehrschichtige Cloud-Umgebungen aufbauen können, die den Prinzipien von Infrastructure as Code ( IaC ) folgen. Ähnlich wie bei der Verwendung der IBM Cloud CLI oder API und SDKs können Sie die Erstellung, Aktualisierung und Löschung Ihrer Direct Link Instanzen mithilfe der HashiCorp Configuration Language (HCL) automatisieren.

Suchen Sie eine verwaltete Lösung für Terraform on IBM Cloud®? Probieren Sie IBM Cloud® Schematics aus. Mit Schematics können Sie die Terraform-Skriptsprache verwenden, mit der Sie vertraut sind. Sie müssen sich nicht um die Einrichtung und Pflege der Terraform-Befehlszeile und des IBM Cloud® Provider-Plug-ins kümmern. Schematics bietet auch vordefinierte Terraform-Vorlagen, die Sie einfach aus dem IBM Cloud® Katalog installieren können.

Installation von Terraform und Konfiguration von Ressourcen für Direct Link

Bevor Sie eine Autorisierung mit Terraform erstellen können, müssen Sie folgende Schritte durchführen:

  • Vergewissern Sie sich, dass Sie über die erforderlichen Zugriffsrechte verfügen, um Direct Link Ressourcen zu erstellen und mit ihnen zu arbeiten.
  • Installieren Sie die Terraform CLI und konfigurieren Sie das IBM Cloud Provider Plug-in für Terraform. Weitere Informationen finden Sie in der Anleitung zu den ersten Schritten mit 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. Fügen Sie in dieser Datei die Konfiguration zum Erstellen einer Autorisierung zwischen Services mithilfe von HashiCorp Configuration Language hinzu. Weitere Informationen finden Sie in der Terraform-Dokumentation.
  1. In Ihrer Terraform-Konfigurationsdatei finden Sie den Terraform-Code, mit dem Sie die Instanz Direct Link erstellt haben.

  2. Erstellen Sie eine Direct Link Instanz, indem Sie das ibm_resource_instance Ressourcenargument in Ihrer main.tf Datei verwenden. Die Zone Direct Link im folgenden Beispiel heißt Gateway1. Der Name der Direct Link-Ressource im folgenden Beispiel lautet test_dl_routers; sie wird als Dedicated Gateway an Standort dal10 erstellt.

    Weitere Informationen über Argumente und Attribute finden Sie im ibm_dl_gateway verwendungsbeispiel.

    data "ibm_dl_routers" "test_dl_routers" {
            offering_type = "dedicated"
            location_name = "dal10"
        }
    
    resource "ibm_dl_gateway" "test_dl_gateway" {
      bgp_asn =  64999
      global = true
      metered = false
      name = "Gateway1"
      resource_group = "bf823d4f45b64ceaa4671bee0479346e"
      speed_mbps = 1000
      type =  "dedicated"
      cross_connect_router = data.ibm_dl_routers.test_dl_routers.cross_connect_routers[0].router_name
      location_name = data.ibm_dl_routers.test_dl_routers.location_name
      customer_name = "Customer1"
      carrier_name = "Carrier1"
    
    }
    
  3. Nachdem Sie Ihre Konfigurationsdatei erstellt haben, initialisieren Sie die Terraform CLI. Weitere Informationen finden Sie unter Initialisierung von Arbeitsverzeichnissen.

    terraform init
    
  4. Bereitstellung der Ressourcen aus der Datei main.tf. Weitere Informationen finden Sie unter Bereitstellung der Infrastruktur mit Terraform.

    1. Führen Sie terraform plan aus, um einen Terraform-Ausführungsplan zu erstellen und eine Vorschau der vorgeschlagenen Aktionen zu erhalten.

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

      terraform apply
      
  5. Wählen Sie in der Ressourcenliste IBM Cloud die von Ihnen erstellte Instanz Direct Link 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.

Weitere Schritte

Nachdem Sie nun erfolgreich Ihre erste Direct Link Service-Instanz mit Terraform auf IBM Cloud erstellt haben, können Sie die Direct Link Direct Link Terraform-Registry besuchen, um weitere Aufgaben mit Terraform durchzuführen.