Solución de problemas de error

Problemas con 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 Windowso MacOS, considere 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 su implementación local de Atlas no funciona, es posible que deba limpiar su entorno de Docker y comenzar de nuevo:

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

No se pudo instalar ni actualizar el complemento AtlasCLI

Si el complemento Atlas CLI no se puede instalar o actualizar, asegúrese de tener acceso a la API de GitHub, ya que el acceso a la API de GitHub es necesario para instalar o actualizar el complemento Atlas CLI.

Ejecutar diagnósticos

Si tiene problemas con los comandos atlas deployments y necesita ayuda, ejecute el siguiente comando para proporcionar diagnósticos detallados:

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

Error: faltan credenciales

Asegúrese de que:

• Ejecute atlas config init y agregue sus claves API a su Perfil o agregue sus claves API a sus variables de entorno. Si creó un perfil con un nombre personalizado o usa más de uno, especifique el perfil correcto con el --profile indicador.

• 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, moverlo a un directorio que sí esté en tu $PATH o ejecutarlo directamente desde su ubicación.

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

Este error puede aparecer si intenta ejecutar la función "atlas clusters create" con el --backup argumento para un clúster compartido. El --backup argumento no está disponible para clústeres menores M10 de.

401 (solicitud "No autorizada") No estás 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 autorizada") El usuario actual no está autorizado para realizar esta acción.

La cuenta de usuario o la clave API que usó para conectarse a la CLI de Atlas no tiene permiso para realizar la acción solicitada. Las cuentas de usuario y las claves API deben tener los roles de usuario adecuados para ejecutar comandos de la CLI de Atlas. 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 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 "Prohibida") La dirección IP <ip-address> no tiene permiso para 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 obtener más información, consulte las siguientes páginas:

• Para obtener listas de acceso al proyecto, consulte Configurar entradas de lista de acceso IP.

• Para obtener listas de acceso a claves API, consulte Introducción a 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 encontrada") Se especificó un ID de grupo <group-id> no válido.

El ID del proyecto ingresado con el comando no existe. Verifique su ID de proyecto navegando a la subsección Settings de la sección Project en el panel de navegación izquierdo de Atlas.

Configuración de alerta no eliminada

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".

Debes inspeccionar los contenedores anteriores en tu 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 puede aparecer si la CLI de Atlas no puede acceder a su directorio de inicio.

HOMEDRIVE, HOMEPATH o USERPROFILE están en blanco

Este error puede aparecer si la CLI de Atlas no puede acceder a su directorio de inicio.