Pruebas de automatización con proyectos y clústeres temporales

Cree un proyecto, un clúster y un usuario de base de datos temporales.

Ejecutar los siguientes comandos de Atlas CLI para crear un entorno de prueba que pueda borrar cuando termine de probar:

1. Ejecute el comando atlas users describe para devolver su ID de usuario de Atlas. Reemplace <userEmail> con la dirección de correo electrónico asociada a su cuenta de Atlas user.

   atlas users describe --username <userEmail>

2. Ejecute el comando atlas projects create para crear un nuevo proyecto llamado myTempProject en su organización de Atlas. Reemplace <orgId> con el Identificador de la Organización y reemplace <userId> con el Atlas user ID que recuperó en el paso anterior.

   atlas projects create myTempProject --orgId <orgId> --ownerId <userId>

3. Recupera el ID del grupo para el Proyecto que creaste a partir de la respuesta. En la siguiente respuesta de ejemplo, el ID del proyecto es 64933bde48add154124e343f.

   Project '64933bde48add154124e343f' created.

   Alternativamente, puedes usar el comando atlas projects list para encontrar el ID del proyecto.

4. Ejecute el comando atlas configurar para crear un clúster de Atlas y un usuario de base de datos en su nuevo Proyecto. El siguiente comando crea un clúster M10 en la región US_EAST_1 de Amazon Web Services, con el usuario temporal myTempUser.

   Reemplace <password> con una contraseña para el usuario de base de datos y reemplace <projectId> con el ID del proyecto que creó.

   Importante

   Un clúster M10 no es gratuito. El clúster que cree incurrirá en cargos por hora hasta que lo elimine. Para obtener más información sobre la facturación de clústeres de Atlas, consulte la documentación de costos de configuración de clústeres.

   atlas setup --clusterName myTempCluster --provider AWS --region US_EAST_1 --tier M10 --username myTempUser --password <password> --currentIp --skipSampleData --projectId <projectId> --force

   Después de que Atlas cree el clúster, la Atlas CLI proporciona la cadena de conexión del clúster y se conecta a su clúster a través de mongosh.

Configure la autenticación programática para el proyecto temporal.

Para ejecutar comandos de Atlas CLI desde sus scripts de automatización, necesita una forma de que su automatización se autentique en el plano de control de Atlas mediante programación. Una forma de hacerlo es crear una cuenta de servicio para su proyecto y agregar sus credenciales a su entorno:

1. Cree una cuenta de servicio para el Proyecto temporal.

   Siga las instrucciones de Get Started with the Atlas Administration API para crear una cuenta de servicio para su Proyecto temporal. Guarde los valores de ID de cliente y secreto de cliente de la cuenta de servicio.

2. Agregue credenciales de cuenta de servicio a su entorno de prueba.

   Para permitir que su script ejecute comandos de Atlas CLI sin necesidad de autenticación interactiva, debe agregar las credenciales de la cuenta de servicio a su entorno de prueba. Puede hacerlo configurando las variables de entorno MONGODB_ATLAS_CLIENT_ID y MONGODB_ATLAS_CLIENT_SECRET, ejecutando atlas auth login en el entorno de prueba o agregando las credenciales a un perfil con nombre y agregando --profile <profileName> a cada comando de Atlas CLI en su script.

Pruebe sus automatizaciones en el proyecto temporal.

Utilice el proyecto y el clúster que creó en los pasos anteriores para validar los scripts que automatizan las acciones de Atlas CLI, como crear, actualizar, pausar o borrar recursos de Atlas.

Elimine el proyecto temporal, el clúster y el usuario de la base de datos.

Ejecute los siguientes comandos de Atlas CLI para borrar el entorno de prueba. Esto garantiza que todos los recursos que creó para las pruebas se eliminen correctamente y dejen de generar cargos en su cuenta de Atlas:

1. Ejecute el comando atlas clusters delete para eliminar el clúster temporal y sus usuarios de base de datos. Reemplace <projectId> con el ID del proyecto temporal.

   atlas clusters delete myTempCluster --projectId <projectId> --force

2. Ejecute el comando atlas projects delete para borrar el proyecto temporal. Reemplace <projectId> con el ID del grupo de su Proyecto temporal.

   atlas projects delete <projectId> --force

   Nota

   No puede borrar el proyecto temporal hasta que el clúster temporal termine de apagarse. Si recibe un error que indica CANNOT_CLOSE_GROUP_ACTIVE_ATLAS_CLUSTERS, espere cinco minutos y, a continuación, vuelva a ejecutar el comando atlas projects delete.

Puede ejecutar el comando atlas projects list para confirmar la eliminación exitosa del proyecto y clúster temporales. Si el Proyecto temporal no aparece en la lista, ha borrar correctamente tanto el Proyecto como el clúster.