Configurar os Módulos Terraform

Todos os recursos de infraestrutura de computação, rede e armazenamento necessários para esta solução são definidos nos módulos Terraform.

Antes de Começar

Antes de iniciar a configuração dos módulos Terraform, execute as seguintes etapas:

  1. Aprenda os conceitos básicos do Terraform.

    No mínimo, leia a introdução na documentação do Terrraform.

  2. Mantenha as seguintes informações prontas:
    • O OCID da sua tenancy.

      Você pode localizar o OCID de sua tenancy na console web do Oracle Cloud Infrastructure. Selecione Administração no menu de serviços e, em seguida, clique em Detalhes da Tenancy.

    • O OCID do usuário que você deseja que o Terraform use para autenticação com o Oracle Cloud Infrastructure.

      Para localizar o OCID do usuário, selecione Identidade no menu de serviços e, em seguida, selecione Usuários. Localize seu nome de usuário na lista e copie seu OCID.

    • O OCID do compartimento no qual você deseja criar os recursos.

      Para localizar o OCID de um compartimento, selecione Identidade no menu de serviços e, em seguida, selecione Compartimentos. Localize o compartimento que você precisa na lista e copie seu OCID.

    • O ID da região em que você deseja criar os recursos.

      Por exemplo, o ID da região Leste dos EUA (Ashburn) é us-ashburn-1.

      Consulte Regiões e Domínios de Disponibilidade.

  3. Decida o seguinte:
  4. Verifique se os limites de serviço da sua tenancy podem acomodar todos os recursos que você deseja criar.

Fazer Download do Código do Terraform

O código do Terraform para esta solução está disponível no GitHub.

  1. No painel de navegação à esquerda, clique em Fazer Download do Código.
  2. Clique em Repositório Git.
  3. Clonar ou fazer download do repositório para seu computador local.

Sobre o Código Terraform

O código do Terraform que você transferiu por download tem a seguinte estrutura:

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • Diretório _docs: Contém os diagramas da arquitetura.
  • *.tf: Os arquivos de configuração do Terraform que a solução usa. Não edite esses arquivos.
  • env-vars: Um script para definir as variáveis de ambiente para o Terraform.
  • LICENSE.md: Os termos da licença para o código.
  • modules: Diretórios que contêm as configurações do Terraform principal para os recursos que você cria usando esta solução. Não editá-los.
  • orm: Contém um arquivo zip que você pode usar para criar uma pilha no Oracle Cloud Infrastructure Resource Manager, em vez de usar o Terraform para implantar a solução.
  • README.md: Documentação de início rápido do código.
  • schema.yaml: As restrições e validações das variáveis usadas no código Terraform. Esse arquivo é usado quando você implanta os recursos usando o Oracle Resource Manager. Não editar este arquivo.
  • terraform.tfvars: As variáveis do Terraform. Você definirá valores para as variáveis neste arquivo posteriormente.
  • userdata: Contém um script que é executado nas instâncias de computação após elas serem criadas. Não edite os arquivos neste diretório.

Definir as Variáveis de Ambiente do Terraform

O código Terraform inclui um arquivo de script que você pode usar para armazenar valores de alguns parâmetros Terraform como variáveis de ambiente.

  1. Certifique-se de concluir os pré-requisitos descritos anteriormente.
  2. No computador local, vá para o diretório em que você fez download do código Terraform.
  3. No diretório de nível superior do código, localize e abra o arquivo env-vars em um editor de texto sem formatação.
  4. Informe os valores apropriados para as variáveis do arquivo.

    Observação:

    Ao especificar o valor de cada variável, lembre-se de remover o comentário da linha; isto é, remover o caractere # (hash) no início da linha.
  5. Verifique os valores especificados.
    Se omitir qualquer valor, será solicitado que você insira uma entrada ao executar o Terraform. Se você fornecer valores incorretos, o Terraform gerará erro.
  6. Quando estiver satisfeito com todos os valores, salve e feche o arquivo.
  7. Defina as variáveis de ambiente executando o seguinte comando do diretório que contém o arquivo de variáveis de ambiente, executando o seguinte comando:
    source ./env-vars
  8. Verifique se você definiu todas as variáveis de ambiente, executando o seguinte comando:
    env | grep TF
    As variáveis de ambiente definidas são exibidas.

Definir os Parâmetros de Implantação

Especifique os recursos de computação, rede, banco de dados e armazenamento a serem criados e suas propriedades.

  1. Certifique-se de concluir os pré-requisitos descritos anteriormente.
  2. No diretório de nível superior do código transferido por download ou clonado, localize o arquivo terraform.tfvars e abra-o em um editor de texto sem formatação.
  3. Defina valores para as variáveis listadas em terraform.tfvars.
    O arquivo README no código que você transferiu por download contém descrições das variáveis e inclui uma amostra de um arquivo terraform.tfvars concluído.
  4. Salve e feche terraform.tfvars.