Criando um Arquivo de Configuração do Terraform
Saiba como criar um arquivo de configuração terraform com linguagem específica do domínio Terraform ou formato JSON se os arquivos precisarem ser legíveis por máquina.
O Terraform usa sintaxe declarativa para descrever a infraestrutura do Oracle Cloud Infrastructure (OCI) e depois continua utilizando-a em arquivos de configuração que podem ser compartilhados, revisados, editados, preservados, reutilizados, tudo isso com controle de versões. Consulte Sintaxe da Configuração. Os arquivos de configuração do Terraform podem usar um destes dois formatos: linguagem específica do domínio Terraform (formato HashiCorp Configuration Language [HCL]), que é o método recomendado, ou o formato JSON, se os arquivos precisarem ser legíveis por máquina. Arquivos de configuração que usam o formato HCL terminam com a extensão de arquivo .tf; aqueles que usam o formato JSON terminam com a extensão de arquivo .tf.json. O formato Terraform é legível por seres humanos, enquanto o formato JSON é legível por máquina.
Use as configurações do Terraform para definir recursos que sua solução ou aplicativo exige no momento da implantação. Os recursos podem criar objetos do Oracle Cloud Infrastructure, 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. Em seguida, o Terraform converte as suas configurações do Oracle Cloud Infrastructure em um conjunto de chamadas de API nos pontos finais de API do Oracle Cloud Infrastructure. O segredo para criar a configuração do Terraform é entender como abstrair a infraestrutura desejada conceitualmente na sintaxe de configuração do Terraform.
Dependendo do seu nível de experiência no desenvolvimento de Configurações do Terraform, você pode continuar com Conceitos Básicos de um Modelo de Pilha do Marketplace ou Criando suas próprias seções de Configurações do Terraform.
Conceitos Básicos de um Modelo de Pilha do Marketplace
Um conjunto de exemplos que permite que os editores do Oracle Cloud Infrastructure Marketplace obtenham um início rápido na implantação de Aplicativos no Oracle Cloud Infrastructure está disponível no Modelo de Início Rápido do OCI. Este repositório contém o modelo que pode ser usado para acelerar a construção de Pilhas executadas na CLI local do Terraform, no OCI Resource Manager e no Cloud Shell.
Recomendamos começar criando um clone do repositório oci-quickstart-template:
$> git clone https://github.com/oracle-quickstart/oci-quickstart-template.git $> cd oci-quickstart-template
Os arquivos de configuração do Terraform (.tf) têm requisitos específicos, dependendo dos componentes definidos no arquivo. Por exemplo, você pode ter seu provedor Terraform definido em um arquivo (provider.tf), suas variáveis definidas em outro arquivo (variables.tf), e suas origens de dados ainda definidas em outro arquivo. O modelo Pilha de Início Rápido do Marketplace agrupa recursos semelhantes em arquivos individuais, mas observe que o layout do sistema de arquivos é apenas uma referência de amostra.
Implantar uma Instância com uma Imagem Personalizada
Para criar uma instância com base em uma imagem personalizada, siga estas etapas:
-
Localize o recurso oci_core_instance no arquivo compute.tf e defina source_details como local.compute_image_id no modelo oci-quickstart-template que você acabou de clonar. A variável local local.compute_image_id pode ser definida como um ocid de imagem personalizado ou um ocid de imagem de marketplace. com base no flag mp_subscription_enable.
-
Modifique o valor do atributo padrão da variável compute_image_id variables.tf para o OCID da imagem personalizada que você criou seguindo a Tarefa 2 em Criando uma Listagem de Pilhas do OCI no Portal do Parceiro.
Criando sua própria Pilha do Marketplace
O repositório oci-quickstart-template serve como ponto de partida para suas configurações do Terraform, mas não limita você a criar seu próprio Infrastrucutre como Código. Para obter referência a mais exemplos, consulte o Provedor Terraform do Oracle Cloud Infrastructure para OCI: terraform-provider-OCI/docs/examples. Certifique-se de que seus arquivos do Terraform estejam em conformidade com as Diretrizes para Pilhas do Marketplace.