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 la CLI de Atlas
Resource | Objetivo |
|---|---|
Establezca variables de entorno que pueda definir una vez y usar en todos sus 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, 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.
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
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.