Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Atlas CLI

Solução de problemas de erros

Nesta página

  • Solucionar problemas locais de implantação do Atlas
  • Erros de comando
  • Erros de configuração

Solucionar problemas locais de implantação do Atlas

Erro: o qemu foi encerrado inesperadamente com o código de saída -1, stderr: qemu-system-x86_64: Erro: HV_DNIED

O Atlas CLI utiliza Podman e QEMu. Identificamos esse problema nas arquiteturas MacOS x86 . Para resolver esse problema, atualize para a versão mais recente do QEMu e reinicie o Podman.

Erro: status de saída 127

Este erro pode ocorrer quando você usa o atlas deployments setup comando no Ubuntu Linux devido a um problema conhecido com Podman. Não oferecemos suporte ao Ubuntu para sistemas locais do Atlas durante esse estágio de pré-visualização pública.

MongoNetworkError: connect ECONNREFUSED

Esse problema pode ocorrer depois que a máquina entra no modo de hibernação ou é reiniciada. Quando você tenta se conectar à implantação local do Atlas, esse erro ocorre.

A Atlas CLI usa Podman e QEMu para executar instâncias dockerizadas do MongoDB. O Podman tem uma arquitetura sem daemon. Portanto, as instâncias locais do MongoDB não são reiniciadas automaticamente.

Para corrigir esse problema:

  1. Listar implantações disponíveis.

    atlas deployments list

  2. Para retomar o container, copie e cole o seguinte comando no seu terminal e substitua {deployment-name} pelo nome da implantação para iniciar.

    atlas deployments start {deployment-name}

Problemas no Windows

Não damos suporte ao Windows para sistemas locais do Atlas durante esse estágio de Pré-visualização Pública.

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.

Considere alocar mais memória:

  1. Pare a máquina Podman:

    podman machine stop

  2. Aloque mais memória com base nas configurações da sua máquina:

    podman machine set --cpus 3 --memory 5120

  3. Inicie a máquina Podman:

    podman machine start

  4. Liste os container do Podman.

    podman ps --all

  5. Para retomar o container, copie e cole o seguinte comando no seu terminal e substitua {container-name} pelo nome do container para iniciar.

    podman start {container-name}

Problemas do Podman

A Atlas CLI usa Podman para atlas deployments comandos.

Para instalar o Podman, execute o seguinte comando:

brew install podman

Para inicializar uma máquina Podman, execute o seguinte comando:

podman machine init

Para iniciar uma máquina Podman, execute o seguinte comando:

podman machine start

Se o seu sistema local do Atlas não funcionar, talvez seja necessário limpar o ambiente do Podman e começar do zero:

podman kill --all && podman system prune --force && podman volume rm --all

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

Erros de comando

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:

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 adicionar seu endereço IP à lista de acesso de uma chave API:

1

Acesse a página Access Manager do seu projeto.

  1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado Organizations no menu na barra de navegação.

  2. Selecione o projeto desejado na lista de projetos na página Projects.

  3. Ao lado do menu Projects, expanda o menu Options e clique em Project Settings.

  4. Clique em Access Manager na barra de navegação.

2

Acesse a lista de acesso da chave de API.

  1. Clique na aba API Keys.

  2. Clique em à direita da chave deAPI .

  3. Clique em Edit Permissions e clique em Next.

3

Adicione seu endereço IP à lista de acesso da chave API.

  1. Execute uma das seguintes tarefas na seção API Access List :

    • Clique em Add Access List Entry e digite um endereço IP .

    • Se o seu host atual para acessar o Atlas também fizer solicitações de API com esta chave de API , clique em Use Current IP Address .

  2. Clique em Save.

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.

Observação

group ID e project ID são sinônimos nos serviços de nuvem do MongoDB.

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.

Erros de configuração

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.