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 do usuário do Atlas . Substitua <userEmail> pelo endereço de e-mail que está associado à sua conta de usuário do Atlas .

   atlas users describe --username <userEmail>

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

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

3. Recupere o ID do projeto que você criou a partir da resposta. No exemplo de resposta a seguir, o ID do projeto é 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 Atlas cluster e um usuário de banco de dados em seu novo projeto. O seguinte comando cria um M10 cluster US_EAST_1 do na região do AWS, com o usuário myTempUser temporário.

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

   Importante

   Um M10 cluster 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 Atlas cluster, consulte a documentação de Custos de Configuração de 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 do cluster e se conecta ao seu cluster mongosh por meio de.

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

Para executar comandos do Atlas CLI a partir de seus scripts de automação, você precisa de uma maneira de sua automação se 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 à API Atlas Administration 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 da conta de serviço ao seu ambiente de teste.

   Para habilitar seu script para executar comandos do Atlas CLI 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 MONGODB_ATLAS_CLIENT_ID as MONGODB_ATLAS_CLIENT_SECRET variáveis de ambiente e, executando atlas auth login no ambiente de teste ou adicionando as credenciais a um perfil nomeado e anexando --profile <profileName> a cada comando Atlas CLI em seu script.

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

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

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

Execute os seguintes comandos do Atlas CLI para excluir o ambiente de teste. Isso garante que todos os recursos que você criou 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 do banco de dados . Substitua <projectId> pelo ID do projeto para o 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 do seu 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 conclua o desligamento. Se você receber um erro informando CANNOT_CLOSE_GROUP_ACTIVE_ATLAS_CLUSTERS, aguarde cinco minutos e execute o comando atlas projects delete novamente.

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