Konfigurationen verfassen

Das folgende Beispiel, das die Terraform-Syntax verwendet, veranschaulicht die Anforderungen für eine OCI-Terraform-Providerdefinition und zeigt auch zugehörige Variablendefinitionen. Die Providerdefinition hängt von Variablen ab, damit die Konfigurationsdatei selbst keine sensiblen Daten enthält. Das Einbeziehen sensibler Daten stellt ein Sicherheitsrisiko beim Austausch oder Freigeben von Konfigurationsdateien dar.

variable "tenancy_ocid" {}
variable "user_ocid" {}
variable "fingerprint" {}
variable "private_key_path" {}
variable "region" {}

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}"
}

Das Attribut region gibt die geografische Region an, in der die Providerressourcen erstellt werden. Um mehrere Regionen in einer einzelnen Konfiguration als Ziel zuzuweisen, erstellen Sie einfach eine Providerdefinition für jede Region, und differenzieren Sie dann mithilfe eines Provideralias, wie im folgenden Beispiel dargestellt. Beachten Sie, dass nur ein Provider mit dem Namen oci definiert ist, die Providerdefinition oci jedoch zweimal eingegeben wird, einmal für die Region us-phoenix-1 (mit dem Alias phx) und einmal für die Region us-ashburn-1 (mit dem Alias "iad").

variable "tenancy_ocid" {}
variable "user_ocid" {}
variable "fingerprint" {}
variable "private_key_path" {}
variable "compartment_ocid" {}

provider "oci" {
   region = "us-phoenix-1"
   alias = "phx"
   tenancy_ocid = "${var.tenancy_ocid}"
   user_ocid = "${var.user_ocid}"
   fingerprint = "${var.fingerprint}"
   private_key_path = "${var.private_key_path}"
}

provider "oci" {
   region = "us-ashburn-1"
   alias = "iad"
   tenancy_ocid = "${var.tenancy_ocid}"
   user_ocid = "${var.user_ocid}"
   fingerprint = "${var.fingerprint}"
   private_key_path = "${var.private_key_path}"
}

Weitere Informationen finden Sie unter Providerkonfiguration.

variable "tenancy_ocid" {}
variable "user_ocid" {}
variable "fingerprint" {}
variable "private_key_path" {}
variable "region" {}

variable "AD" {
    default     = "1"
    description = "Availability Domain"
}

variable "CPUCoreCount" {
    default = "2"
    type    = string
}

Weitere Informationen finden Sie unter Eingabevariablen.

Mit Ausgabevariablen können Terraform-Endbenutzerabfragen unterstützt werden. Mit Ausgabevariablen können Sie sinnvolle Daten aus den potenziell umfangreichen Daten extrahieren, die mit einer komplexen Infrastruktur verknüpft sind. Beispiel: Sie sind zu einem bestimmten Zeitpunkt nur an einigen wenigen Schlüsselwerten interessiert, und wenn Sie Ausgabevariablen definieren, können Sie genau die erforderlichen Informationen extrahieren.

# Output the private and public IPs of the instance
output "InstancePrivateIPs" {
value = ["${oci_core_instance.TFInstance.*.private_ip}"]
}

output "InstancePublicIPs" {
value = ["${oci_core_instance.TFInstance.*.public_ip}"]
}

# Output the boot volume IDs of the instance
output "BootVolumeIDs" {
  value = ["${oci_core_instance.TFInstance.*.boot_volume_id}"]
}

Weitere Informationen finden Sie unter Daten aus Terraform ausgeben. Siehe auch Ausgabewerte.

Ressourcen sind Komponenten von Oracle Cloud Infrastructure. Diese Ressourcen umfassen alles von Komponenten niedriger Ebenen, wie physischen und virtuellen Servern, bis hin zu Komponenten höherer Ebenen, wie E-Mail- und Datenbankprovidern oder Ihrem DNS-Datensatz.

Datenquellen stellen schreibgeschützte Ansichten vorhandener Infrastruktur dar, die für die semantische Verwendung in Terraform-Konfigurationen vorgesehen ist. Im Folgenden finden Sie ein einfaches Beispiel für eine Datenquellenkonfiguration, um die grundlegende Struktur zu veranschaulichen:

# Gets a list of Availability Domains
data "oci_identity_availability_domains" "ADs" {
  compartment_id = "${var.tenancy_ocid}"
}

# Get DB node list
data "oci_database_db_nodes" "DBNodeList" {
  compartment_id = "${var.compartment_ocid}"
  db_system_id = "${oci_database_db_system.TFDBNode.id}"
}

# Get DB node details
data "oci_database_db_node" "DBNodeDetails" {
  db_node_id = "${lookup(data.oci_database_db_nodes.DBNodeList.db_nodes[0], "id")}"
}

# Gets the OCID of the first (default) vNIC
data "oci_core_vnic" "DBNodeVnic" {
  vnic_id = "${data.oci_database_db_node.DBNodeDetails.vnic_id}"
}

Weitere Informationen finden Sie unter Datenquellen.