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 caminhos JSON 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 roteiro para automação de processos, é aconselhável utilizar as chaves privadas para acessar o Atlas. As sessões do Atlas CLI expiram após 12 horas, exigindo um novo login para acessar o Atlas. Use as chaves privadas do Atlas para continuar acessando o 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.