Terraform Terraform Terraform Terraform Terraform Terraform Terraform Terraform Erstellen einer Megaport Terraform-Provider-Konfigurationsdatei

Erstellen einer Megaport Terraform Provider-Konfigurationsdatei

Dieses Thema bietet eine schrittweise Anleitung zur Vorbereitung einer Megaport Terraform Provider-Konfigurationsdatei, basierend auf gängigen und bewährten Methoden, die von Megaport Solution Architects durch Kundenprojekte identifiziert wurden.

Bevor Sie beginnen, führen Sie die in Erste Schritte mit dem Megaport Terraform Provider beschriebenen Voraussetzungen aus.

Erstellen einer Konfigurationsdatei

Wenn Ihr Netzwerkdesign fertig ist, können Sie ausführbare Terraform-Konfigurationsdateien erstellen, um das Design anhand der folgenden Schritte bereitzustellen.

So erstellen Sie eine Konfigurationsdatei

Entwerfen Sie Ihr Netzwerk mit Megaport-Services.

Beispiel-Megaport Terraform Provider-Konfigurationsdateien sind im Megaport Terraform Provider GitHub repository verfügbar.

Megaport bietet außerdem Erläuterungen zu häufigen Multicloud-Konnektivitätsszenarien. Beispiel-Megaport Terraform Provider-Konfigurationsdateien zu gängigen Multicloud-Konnektivitätsszenarien finden Sie auf der Megaport Terraform Provider GitHub examples page.
Ermitteln Sie die von Megaport unterstützte Standort-ID.

Namen von Rechenzentrumsstandorten und Standortcodes können sich in der API gelegentlich ändern. Für zuverlässige und stabile Megaport Terraform Provider-Konfigurationen verwenden Sie die Standort-ID anstelle von Namen oder Codes. Die aktuellste Auflistung der Megaport-Rechenzentrumsstandorte ist über die GET /v3/locations Megaport API abrufbar.
Definieren Sie die Megaport Terraform Provider-Umgebung.

Es gibt mehrere Möglichkeiten, Terraform-Verzeichnisse und Konfigurationsdateien (.tf-Dateien) zu verwalten. Sie müssen die effektivste Methode festlegen, um Ihre Terraform-Ressourcen entsprechend Ihren Anforderungen zu verwalten.

Das folgende Beispiel zeigt, wie Sie Terraform-Konfigurationsdateien übersichtlich ablegen könnten.
- Erstellen Sie ein Verzeichnis, um einen Satz von Terraform-Konfigurationsdateien für die Verwaltung bestimmter Megaport-Services aufzubewahren, beispielsweise Port, MCR, VXC.
- Erstellen Sie eine provider.tf-Datei, die die Megaport Terraform Provider-Umgebung deklariert.
  
  Hinweis
  
  Sie können Einstellungen anderer Provider, wie AWS, Azure und GCP, in der provider.tf-Datei definieren. Weitere Informationen finden Sie unter Build Infrastructure (HashiCorp).
- Bewahren Sie dieprovider.tf-Datei im selben Verzeichnis auf, in dem andere Terraform-Konfigurationsdateien gespeichert sind. Das folgende Beispiel zeigt die provider.tf-Datei mit den Megaport Terraform Provider-bezogenen Konfigurationen:
```
terraform {
  required_providers {
    megaport = {
      source = "megaport/megaport"
        version = ">= 1.4.1"
    }
  }
}
provider "megaport" {
  environment           = "staging"
  access_key            = "access_key"
  secret_key            = "secret_Key"
  accept_purchase_terms = true
}
```
  Hinweis
  
  Es gibt einige wichtige Felder und Informationen, die Sie definieren müssen, um die Megaport Terraform Provider-Konfigurationsdatei zu konfigurieren.
  - Version – Megaport testet gegen die zwei neuesten Hauptversionen von Terraform. Die neueste Version des Megaport Terraform Provider finden Sie in der Megaport Terraform Provider Registry documentation. Wir empfehlen nachdrücklich, die provider.tf-Datei mit der neuesten Versionsnummer aktuell zu halten.
  - Environment – Dies definiert die Umgebung, in der Sie Services mit Terraform bereitstellen werden. Wenn dieser Wert beispielsweise auf staging gesetzt ist, werden die Services in der Umgebung https://portal-staging.megaport.com/ erstellt. Wenn Sie die Tests in der Staging-Umgebung abgeschlossen haben und mit der Bereitstellung von Services in der Produktionsumgebung beginnen möchten, setzen Sie diesen Wert auf production. Weitere Informationen finden Sie unter Umgebungen.
  - API key – Sie müssen einen API-Schlüssel erstellen, bevor Sie den Megaport Terraform Provider verwenden können. Der API-Schlüssel besteht aus den Werten access_key und secret_key. API-Schlüssel sind nur in der Umgebung gültig, in der sie erstellt wurden. Wenn Sie einen API-Schlüssel für den Zugriff auf eine andere Umgebung benötigen, melden Sie sich in der Megaport Portal dieser Umgebung an und erstellen Sie dort den API-Schlüssel. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.
  - Kaufbedingungen akzeptieren – Um Megaport-Services mit Terraform zu bestellen, müssen Sie die Kaufbedingungen akzeptieren. Dadurch wird ein abrechenbares Ereignis in der Produktionsumgebung ermöglicht, das heißt, Megaport-Services in der Produktionsumgebung zu erstellen und bereitzustellen, die Kosten verursachen.
Erstellen Sie die main.tf-Datei, die Ihre Infrastruktur deklariert. Kopieren Sie dann die Beispielkonfiguration, die einem Ihrem Netzwerkdesign am nächsten kommt, und passen Sie sie in der main.tf-Datei nach Bedarf an.

Beispielkonfigurationen finden Sie im Megaport Terraform Provider GitHub repository.

Das folgende Beispiel zeigt eine Megaport Terraform Provider-Konfiguration zum Bestellen eines einzelnen Port.
```
data "megaport_location" "location_1" {
  name = "NextDC B1"
}

resource "megaport_port" "port" {
  product_name           = "Megaport Port Example"
  port_speed             = 10000
  location_id            = 5
  contract_term_months   = 1
  marketplace_visibility = false
}
```
Beim Bereitstellen von Terraform wird zuerst die provider.tf ausgeführt. Anschließend wird main.tf automatisch zusammen mit allen anderen Terraform-Konfigurationsdateien ausgeführt, die im selben Verzeichnis gespeichert sind.
Wenn Sie Terraform zum ersten Mal verwenden, führen Sie im entsprechenden Verzeichnis den Befehl terraform init aus, um das Arbeitsverzeichnis mit Terraform-Konfigurationsdateien vorzubereiten.

Dieser Befehl führt mehrere Einrichtungsschritte aus, wie das Herunterladen des Megaport Terraform Provider und anderer Backend-Plugins, um Ihr Arbeitsverzeichnis für die Verwendung mit Terraform vorzubereiten.

Um diesen Befehl auszuführen, muss das Verzeichnis zunächst Terraform-Konfigurationsdateien enthalten. Es ist unbedenklich, diesen Befehl mehrfach auszuführen, um das Arbeitsverzeichnis mit Änderungen an der Konfiguration auf den neuesten Stand zu bringen.

Das folgende Bild zeigt eine Beispielausgabe des Befehls terraform init.

Weitere Informationen finden Sie unter terraform init command (HashiCorp).

Nächste Schritte

Nachdem Sie die Terraform-Konfigurationsdateien vorbereitet haben, können Sie diese zunächst in der Staging-Umgebung bereitstellen, bevor Sie sie in der Produktionsumgebung anwenden.

Weitere Informationen finden Sie unter Erstellen und Verwalten von Services mit dem Megaport Terraform Provider.

Erstellen einer Megaport Terraform Provider-Konfigurationsdatei

Erstellen einer Konfigurationsdatei

Nächste Schritte

Hilfreiche Referenzen