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 qualquer dado confidencial com Terraform, como senhas de banco de dados ou de usuário ou chaves privadas de instância, trate o arquivo de estado em si 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.