エラーのトラブルシューティング
Atlas のローカル配置の問題のトラブルシューティング
ローカルマシンの問題
複数のローカル Atlas 配置を作成し、データをロードすると、Atlas CLI が使用できない状態に達した場合は、マシンの制限に達している可能性があります。
Windows の Docker Desktop で作業している場合 または MacOS 、より多くのメモリを割り当てることを検討してください。
Docker の問題
Atlas CLI は Docker を使用しますatlas deployments
( コマンドの場合
MacOS または Windows の場合は、 Docker Desktop v4.31 + をインストールします。
Linux の場合は、 Docker Engine v27.0 + をインストールします。
Atlas のローカル配置が機能しない場合は、Docker 環境をクリーンアップして新しく起動する必要がある場合があります。
docker stop $(docker ps -a -q) && docker system prune -a
診断を実行する
atlas deployments
コマンドと で問題が発生し、サポートが必要な場合は、次のコマンドを実行して詳細な診断を提供してください。
atlas deployments diagnostics <deploymentName> --output json > out.json
コマンドエラー
エラー: 認証情報がありません
次のいずれかを確認してください。
atlas config init
を実行してプロファイルに API キーを追加するか、環境変数に API キーを追加します。 カスタム名でプロファイルを作成した場合、または複数のプロファイルを使用している場合は、--profile
フラグを使用して正しいプロファイルを指定します。Atlas のログイン認証情報と認証トークンを使用して認証するには、
atlas auth login
を実行します。
詳しくは、「 Atlas CLI からの接続 」を参照してください。
Atlas : コマンドが見つかりません
atlas
実行可能ファイルは、$PATH にないディレクトリにある場合があります。 $PATH にディレクトリを追加するか、実行可能ファイルを $PATH 内のディレクトリに移動するか、実行可能ファイルをその場所から直接実行できます。
400(リクエスト "TENANT_AtRIBUTE_READ_ONLY")) 属性 pitEnabled はテナント クラスターの読み取り専用であり、ユーザーによる変更はできません。
このエラーは、共有クラスターに対して--backup
引数を指定してAtlas クラスター作成を実行しようとすると表示されることがあります。 --backup
引数はM10
未満のクラスターでは 使用できません 。
401(リクエスト "UnAuthorized") このリソースは許可されていません。
提供した認証情報は、Atlas CLI コマンドで指定されたプロジェクトでは無効です。 公開キーと秘密キー文字列の精度を確認します。
認証情報が構成ファイルに保存されている場合は、構成ファイルが正しい場所にあることを確認してください。 詳細については、「構成ファイルの検索」を参照してください。 Atlas CLI が構成ファイルを見つけられず、環境変数に認証情報を保存していない場合は、 401
エラーが発生します。
401(リクエスト "UnAuthorized") 現在のユーザーには、この操作を実行する権限がありません。
Atlas CLI への接続に使用したユーザーアカウントまたは API キーに、要求されたアクションを実行する権限がありません。 Atlas CLI コマンドを実行するには、ユーザーアカウントと API キーに適切なユーザーロールが必要です。 ユーザーのロールを割り当てまたは変更するには、以下を参照してください。
401(リクエスト "Un authorized")<org-id>
このエラーは、 新しいプロジェクトを作成 しようとしたときに表示されることがあります。 新しいプロジェクトを作成するには、認証に使用するユーザー アカウントまたは API キーに組織レベルでOrganization Project Creator
ロールが必要です。
403(リクエスト "禁止")IP アドレス <ip-address> はこのリソースへのアクセスを許可されていません。
認証に使用するユーザーの IP アドレスは、要求されたプロジェクトのアクセス リストにありません。 IP アドレスをアクセス リストに追加して、 コマンドを実行します。
詳しくは、次のページを参照してください。
プロジェクトのアクセス リストについては、「 IP アクセス リスト エントリの構成 」を参照してください。
API キー アクセス リストについては、「 Atlas Administration API の使い始める 」を参照してください。
API キーのアクセス リストに IP アドレスを追加するには、次の手順に従います。
404(リクエスト "Not Found") 無効なグループ ID <group-id> が指定されました。
コマンドで入力されたプロジェクト 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 がホームページ ディレクトリにアクセスできない場合に表示されることがあります。
HomeDRIVE、HomePATH、または USERPROFILE は空白
このエラーは、Atlas CLI がホームページ ディレクトリにアクセスできない場合に表示されることがあります。