Automações de teste com projetos e clusters temporários

Crie um usuário de banco de dados temporário de projeto , cluster e banco de dados.

Execute os seguintes comandos do Atlas CLI para criar um ambiente de teste que você pode excluir quando terminar de testar:

1. Execute o comando atlas users describe para retornar seu ID de usuário do Atlas. Substitua <userEmail> pelo endereço de e-mail associado à sua conta de Atlas user.

   atlas users describe --username <userEmail>

2. Execute o comando atlas projects create para criar um novo projeto chamado myTempProject em sua organização do Atlas. Substitua <orgId> pelo ID da sua organização e substitua <userId> pelo ID do Atlas user que você recuperou na etapa anterior.

   atlas projects create myTempProject --orgId <orgId> --ownerId <userId>

3. Recupere o ID do grupo para o projeto que você criou a partir da resposta. No exemplo de resposta a seguir, o ID do grupo é 64933bde48add154124e343f.

   Project '64933bde48add154124e343f' created.

   Como alternativa, você pode usar o comando Atlas lista de projeto para encontrar o ID do projeto.

4. Execute o comando atlas setup para criar um cluster Atlas e um usuário de banco de dados em seu novo projeto. O comando a seguir cria um cluster M10 na região AWS US_EAST_1, com o usuário temporário myTempUser.

   Substitua <password> por uma senha para o usuário de banco de dados e substitua <projectId> pelo ID do projeto do projeto que você criou.

   Importante

   Um cluster M10 não é gratuito. O cluster que você criar incorrerá em cobranças por hora até que você o exclua. Para obter mais informações sobre o faturamento do cluster do Atlas, consulte a documentação Custos de configuração do cluster.

   atlas setup --clusterName myTempCluster --provider AWS --region US_EAST_1 --tier M10 --username myTempUser --password <password> --currentIp --skipSampleData --projectId <projectId> --force

   Depois que o Atlas cria o cluster, a Atlas CLI fornece a string de conexão e se conecta ao cluster por meio demongosh.

Configure a autenticação programática para o projeto temporário.

Para executar comandos Atlas CLI a partir de seus scripts de automação, você precisa de uma maneira para sua automação autenticar no plano de controle do Atlas programaticamente. Uma maneira de fazer isso é criar uma conta de serviço para seu projeto e adicionar suas credenciais ao seu ambiente:

1. Crie uma conta de serviço para o projeto temporário.

   Siga as instruções em Introdução à Atlas Administration API para criar uma conta de serviço para seu projeto temporário. Salve os valores de ID do cliente e segredo do cliente para a conta de serviço.

2. Adicione credenciais de conta de serviço ao seu ambiente de teste.

   Para permitir que seu script execute comandos da CLI do Atlas sem exigir autenticação interativa, você deve adicionar as credenciais da conta de serviço ao seu ambiente de teste. Você pode fazer isso definindo as variáveis de ambiente MONGODB_ATLAS_CLIENT_ID e MONGODB_ATLAS_CLIENT_SECRET, executando atlas auth login no ambiente de teste ou adicionando as credenciais a um perfil nomeado e anexando --profile <profileName> a cada comando da CLI do Atlas em seu script.

Teste suas automações no projeto temporário .

Use o projeto e o cluster que você criou nas etapas anteriores para validar scripts que automatizam as ações do Atlas CLI, como criar, atualizar, pausar ou excluir recursos do Atlas.

Exclua o projeto temporário, o cluster e o usuário do banco de dados.

Execute os seguintes comandos do Atlas CLI para excluir o ambiente de teste. Isso garante que todos os recursos criados para teste sejam removidos corretamente e parem de incorrer em cobranças em sua conta do Atlas:

1. Execute o comando atlas clusters delete para excluir o cluster temporário e seus usuários de banco de dados. Substitua <projectId> pelo ID do projeto do projeto temporário.

   atlas clusters delete myTempCluster --projectId <projectId> --force

2. Execute o comando atlas projects delete para excluir o projeto temporário. Substitua <projectId> pelo ID do projeto temporário.

   atlas projects delete <projectId> --force

   Observação

   Você não pode excluir o projeto temporário até que o cluster temporário termine de ser desligado. Se você receber um erro indicando CANNOT_CLOSE_GROUP_ACTIVE_ATLAS_CLUSTERS, aguarde cinco minutos e execute o comando atlas projects delete novamente.

Você pode executar o comando Atlas projeto list para confirmar a exclusão bem-sucedida do projeto temporário e do cluster. Se o projeto temporário estiver ausente da lista, você excluiu com êxito o projeto e o cluster.