Terraform -Module konfigurieren

Alle für diese Lösung erforderlichen Compute-, Netzwerk- und Speicherinfrastrukturressourcen sind in Terraform-Modulen definiert.

Bevor Sie beginnen

Bevor Sie mit der Konfiguration der Terraform-Module beginnen, führen Sie die folgenden Schritte aus:

  1. Hier erlernen Sie die Grundlagen von Terraform.

    Lesen Sie mindestens die Einführung in die Terrraform-Dokumentation.

  2. Folgende Informationen beibehalten:
    • Die OCID Ihres Mandanten.

      Sie finden die OCID Ihres Mandanten in der Oracle Cloud Infrastructure-Webkonsole. Wählen Sie im Menü "Services" die Option Administration, und klicken Sie dann auf Mandantendetails.

    • Die OCID des Benutzers, den Terraform zur Authentifizierung mit Oracle Cloud Infrastructure verwenden soll.

      Um die OCID des Benutzers zu suchen, wählen Sie im Menü Services die Option Identität und dann Benutzer. Suchen Sie Ihren Benutzernamen in der Liste, und kopieren Sie seine OCID.

    • Die OCID des Compartments, in dem Sie die Ressourcen erstellen möchten.

      Um die OCID eines Compartments zu suchen, wählen Sie im Menü "Services" die Option Identity, und wählen Sie dann Compartments. Suchen Sie das gewünschte Compartment in der Liste, und kopieren Sie dessen OCID.

    • Die ID des Bereichs, in dem Sie die Ressourcen erstellen möchten.

      Die ID der Region "US East (Ashburn)" ist z. B. us-ashburn-1.

      Siehe Regionen und Availability-Domains.

  3. Entscheiden Sie Folgendes:
  4. Stellen Sie sicher, dass die Servicelimits Ihres Mandanten alle Ressourcen berücksichtigen können, die Sie erstellen möchten.

Terraform -Code herunterladen

Der Terraform-Code für diese Lösung ist in GitHub verfügbar.

  1. Klicken Sie im Navigationsbereich auf der linken Seite auf Code herunterladen.
  2. Klicken Sie auf Git-Repository.
  3. Klonen Sie das Repository, oder laden Sie es auf Ihren lokalen Rechner herunter.

Informationen zum Terraform-Code

Der heruntergeladene Terraform-Code hat folgende Struktur:

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • _docs -Verzeichnis: Enthält die Architekturdiagramme.
  • *.tf: Die von der Lösung verwendeten Terraform-Konfigurationsdateien. Diese Dateien nicht bearbeiten.
  • env-vars: Ein Skript zum Festlegen der Umgebungsvariablen für Terraform.
  • LICENSE.md: Die Lizenzbedingungen für den Code.
  • modules: Verzeichnisse, die die Core-Terraform-Konfigurationen für die Ressourcen enthalten, die Sie mit dieser Lösung erstellen. Bearbeiten Sie sie nicht.
  • orm: Enthält eine ZIP-Datei, mit der Sie einen Stack in Oracle Cloud Infrastructure Resource Manager erstellen können, anstatt Terraform zur Bereitstellung der Lösung zu verwenden.
  • README.md: QuickStart-Dokumentation für den Code.
  • schema.yaml: Die Constraints und Validierungen für die im Terraform-Code verwendeten Variablen. Diese Datei wird verwendet, wenn Sie die Ressourcen mit Oracle Resource Manager bereitstellen. Bearbeiten Sie diese Datei nicht.
  • terraform.tfvars: Die Terraform-Variablen. Sie legen später Werte für die Variablen in dieser Datei fest.
  • userdata: Enthält ein Skript, das auf den Compute-Instanzen ausgeführt wird, nachdem sie erstellt wurden. Bearbeiten Sie die Dateien in diesem Verzeichnis nicht.

Terraform -Umgebungsvariablen festlegen

Der Terraform-Code umfasst eine Skriptdatei, mit der Sie Werte für bestimmte Terraform-Parameter als Umgebungsvariablen speichern können.

  1. Stellen Sie sicher, dass Sie die zuvor beschriebenen Voraussetzungen abgeschlossen haben.
  2. Navigieren Sie auf Ihrem lokalen Rechner zu dem Verzeichnis, in das Sie den Terraform-Code heruntergeladen haben.
  3. Suchen und öffnen Sie im Codeverzeichnis der obersten Ebene die Datei env-vars in einem Nur-Texteditor.
  4. Geben Sie die entsprechenden Werte für die Variablen in der Datei ein.

    Hinweis:

    Wenn Sie den Wert für jede Variable angeben, müssen Sie die Zeile entpacken. Dadurch wird das Hash-Zeichen # am Anfang der Zeile entfernt.
  5. Überprüfen Sie die angegebenen Werte.
    Wenn Sie Werte weglassen, werden Sie beim Ausführen von Terraform zur Eingabe aufgefordert. Wenn Sie falsche Werte angeben, wird ein Fehler von Terraform ausgegeben.
  6. Wenn Sie zufrieden sind, dass alle Werte korrekt sind, speichern und schließen Sie die Datei.
  7. Legen Sie die Umgebungsvariablen fest, indem Sie den folgenden Befehl aus dem Verzeichnis ausführen, das die Umgebungsvariablendatei enthält, indem Sie den folgenden Befehl ausführen:
    source ./env-vars
  8. Prüfen Sie, ob Sie alle Umgebungsvariablen festgelegt haben, indem Sie den folgenden Befehl ausführen:
    env | grep TF
    Die von Ihnen festgelegten Umgebungsvariablen werden angezeigt.

Deployment-Parameter festlegen

Geben Sie die zu erstellenden Compute-, Netzwerk-, Datenbank- und Speicherressourcen sowie deren Eigenschaften an.

  1. Stellen Sie sicher, dass Sie die zuvor beschriebenen Voraussetzungen abgeschlossen haben.
  2. Suchen Sie im Verzeichnis der obersten Ebene des Codes, den Sie heruntergeladen oder geklont haben, suchen Sie die Datei terraform.tfvars, und öffnen Sie sie in einem Nur-Text-Editor.
  3. Legen Sie Werte für die Variablen fest, die in terraform.tfvars aufgeführt werden.
    Die Datei README im heruntergeladenen Code enthält Beschreibungen für die Variablen und enthält ein Beispiel für eine abgeschlossene Datei terraform.tfvars.
  4. Speichern und schließen Sie terraform.tfvars.