Oracle Cloud Infrastructure - Dokumentation

Erste Schritte mit dem Terraform-Provider

Erfahren Sie mehr über die Terraform-Software und den OCI-Terraform-Provider.

Terraform ist eine Infrastructure-as-code-Software, mit der Sie OCI-Ressourcen in Dateien definieren können, die Sie persistieren, versionieren und freigeben können. In diesen Dateien werden die Schritte beschrieben, die erforderlich sind, um die Infrastruktur bereitzustellen und ihren Status zu verwalten:

  • Ressourcen erstellen OCI-Infrastrukturobjekte, wie virtuelle Cloud-Netzwerke oder Compute-Instanzen. Die erste Anwendung der Konfiguration erstellt die Objekte, und spätere Anwendungen aktualisieren oder löschen sie.
  • Datenquellen sind schreibgeschützte Ansichten der vorhandenen OCI-Infrastruktur.
  • Variablen stellen Parameter für Terraform dar.
Achtung

Terraform-Statusdateien enthalten alle Ressourcenattribute, die als Teil von Konfigurationsdateien angegeben sind. Wenn Sie sensible Daten mit Terraform verwalten, wie Datenbank- oder Benutzerkennwörter oder Private Keys für Instanzen, behandeln Sie die Statusdatei selbst als sensible Daten. Weitere Informationen finden Sie unter sensible Daten speichern.

Erste Schritte

Für die ersten Schritte können Sie unsere Terraform-Providertutorials aufrufen, um detaillierte Anweisungen und Beispiele anzuzeigen. Auf den folgenden Seiten finden Sie die Schritte zum Installieren und Konfigurieren des OCI-Terraform-Providers:

  1. Installieren Sie eine Distribution von Terraform und dem OCI-Terraform-Provider, oder greifen Sie darauf zu.
  2. Konfigurieren Sie den OCI-Terraform-Provider.
  3. Beschreiben Sie Ihre Infrastructure-as-Code-Konfiguration.
  4. Übernehmen Sie Ihre Konfigurationen mit Terraform.

Verwendungsbeispiel

Terraform führt die Schritte aus und erstellt die Infrastruktur, die Sie in Konfigurationsdateien beschreiben.

Beispiel: Wenn die folgende Konfiguration angewendet wird, verbindet sich Terraform mit Ihrem Mandanten und ruft eine Liste seiner Availability-Domains ab. Da in dieser Konfiguration keine Ressourcen definiert sind, wird keine Infrastruktur erstellt oder geändert.

# Configure the OCI provider with an API Key
# tenancy_ocid is the compartment OCID for the root compartment
provider "oci" {
  tenancy_ocid = var.tenancy_ocid
  user_ocid = var.user_ocid
  fingerprint = var.fingerprint
  private_key_path = var.private_key_path
  region = var.region
}

# Get a list of Availability Domains
data "oci_identity_availability_domains" "ads" {
  compartment_id = var.tenancy_ocid
}

# Output the result
output "show-ads" {
  value = data.oci_identity_availability_domains.ads.availability_domains
}

Weitere Informationen über die Terraform-Konfigurationsanforderungen finden Sie unter Konfigurationen erstellen.