Conceitos Básicos

O Terraform é o software "infrastructure-as-code" que permite definir os seus recursos do Oracle Cloud Infrastructure (OCI) em arquivos que podem ter persistência, controle de versão e compartilhamento. Esses arquivos descrevem as etapas necessárias para provisionar a infraestrutura e manter o estado desejado:

Os recursos podem criar objetos de infraestrutura do OCI, como redes virtuais na nuvem ou instâncias de computação. Seu primeiro aplicativo da configuração cria os objetos e os aplicativos subsequentes podem atualizá-los ou excluí-los.

As origens de dados representam views somente para leitura da infraestrutura existente do OCI.

As variáveis representam parâmetros do Terraform.

O Terraform então executa essas etapas e desenvolve a infraestrutura descrita. O uso do provedor Terraform do OCI exige que você:

Instale ou acesse uma distribuição do Terraform.
Faça download e instale o provedor Terraform do OCI.
Configure o provedor Terraform do OCI.
Descreva sua infraestrutura como código.

Instalando o Provedor

Para usar o provedor Terraform do Oracle Cloud Infrastructure (OCI), instale o Terraform e o provedor Terraform do OCI. Você pode instalar o Terraform e o provedor Terraform do OCI com o yum ou baixar diretamente o Terraform e o provedor Terraform.

Os clientes do Government Cloud devem seguir as etapas de instalação e configuração em Ativando a Compatibilidade com FIPS.

Dica

Você pode usar o Gerenciador de Recursos para pré-instalar o Oracle Cloud Development Kit em uma instância do serviço Compute no compartimento. O Oracle Cloud Development Kit inclui o Terraform e o provedor Terraform e pré-configura a autorização necessária.

Após o download e a instalação, configure o provedor Terraform para que o Terraform possa interagir com os recursos do OCI.

Pré-requisitos para Instalar e Usar o Provedor

Uma conta do Oracle Cloud Infrastructure (OCI) que tem credenciais de usuário suficientes para executar um plano do Terraform.
Um usuário nessa conta.
Chaves necessárias e IDs do OCI (OCIDs). Para obter orientação, consulte Chaves e OCIDs Necessários.
O arquivo binário correto do Terraform correto para o sistema operacional. Recomendamos o uso do Terraform versão 0.12.20 ou superior.

Instalando o Terraform e o Provedor Terraform com o Yum

Se você estiver executando o Oracle Linux 7, poderá usar o yum para instalar o Terraform e o provedor Terraform do OCI.

Para usar o yum para instalar o Terraform:

sudo yum install terraform

Para usar o yum para instalar o provedor Terraform:

sudo yum install terraform-provider-oci

Fazer o Download do Terraform e Instalá-lo

Se você não estiver usando o Oracle Linux, poderá fazer download do Terraform na página de download do HashiCorp diretamente. Certifique-se de fazer o download do arquivo binário correto para o seu sistema.

Fazer Download e Instalar o Provedor

Para usar a versão mais recente do provedor Terraform do OCI, execute terraform init no diretório que contém o arquivo de configuração com o bloco de configuração provider "oci" { ....

Você também pode fazer download do provedor Terraform diretamente para um local de sua escolha.

Testar a Instalação do Terraform

Abra uma janela de terminal e execute o seguinte comando para testar sua instalação:

terraform -v