AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

エラーのトラブルシューティング

複数のローカル Atlas 配置を作成し、データをロードすると、Atlas CLI が使用できない状態に達した場合は、マシンの制限に達している可能性があります。

Windowsまたは MacOS 用のDocker Desktop を使用している場合は、より多くのメモリを割り当てることを検討してください。

Atlas CLI は atlas deployments コマンドにDocker を使用します。

Atlas のローカル配置が機能しない場合は、Docker 環境をクリーンアップして新しく起動する必要がある場合があります。

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

Atlas CLI プラグインのインストールまたはアップデートが失敗した場合は、 Github APIにアクセスできることを確認してください。Atlas CLI プラグインをインストールまたはアップデートするにはGithub APIアクセスが必要です。

atlas deploymentsコマンドと で問題が発生し、サポートが必要な場合は、次のコマンドを実行して詳細な診断を提供してください。

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

次のいずれかを確認してください。

  • atlas config initを実行して API キーをプロファイルに追加するか、環境変数に API キーを追加します。 カスタム名でプロファイルを作成した場合、または複数のプロファイルを使用している場合は、 --profileフラグを使用して正しいプロファイルを指定します。

  • Atlas のログイン認証情報と認証トークンを使用して認証するには、 atlas auth loginを実行します。

詳しくは、「 Atlas CLI からの接続 」を参照してください。

atlas実行可能ファイルは、$PATH にないディレクトリにある場合があります。 $PATH にディレクトリを追加するか、実行可能ファイルを $PATH 内のディレクトリに移動するか、実行可能ファイルをその場所から直接実行できます。

このエラーは、共有クラスターに対して--backup引数を指定してAtlas クラスター作成を実行しようとすると表示されることがあります。 --backup引数はM10未満のクラスターでは 使用できません 。

提供した認証情報は、Atlas CLI コマンドで指定されたプロジェクトでは無効です。 公開キーと秘密キー文字列の精度を確認します。

認証情報が構成ファイルに保存されている場合は、構成ファイルが正しい場所にあることを確認してください。 詳細については、「構成ファイルの検索」を参照してください。 Atlas CLI が構成ファイルを見つけられず、環境変数に認証情報を保存していない場合は、 401エラーが発生します。

Atlas CLI への接続に使用したユーザーアカウントまたは API キーに、要求されたアクションを実行する権限がありません。 Atlas CLI コマンドを実行するには、ユーザーアカウントと API キーに適切なユーザーロールが必要です。 ユーザーのロールを割り当てまたは変更するには、以下を参照してください。

このエラーは、 新しいプロジェクトを作成 しようとしたときに表示されることがあります。新しいプロジェクトを作成するには、認証に使用するユーザーアカウントまたはAPIキーに組織レベルでの Organization Project Creator ロールが必要です。

認証に使用するユーザーの IP アドレスは、要求されたプロジェクトのアクセス リストにありません。 IP アドレスをアクセス リストに追加して、 コマンドを実行します。

詳しくは、次のページを参照してください。

API キーのアクセス リストに IP アドレスを追加するには、次の手順に従います。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. Projectsページのプロジェクトのリストから目的のプロジェクトを選択します。

  3. Projects メニューの横にある Options メニューをクリックし、 Project Settings をクリックします。

  4. ナビゲーション バーの Access Manager をクリックします。

2
  1. [API Keys] タブをクリックします。

  2. をクリックします必要がありAPI

  3. [ Edit Permissionsと [ Next ] をクリックします。

3
  1. API Access Listセクションで次のいずれかのタスクを実行します。

    • Add Access List Entryをクリックし、 IPアドレスを入力します。

    • Atlas にアクセスするための現在のホストもこのAPIキーを使用してAPIリクエストを行う場合は、Use Current IP Address をクリックします。

  2. [Save] をクリックします。

コマンドで入力されたプロジェクト ID は存在しません。 Atlas の左側のナビゲーションで [ Projectセクションの [ Settingsサブセクションに移動して、プロジェクト ID を確認します。

注意

group ID MongoDB Cloud サービスでは、 とproject IDは同義語です。

このエラーは、Atlas CLI が ID で指定されたアラート構成を削除できない場合に表示されることがあります。

このエラーは、公式の Dockerコンテナ内で atlas deployments コマンドを実行しようとすると表示されます(v 1.26 以降の mongodb/atlas)。代わりに、「 Dockerを使用したローカル Atlas 配置の作成 」に記載されている手順に従ってください。

次のコマンドを使用して、クラスター内の過去のコンテナを検査する必要があります。

podman ps -a

次に、次のコマンドを使用して、mongod または mongot で始まるを削除します。

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

Tip

MacOS を使用している場合は、安全に podman をアンインストールできます。

podman を Homebrew でインストールした場合は、次のコマンドを使用してアンインストールします。

brew uninstall podman

このエラーは、Atlas CLI がホームページ ディレクトリにアクセスできない場合に表示されることがあります。

このエラーは、Atlas CLI がホームページ ディレクトリにアクセスできない場合に表示されることがあります。