Automatize Processos com a Atlas CLI
Nesta página
Para automatizar um processo com o Atlas CLI em um roteiro, use os seguintes recursos e práticas recomendadas como orientação.
Para saber como se conectar à Atlas CLI programaticamente, consulte as guias Programmatic User em Conectar a partir do Atlas CLI.
Recursos de automação com o Atlas CLI
Resource | Objetivo |
|---|---|
Defina variáveis de ambiente que você pode definir uma vez e usar em todos os seus scripts. | |
Use modelos Go ou caminhosJSON do para personalizar a saída do Atlas CLI. Você pode incluir a saída personalizada antecipada em seus scripts. |
Melhores práticas para automação com o Atlas CLI
Siga estas práticas recomendadas ao automatizar processos com o Atlas CLI:
Use as chaves privadas do Atlas
Ao criar um script para automatizar processos, recomendamos que você use Atlas chaves privadas do para acessar o Atlas. As sessões de login do Atlas CLI duram 12 horas, após as quais você deve fazer login novamente para acessar o Atlas. Use chaves privadas do Atlas para acesso contínuo ao Atlas.
Baseie seu roteiro na versão do Atlas CLI que você executa
Ao criar um script para automatizar processos, você deve basear o script na versão do Atlas CLI que você executa atualmente. Não crie atualizações automáticas para a Atlas CLI em seu script porque as novas versões da Atlas CLI podem introduzir alterações significativas, que podem interromper seus processos automatizados.
Em vez disso, verifique as notas de versão para recursos obsoletos e alterações significativas antes de atualizar manualmente sua versão do Atlas CLI.
Redirecionar stderr
O Atlas CLI imprime mensagens de erro e avisos de descontinuação de comandos na saída dos comandos. Essas mensagens de erro e avisos inesperados podem causar problemas em seus processos automatizados que antecipam uma saída específica. Para evitar problemas, você pode redirecionar stderr para um arquivo de saída no seu roteiro.
Por exemplo, o comando a seguir redireciona a saída do stderr de um roteiro chamado myScript.sh para um arquivo de texto chamado error.txt:
myScript.sh 2> error.txt
No exemplo anterior, todas as mensagens de erro e os avisos de descontinuação de uso são armazenados em error.txt e não são exibidos na saída, portanto, não interrompem seus processos automatizados.
As mensagens de descontinuação do comando são semelhantes ao seguinte texto:
Command "describe" is deprecated, Please use atlas privateEndpoints aws interfaces describe <atlasPrivateEndpointId> [--privateEndpointId privateEndpointID] [--projectId projected]
Atualize scripts regularmente
Você deve atualizar regularmente seus scripts para descontinuar o uso de comandos obsoletos, pois eles serão removidos em versões futuras. Você pode aprender quais comandos foram descontinuados no Registro de alterações do Atlas CLI. Se você configurar um arquivo de redirecionamento para stderr, também poderá verificar se há avisos de descontinuação nesse arquivo.