Solução de problemas de erros

Problemas locais da máquina

Se a Atlas CLI ficar lenta e inutilizável após você criar vários sistemas locais do Atlas e carregar dados, você pode ter atingido o limite da sua máquina.

Se você estiver trabalhando no Docker Desktop para Windows ou macOS, considere a possibilidade de alocar mais memória.

Problemas do Docker

A Atlas CLI usa Docker para atlas deployments comandos.

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

• Para Linux, instale o Docker Engine v27.0+.

Se a implantação local do Atlas não funcionar, talvez seja necessário limpar o ambiente do Docker e começar do zero:

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

Executar diagnósticos

Se você tiver problemas e com comandos atlas deployments e precisar de suporte, execute o seguinte comando para fornecer diagnósticos detalhados:

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

Erro: credenciais ausentes

Certifique-se de que você:

• Execute atlas config init e adicione suas chaves de API ao seuperfil do ou adicione suas chaves de API às suas variáveis de ambiente. Se você criou um perfil com um nome personalizado ou estiver usando mais de um perfil, especifique o perfil correto com o sinalizador --profile .

• Execute o atlas auth login para autenticar utilizando suas credenciais de login do Atlas e um token de autenticação.

Para saber mais, consulte Conectar a partir do Atlas CLI.

Atlas: comando não encontrado

O executável atlas pode estar em um diretório que não está em seu $PATH. Você pode adicionar o diretório ao seu $PATH, mover o executável para um diretório que esteja no seu $PATH ou executar o executável diretamente de seu local.

400 (solicitação "TENANT_ATTRIBATE_READ_ONLY") O atributo pitEnabled é somente leitura para clusters de locatários e não pode ser alterado pelo usuário.

Esse erro pode aparecer se você tentar executar o cluster do Atlas create com o argumento --backup para um cluster compartilhado. O argumento --backup não está disponível para clusters menores que M10.

401 (solicitação "Não autorizado") Você não está autorizado para este recurso.

As credenciais que você forneceu não são válidas para o projeto especificado em seu comando Atlas CLI. Verifique a precisão das strings de suas chaves públicas e privadas.

Se suas credenciais forem armazenadas em um arquivo de configuração, certifique-se de que o arquivo de configuração esteja no local correto. Para saber mais, consulte Localizar o arquivo de configuração. Se o Atlas CLI não conseguir encontrar seu arquivo de configuração e você não armazenar credenciais em variáveis de ambiente, um erro 401 resultará.

401 (solicitação "Não autorizado") O usuário atual não está autorizado a executar essa ação.

A conta de usuário ou chave de API que você usou para se conectar ao Atlas CLI não tem permissão para executar a ação solicitada. As contas de usuário e as chaves de API devem ter as funções de usuário apropriadas para executar comandos do Atlas CLI. Para atribuir ou alterar as funções de um usuário, consulte:

• Gerenciar usuários da organização

• Gerenciar acesso a um projeto

• Configuração da API

401 (solicitação "Não autorizado") O usuário conectado no momento não tem a função de criador de grupos na organização <org-id>.

Este erro pode aparecer ao tentar criar um novo projeto. A conta do usuário ou a chave de API que você usa para autenticar deve ter a função Organization Project Creator no nível da organização para criar novos projetos.

403 (solicitação "Foribiden") O endereço IP <ip-address> não tem permissão para acessar esse recurso.

O endereço IP do usuário que você usa para autenticar não está na lista de acesso do projeto solicitado. Adicione seu endereço IP à lista de acesso para executar comandos.

Para saber mais, consulte as seguintes páginas:

• Para listas de acesso do projeto, consulte Configurar entradas da lista de acesso IP.

• Para obter listas de acesso a chaves de API, consulte Introdução à API Atlas Administration.

Para adicionar seu endereço IP à lista de acesso de uma chave API:

404 (solicitação "Não encontrado") Um ID do grupo <group-id> inválido foi especificado.

O ID do projeto inserido com o comando não existe. Verifique o ID do projeto navegando até a subseção Settings da seção Project na navegação do lado esquerdo do Atlas.

Configuração de alerta não excluída

Esse erro poderá aparecer se o Atlas CLI não puder excluir a configuração de alerta especificada pelo ID.

podman não encontrado

Esse erro aparece se você tentar executar um atlas deployments comando dentro de nosso contêiner oficial do Docker Docker, mongodb/atlas na v1.26 ou posterior. Em vez disso, siga as etapas descritas em Criar um sistema local do Atlas com o Docker.

Você deve inspecionar os containers anteriores em seu cluster com o seguinte comando:

podman ps -a

Em seguida, remova qualquer um que comece com mongod ou mongot com o seguinte comando:

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

brew uninstall podman

Saída em branco ao ler o diretório inicial

Esse erro pode aparecer se o Atlas CLI não conseguir acessar seu diretório inicial.

Homedrive, HomePath ou USERPROFILE estão em branco

Esse erro pode aparecer se o Atlas CLI não conseguir acessar seu diretório inicial.