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 al Atlas CLI de forma programática, consulta las pestañas Programmatic User en Conectarse 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. | |
Utilice plantillas Go o rutas JSON para personalizar la salida de 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 mejores prácticas al automatizar procesos con la CLI de Atlas:
Utiliza llaves privadas de Atlas
Al crear un script para automatizar procesos, le recomendamos usar claves privadas de Atlas para acceder a Atlas. Las sesiones de inicio de sesión de la CLI de Atlas duran doce horas, tras las cuales deberá iniciar sesión de nuevo para acceder a Atlas. Utilice claves privadas de Atlas para mantener el acceso 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
Debes actualizar tus scripts periódicamente para dejar de usar comandos obsoletos, ya que se eliminarán en futuras versiones. Puedes consultar qué comandos están obsoletos en el registro de cambios de la CLI de Atlas. Si configuraste un archivo de redirección para stderr, también puedes revisarlo para ver si hay advertencias sobre comandos obsoletos.