오류 문제 해결

로컬 Atlas 배포 문제 해결

로컬 시스템 문제

로컬 Atlas 배포서버를 여러 개 생성하고 데이터를 로드한 후 Atlas CLI 속도가 사용할 수 없는 상태로 느려지는 경우, 머신의 용량 제한에 도달했을 수 있습니다.

Windows 또는 MacOS용 Docker Desktop에서 작업하는 경우 더 많은 메모리를 할당하는 것이 좋습니다.

Docker 문제

Atlas CLI 명령에 Docker atlas deployments 사용합니다.

For MacOS 또는 Windows 의 경우 Docker Desktop v4.31+.를 설치합니다.
Linux 의 경우 Docker Engine v27.0+를 설치합니다.

로컬 Atlas 배포서버 가 작동하지 않는 경우 Docker 환경을 정리하고 새로 시작해야 할 수 있습니다.

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

AtlasCLI 플러그인 설치 또는 업데이트 실패

Atlas CLI 설치하거나 업데이트 에 실패하는 경우, Atlas CLI 설치하거나 업데이트 Github API 에 액세스 해야 하므로 Github API 에 액세스 할 수 있는지 확인하세요.

진단 실행

atlas deployments 명령에 문제가 발생하여 지원이 필요한 경우 다음 명령을 실행하여 자세한 진단을 제공하세요.

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

명령 오류

오류: 자격 증명 누락

다음 중 하나를 확인합니다.

atlas config init 를 실행하고 프로필 에 API 키를 추가하거나 환경 변수 에 API 키를 추가합니다. 사용자 지정 이름으로 프로필을 만들었거나 둘 이상의 프로필을 사용하는 경우 --profile 플래그와 함께 올바른 프로필을 지정합니다.
atlas auth login 를 실행하여 Atlas 로그인 자격 증명과 인증 토큰을 사용하여 인증합니다.

자세한 내용 은 Atlas CLI에서 연결을 참조하세요.

Atlas: 명령을 찾을 수 없습니다.

atlas 실행 파일이 $PATH에 없는 디렉토리에 있을 수 있습니다. 디렉토리를 $PATH에 추가하거나, 실행 파일을 $PATH에 있는 디렉토리로 이동하거나, 해당 위치에서 직접 실행할 수 있습니다.

400 (요청 "TENANT_ATTRIBITE_READ_ONLY") pitEnabled 속성은 테넌트 cluster에 대해 읽기 전용이며 사용자가 변경할 수 없습니다.

이 오류는 공유 클러스터에 대해 --backup 인수를 사용하여 Atlas cluster create 를 실행하려고 할 때 나타날 수 있습니다. M10 보다 작은 클러스터에는 --backup 인수를 사용할 수 없습니다.

401 (요청 "승인되지 않음") 이 리소스에 대한 권한이 없습니다.

제공한 자격 증명이 Atlas CLI 명령에 지정된 프로젝트에 유효하지 않습니다. 공개 키 및 비공개 키 문자열의 정확성을 확인합니다.

자격 증명이 구성 파일 에 저장된 경우 구성 파일이 올바른 위치에 있는지 확인합니다. 자세한 내용 은 구성 파일 찾기 를 참조하세요. Atlas CLI가 구성 파일을 찾을 수 없고 환경 변수 에 자격 증명을 저장하지 않으면 401 오류가 발생합니다.

401 ("승인되지 않음" 요청) 현재 사용자는 이 조치를 수행할 수 있는 권한이 없습니다.

The user account or API key that you used to connect to the Atlas CLI doesn't have permission to perform the requested action. User accounts and API keys must have the appropriate user roles to run Atlas CLI commands. To assign or change a user's roles, see:

401 (요청 "승인되지 않음") 현재 로그인한 사용자에게 <org-id> 조직에서 그룹 작성자 역할이 없습니다.

This error might appear when trying to create a new project. The user account or API key that you use to authenticate must have the Organization Project Creator role at the organization level in order to create new projects.

403 (요청 "Forbidden") IP 주소 <ip-address> 는 이 리소스에 액세스할 수 없습니다.

인증에 사용하는 사용자의 IP 주소가 요청된 프로젝트의 액세스 목록 에 없습니다. 액세스 목록 에 IP 주소를 추가하여 명령을 실행합니다.

자세한 내용은 다음 페이지를 참조하세요.

For project access lists, see Configure IP Access List Entries.
API 키 액세스 목록은 Atlas 관리 API 시작하기를 참조하세요.

API 키의 액세스 목록에 IP 주소를 추가하려면 다음을 수행합니다.

프로젝트의 Access Manager 페이지로 고 (Go) .

아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
Projects 페이지의 프로젝트 목록에서 원하는 프로젝트를 선택하세요.
Projects 메뉴 옆에 있는 Options 메뉴를 펼친 다음 Project Settings 를 클릭합니다.
탐색 모음에서 Access Manager을(를) 클릭합니다.

API 키의 액세스 목록으로 이동합니다.

API Keys 탭을 클릭합니다.
클릭 API 키 오른쪽에 있습니다.
Edit Permissions 을 클릭하고 Next 을 클릭합니다.

API 키의 액세스 목록에 IP 주소를 추가합니다.

API Access List 섹션에서 다음 작업 중 하나를 수행합니다.
- Add Access List Entry 을 클릭하고 IP 주소를 입력합니다.
- Atlas 액세스하기 위한 현재 호스팅하다 도 이 API 키로 API 요청을 수행하는 경우 Use Current IP Address를 클릭합니다.
Save를 클릭합니다.

404 (요청 "Not Found") 잘못된 그룹 ID <group-id> 이(가) 지정되었습니다.

명령으로 입력한 프로젝트 ID가 존재하지 않습니다. Atlas 왼쪽 탐색 메뉴에서 Project 섹션의 Settings 하위 섹션으로 이동하여 프로젝트 ID를 확인하세요.

참고

group ID 와 project ID 은 MongoDB cloud 서비스에서 동의어입니다.

경고 구성이 삭제되지 않음

이 오류는 Atlas CLI가 ID로 지정된 경고 구성을 삭제할 수 없는 경우 나타날 수 있습니다.

podman을 찾을 수 없습니다.

이 오류는 공식 Docker 컨테이너 mongodb/atlas 내에서 atlas deployments 명령을 실행 하려고 하는 경우 v1.26 이상에서 나타납니다. 대신 Docker 를 사용하여 로컬 Atlas 배포서버 만들기에설명된 단계를 따르세요.

다음 명령을 사용하여 클러스터 의 과거 컨테이너를 검사해야 합니다.

podman ps -a

그런 다음 다음 명령을 사용하여 mongod 또는 mongot 로 시작하는 항목을 제거 합니다.

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

팁

MacOS를 사용하는 경우 podman을 안전하게 제거할 수 있습니다.

홈브루로 podman을 설치한 경우, 이 명령을 사용하여 제거하세요:

brew uninstall podman

구성 오류

홈 디렉토리를 읽을 때 빈 출력

이 오류는 Atlas CLI가 홈 디렉토리에 액세스할 수 없는 경우 나타날 수 있습니다.

홈 드라이브, 홈 PATH 또는 USERPROFILE이 비어 있습니다.

이 오류는 Atlas CLI가 홈 디렉토리에 액세스할 수 없는 경우 나타날 수 있습니다.