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 API da 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 connection string.

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 postagem do blog do MongoDB Terraform .

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