Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Acesso programático
/
Infraestrutura como código

Introdução ao Terraform e ao provedor MongoDB Atlas

Nesta página

  • Pré-requisitos
  • Implemente o MongoDB Atlas com Terraform
  • Encerrar a Instância do MongoDB Atlas
  • Próximos passos

Você pode usar o Terraform para gerenciar sua infraestrutura do MongoDB Atlas como código com o provedor Atlas Terraform. O fornecedor Atlas Terraform automatiza os sistemas de infraestrutura simplificando o processo de provisionamento, gerenciamento e controle da infraestrutura do Atlas como código.

Este guia ensina como criar, modificar e destruir clusters do Atlas em uma organização e projeto MongoDB Atlas existente.

Depois de configurar um ambiente de teste, continue a experimentar uma infraestrutura gerenciada pelo Terraform com recursos adicionais do MongoDB e HashiCorp.

Pré-requisitos

Antes de implementar o MongoDB Atlas com Terraform, você deve:

  • Crie uma conta Atlas .

  • Obtenha o ID da organização da qual você é Organization Owner.

    Dica

    Você pode encontrar sua ID da organização na interface do usuário do Atlas , sob o General Settings da sua organização.

  • Configure uma chave de APIda organização Atlas .

  • Instale o Terraform.

Implemente o MongoDB Atlas com Terraform

1

Crie e navegue para um diretório vazio.

mkdir terraform-proj
cd terraform-proj
2

Crie seus arquivos de Terraform.

Crie os arquivos main.tf, provider.tf, variables.tf e versions.tf .

touch main.tf provider.tf variables.tf versions.tf
3

Preencha os arquivos de suporte.

Consulte o módulo atlas-basic e copie o conteúdo para os arquivos que você criou na etapa anterior (clique no link no Source Code para ver o conteúdo).

Observação

Sua chave pública e chave privada do Atlas são secretas. Considere armazená-los como variáveis de ambiente.

4

Configure o main.tf conteúdo de .

Atualize os seguintes campos no seu arquivo main.tf :

Campo
Novo valor
instance_size
"M0"
backing_provider_name
Seu provedor. Os valores possíveis são: "AWS", "AZURE" ou "GCP".
region_name
Consulte Provedores de nuvem e regiões para ver todas as regiões que você pode usar.
5

(Opcional) Parâmetros de exibição.

Você pode enviar informações da configuração do Terraform para a janela do terminal. Isso é útil para valores que você não saberá até que o Atlas crie os recursos, como sua string de conexão.

Se você quiser exibir seus parâmetros após distribuir o projeto, adicione algumas linhas de código de saída ao arquivo main.tf . Para obter um exemplo, consulte a publicação no blog do Terraform do MongoDB .

6

Inicialize seu projeto.

Para inicializar seu projeto, execute o seguinte comando:

terraform init

Este comando também baixa e instala o MongoDB Atlas Provider, se você ainda não o fez.

7

Visualize seu plano de execução.

Para visualizar seu plano de execução, execute o seguinte comando:

terraform plan

O Terraform detalha as mudanças que planeja fazer. Se a saída não for a que você espera, pode haver um problema no seu arquivo main.tf .

8

Implemente sua infraestrutura.

Para implantar sua infraestrutura, execute o seguinte comando:

terraform apply

Quando solicitado Do you want to perform these actions?, insira yes.

Observação

Novos recursos do Atlas podem levar alguns minutos para serem provisionados. O provedor Atlas Terraform atualiza você a cada dez segundos até que seja concluído.

Encerrar a Instância do MongoDB Atlas

Para excluir todos os recursos criados em seu diretório Terraform, execute o seguinte comando:

terraform destroy

Aviso

Se você excluir todos os seus recursos, não poderá recuperá-los.

Quando solicitado Do you really want to destroy all resources?, insira yes.

Próximos passos

Para explorar configurações mais avançadas, estenda os fundamentos abordados neste tutorial com recursos adicionais do Atlas , configurações do Atlas Terraform Provider e recursos do Terraform, consulte os seguintes recursos:

Voltar

Infraestrutura como código

Próximo

Migrar para clusters flexíveis