Documentação do Oracle Cloud Infrastructure

Conceitos Básicos do Provedor Terraform

Saiba mais sobre o software Terraform e o provedor Terraform do OCI.

O Terraform é um software "infrastructure-as-code" que permite definir recursos do OCI em arquivos que você pode persistir, controlar versões e compartilhar. Esses arquivos descrevem as etapas necessárias para provisionar infraestrutura e manter seu estado:

  • Os recursos criam objetos de infraestrutura da OCI, como redes virtuais na nuvem ou instâncias de computação. O primeiro aplicativo da configuração cria os objetos e, posteriormente, os aplicativos os atualizam ou excluem.
  • As origens de dados representam views somente para leitura da infraestrutura existente do OCI.
  • As Variáveis representam parâmetros para o Terraform.
Cuidado

Os arquivos do estado Terraform contêm todos os atributos do recurso que são especificados como parte dos arquivos do serviço. Se você gerenciar dados confidenciais com o Terraform, como senhas de banco de dados ou de usuário ou chaves privadas da instância, trate o próprio arquivo de estado como dados confidenciais. Para obter mais informações, consulte Armazenando Dados Confidenciais.

Exemplo de Uso

O Terraform executa as etapas e cria a infraestrutura que você descreve nos arquivos de configuração.

Por exemplo, quando a configuração a seguir é aplicada, o Terraform estabelece conexão com a tenancy e recupera uma lista de domínios de disponibilidade. Como nenhum recurso está definido nessa configuração, nenhuma infraestrutura é criada ou modificada.

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

Para obter mais informações sobre os requisitos de configuração do Terraform, consulte Criando Configurações.