オーサリング構成

次のTerraform構文の使用例では、OCI Terraformプロバイダ定義の要件を示し、さらに関連する変数定義も示しています。プロバイダ定義では、構成ファイル自体に機密データが含まれないように変数が利用されます。機密データが含まれていると、構成ファイルの交換時または共有時にセキュリティ・リスクが発生します。

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

region属性は、プロバイダ・リソースが作成される地理的リージョンを指定します。単一の構成で複数のリージョンを対象にするには、各リージョンのプロバイダ定義を作成してから、次の例に示すようにプロバイダの別名を使用して区別します。「oci」という名前のプロバイダが1つのみ定義されていますが、ociプロバイダ定義は、us-phoenix-1リージョン(別名「phx」)に対して1回とus-ashburn-1リージョン(別名「iad」)に対して1回、計2回入力されています。

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

詳細は、Provider Configurationを参照してください。

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
}

詳細は、入力変数を参照してください。

出力変数によって、Terraformエンド・ユーザー問合せをサポートする手段が提供されます。ユーザーは、これによって、複雑なインフラストラクチャに関連する潜在的な大量データから、意味のあるデータを抽出できます。たとえば、どのような時点でも関心を持つ重要な値はごく少数しかありません。出力変数を定義することによって、必要な情報を正確に抽出できます。

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

詳細は、Output Variablesを参照してください。Output Configurationも参照してください。

リソースは、Oracle Cloud Infrastructureのコンポーネントです。このようなリソースには、下位レベルのコンポーネント(物理サーバーや仮想サーバーなど)から上位レベルのコンポーネント(電子メール・プロバイダ、データベース・プロバイダ、DNSレコードなど)まですべてが含まれます。

データ・ソースは、既存インフラストラクチャの読取り専用ビューを表し、Terraform構成でセマンティックとしての使用を対象としています。次のデータソース構成の単純な例は、基本的な構造を示しています:

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

詳細は、Data Source Configurationを参照してください。