Para automatizar un proceso con la Atlas CLI en un script, utiliza los siguientes recursos y mejores prácticas como orientación.
Para aprender cómo conectarse programáticamente a la CLI de Atlas, consulta la Programmatic User pestañas activas Conéctate desde Atlas CLI.
Recursos para la automatización con Atlas CLI
Resource | Objetivo |
|---|---|
Establece variables de entorno que puedas definir una vez y usar en todos tus scripts. | |
Utiliza plantillas de Go o Rutas JSON para personalizar la salida desde la CLI de Atlas. Puedes incluir la salida personalizada anticipada en tus scripts. |
Mejores prácticas para la automatización con la CLI de Atlas
Siga estas mejores prácticas al automatizar procesos con la CLI de Atlas:
Utiliza llaves privadas de Atlas
Cuando crea un script para automatizar procesos, le recomendamos que utilice Atlas llaves privadas para acceder a Atlas. Las sesiones de inicio de sesión del CLI de Atlas duran doce horas, después de las cuales debes iniciar sesión nuevamente para acceder a Atlas. Utiliza las claves privadas de Atlas para continuar accediendo a Atlas.
Base su script en la versión del Atlas CLI que ejecuta
Para automatizar procesos mediante la creación de un script, el script debe basarse en la versión del Atlas CLI que se ejecuta actualmente. No incluya actualizaciones automáticas del Atlas CLI en su script, porque las nuevas versiones del Atlas CLI podrían introducir cambios disruptivos, lo que podría romper sus procesos automatizados.
En su lugar, consulta las notas de la versión para detectar funcionalidades obsoletas y cambios disruptivos antes de actualizar manualmente tu versión del Atlas CLI.
Redireccionar stderr
El Atlas CLI imprime mensajes de error y advertencias de obsolescencia de comandos en la salida de los comandos. Estos mensajes de error y advertencias no previstos pueden causar problemas a sus procesos automatizados que anticipan una salida específica. Para prevenir problemas, puedes redireccionar stderr a un archivo de salida en tu script.
Por ejemplo, el siguiente comando redirige la salida stderr de un script llamado myScript.sh a un archivo de texto llamado error.txt:
myScript.sh 2> error.txt
En el ejemplo anterior, se almacenan todos los mensajes de error y advertencias de obsolescencia en error.txt y no se muestran en la salida, por lo que no interrumpen tus procesos automatizados.
Los mensajes de obsolescencia de comandos son similares al siguiente texto:
Command "describe" is deprecated, Please use atlas privateEndpoints aws interfaces describe <atlasPrivateEndpointId> [--privateEndpointId privateEndpointID] [--projectId projected]
Actualizar scripts regularmente
Debería actualizar regularmente sus scripts para dejar de usar comandos obsoletos porque se eliminarán en futuras versiones. Puede aprender qué comandos están obsoletos en el registro de cambios de Atlas CLI. Si configura un archivo de redirección para stderr, también puede revisar ese archivo en busca de advertencias de obsolescencia.