Solución de problemas de error

Problemas en la máquina local

Si la CLI de Atlas se vuelve lenta hasta un estado inutilizable después de crear varias implementaciones locales de Atlas y cargar datos, es posible que haya alcanzado los límites de su máquina.

Si está trabajando en Docker Desktop para Windows o MacOS, considera asignar más memoria.

Problemas con Docker

La CLI de Atlas utiliza Docker para atlas deployments comandos.

• Para MacOS o Windows, instala Docker Desktop v4.31+.

• Para Linux, instala Docker Engine v27.0+.

Si tu implementación local de Atlas no funciona, puede que necesites limpiar tu entorno de Docker e iniciar un entorno nuevo:

docker stop $(docker ps -a -q) && docker system prune -a

No se pudo instalar ni actualizar el complemento AtlasCLI

Si el plugin Atlas CLI no se instala ni se actualiza, asegúrate de tener acceso a la API de GitHub, ya que para instalar o actualizar el plugin de Atlas CLI se requiere acceso a la API de GitHub.

Ejecutar diagnósticos

Si encuentras problemas y con los comandos atlas deployments y necesitas soporte, ejecuta el siguiente comando para proporcionar diagnósticos detallados:

atlas deployments diagnostics <deploymentName> --output json > out.json

Error: credenciales faltantes

Asegúrese de que:

• Ejecute atlas config init y agregue sus claves API a su perfil o añadir tus claves API a tus variables de entorno. Si creaste un perfil con un nombre personalizado o estás usando más de un perfil, especifica el perfil correcto con la bandera --profile.

• Ejecuta atlas auth login para autenticarte utilizando tus credenciales de Atlas y un token de autenticación.

Para obtener más información, consulte Conectarse desde la Atlas CLI.

atlas: comando no encontrado

El ejecutable atlas podría estar en un directorio que no esté en tu $PATH. Puedes añadir el directorio a tu $PATH, mover el ejecutable a un directorio que esté en tu $PATH o ejecutar el ejecutable directamente desde su ubicación.

400 (solicitud "TENANT_ATTRIBUTE_READ_ONLY") El atributo pitEnabled es de solo lectura para los clústeres de abonados y no puede ser modificado por el usuario.

Este error puede aparecer si intentas ejecutar atlas clusters create con el argumento --backup para un clúster compartido. El argumento --backup no está disponible para clústeres más pequeños que M10.

401 (solicitud "No autorizada") No está autorizado para este recurso.

Las credenciales que proporcionó no son válidas para el proyecto especificado en el comando CLI de Atlas. Compruebe la exactitud de las cadenas de clave pública y privada.

Si sus credenciales están almacenadas en un archivo de configuración, asegúrese de que este se encuentre en la ubicación correcta. Para obtener más información,consulte "Ubicar el archivo de configuración". Si la CLI de Atlas no encuentra su archivo de configuración y no almacena las credenciales en variables de entorno, se 401 generará un error.

401 (solicitud "No autorizado") El usuario actual no está autorizado para realizar esta acción.

La cuenta de usuario o la clave API que utilizaste para conectarse a la Atlas CLI no tiene permiso para realizar la acción solicitada. Las cuentas de usuario y las claves de API deben tener los roles de usuario adecuados para ejecutar los comandos de Atlas CLI. Para asignar o cambiar los roles de un usuario, consulte:

• Administrar usuarios de la Organización

• Gestionar el acceso a un proyecto

• Configuración de la API

401 (solicitud "No autorizada") El usuario que ha iniciado sesión actualmente no tiene el rol de creador de grupo en la organización <org-id>.

Este error podría aparecer al intentar crear un nuevo proyecto. La cuenta de usuario o la clave de API que se usa para autenticarse debe tener el rol Organization Project Creator a nivel de organización para crear nuevos proyectos.

403 (solicitud impedida) "Prohibido" La dirección IP <ip-address> no tiene permitido acceder a este recurso.

La dirección IP del usuario que utiliza para autenticarse no está en la lista de acceso del proyecto solicitado. Agregue su dirección IP a la lista de acceso para ejecutar comandos.

Para aprender más, consulta las siguientes páginas:

• Para listas de acceso del proyecto, consulte Configurar entradas de listas de acceso IP.

• Para obtener las listas de acceso de las claves API, consulte Comience con la API de administración de Atlas.

Para agregar su dirección IP a la lista de acceso de una clave API:

404 (solicitud "No Encontrado") Se especificó un ID de grupo <group-id> no válido.

El ID del grupo ingresado con el comando no existe. Verifica tu ID del grupo navegando a la subsección Settings de la sección Project en la navegación del lado izquierdo de Atlas.

Configuración de alerta no borrada

Este error puede aparecer si la CLI de Atlas no puede eliminar la configuración de alerta especificada por el ID.

podman no encontrado

Este error aparece si intenta ejecutar un atlas deployments comando dentro de nuestro contenedor Docker oficial, mongodb/atlas en la versión 78001.26 o posterior. En su lugar, siga los pasos descritos en "Crear una implementación local de Atlas con Docker".

Debe inspeccionar los contenedores anteriores en su clúster con el siguiente comando:

podman ps -a

Luego, elimine cualquiera que comience con mongod o mongot con el siguiente comando:

podman container rm -f -v <name or ID>

brew uninstall podman

Salida en blanco al leer el directorio de inicio

Este error podría aparecer si la CLI de Atlas no puede acceder a tu directorio personal.

HOMEDRIVE, HOMEPATH o USERPROFILE están en blanco

Este error podría aparecer si la CLI de Atlas no puede acceder a tu directorio personal.