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ê é o
Organization Owner.Dica
Você pode encontrar sua ID da organização na interface do usuário do Atlas, sob o General Settingsda sua organização.
Configure uma autenticação de conta de serviço (SA). O role de Proprietário da organização é necessário para visualizar o ID da organização, gerenciar contas de serviço e criar ou excluir clusters e outros recursos do projeto .
Instale Terraform.
Implemente o MongoDB Atlas com Terraform
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.
Configure o main.tf conteúdo de.
Atualize os seguintes campos no seu arquivo main.tf :
Campo | Novo valor |
|---|---|
|
|
| Seu provedor. Os valores possíveis são: |
| Consulte Provedores de nuvem e regiões para ver todas as regiões que você pode usar. |
(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 implantar o projeto, adicione algumas linhas de código de saída ao arquivo main.tf.
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.
Verificar a implantação
Depois que terraform apply for concluído, confirme se o cluster está implantado.
Um novo cluster aparece na IU do Atlas em seu projeto.
Se você adicionou valores de saída a
main.tf, a string de conexão aparecerá na saída do Terraform.
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
Depois de implantar seu cluster, você pode:
Criar uma organização e projeto: Se você é novo no Atlas, consulte Gerenciar Organizações e Projetos.
Explore configurações avançadas: Revise o módulo atlas-basic e a documentação do Atlas Terraform Provider para configurações mais completas.
Conecte-se ao cluster: Use a string de conexão do objeto cluster ou dos valores de saída do Terraform.
Recursos adicionais: