Para automatizar un proceso con la Atlas CLI en un script, utiliza los siguientes recursos y mejores prácticas como orientación.
Para aprender a conectarse a la CLI de Atlas mediante programación, consulte la Programmatic User pestañas en Conéctate desde Atlas CLI.
Recursos para la automatización con la CLI de Atlas
Resource | Objetivo |
|---|---|
Establezca variables de entorno que pueda definir una vez y usar en todos sus scripts. | |
Utilice plantillas Go o RutasJSON para personalizar la salida desde la CLI de Atlas. Puede incluir la salida personalizada prevista en sus scripts. |
Mejores prácticas para la automatización con la CLI de Atlas
Siga estas prácticas recomendadas al automatizar procesos con la CLI de Atlas:
Utilice claves privadas de Atlas
Al crear un script para automatizar procesos, le recomendamos que utilice Atlas Claves privadas para acceder a Atlas. Las sesiones de inicio de sesión en la CLI de Atlas duran doce horas, tras las cuales debe volver a iniciar sesión para acceder a Atlas. Use las claves privadas de Atlas para continuar accediendo a Atlas.
Base su script en la versión del Atlas CLI que ejecuta
Al crear un script para automatizar procesos, debe basarlo en la versión de la CLI de Atlas que ejecuta actualmente. No cree actualizaciones automáticas para la CLI de Atlas en su script, ya que las nuevas versiones de la CLI de Atlas podrían introducir cambios importantes que podrían afectar sus procesos automatizados.
En su lugar, consulte las notas de la versión para conocer las características obsoletas y los cambios importantes antes de actualizar manualmente su versión de Atlas CLI.
Redirección stderr
La CLI de Atlas muestra mensajes de error y advertencias de obsolescencia de comandos en la salida de los comandos. Estos mensajes de error y advertencias imprevistos pueden causar problemas en los procesos automatizados que anticipan una salida específica. Para evitar problemas, puede redirigir stderr a un archivo de salida en su 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, todos los mensajes de error y las advertencias de desuso se almacenan en error.txt y no se muestran en la salida, por lo que no interrumpen sus procesos automatizados.
Los mensajes de desuso de comandos son similares al siguiente texto:
Command "describe" is deprecated, Please use atlas privateEndpoints aws interfaces describe <atlasPrivateEndpointId> [--privateEndpointId privateEndpointID] [--projectId projected]
Actualizar los scripts periódicamente
Debe actualizar sus scripts periódicamente para dejar de usar comandos obsoletos, ya que se eliminarán en futuras versiones. Puede consultar qué comandos están obsoletos en el registro de cambios de la CLI de Atlas. Si configura un archivo de redirección para stderr, también puede revisarlo para ver si hay advertencias de obsolescencia.