문서 메뉴
문서 홈
/ /
아틀라스 CLI

오류 문제 해결

이 페이지의 내용

  • 로컬 Atlas 배포 문제 해결
  • 명령 오류
  • 구성 오류

Atlas CLI는 Podman 를 사용합니다. 및 QEMU . MacOS x86 아키텍처에서 이 문제를 확인했습니다. 이 문제를 해결하려면 최신 버전의 QEMU로 업그레이드하고 Podman을 다시 시작하세요.

이 오류는 알려진 문제 로 인해 atlas deployments setup Ubuntu Linux에서 명령을 사용할 때 발생할 수 있습니다. Podman과 함께합니다. 이 공개 미리 보기 단계에서는 로컬 Atlas 배포를 위한 Ubuntu를 지원하지 않습니다.

이 문제는 제품이 절전 모드로 전환되거나 다시 시작된 후에 발생할 수 있습니다. 로컬 Atlas 배포서버에 연결하려고 하면 이 오류가 발생합니다.

Atlas CLI는 Podman 을 사용합니다.및 QEMU MongoDB의 Docker화된 인스턴스를 실행합니다. Podman은 데몬이 없는 아키텍처를 가지고 있습니다. 따라서 로컬 MongoDB 인스턴스는 자동으로 다시 시작되지 않습니다.

이 문제를 해결하려면 다음을 수행하세요.

  1. 사용 가능한 배포를 나열합니다.

    atlas deployments list
  2. container를 재개하려면 다음 명령을 복사하여 터미널에 붙여넣고 {deployment-name} 를 시작할 배포의 이름으로 바꿉니다.

    atlas deployments start {deployment-name}

이 공개 미리 보기 단계 중에는 로컬 Atlas 배포를 위한 Windows가 지원되지 않습니다.

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

메모리를 더 할당하는 것이 좋습니다.

  1. Podman 머신을 중지합니다:

    podman machine stop
  2. 시스템 설정에 따라 더 많은 메모리를 할당합니다.

    podman machine set --cpus 3 --memory 5120
  3. Podman 머신을 시작합니다:

    podman machine start
  4. Podman container를 나열합니다.

    podman ps --all
  5. container를 재개하려면 다음 명령을 복사하여 터미널에 붙여넣고 {container-name} 를 시작할 container의 이름으로 바꿉니다.

    podman start {container-name}

Atlas CLI는 Podmanatlas deployments 사용합니다. 명령의 경우.

Podman을 설치하려면 다음 명령을 실행하세요.

brew install podman

Podman 머신을 초기화하려면 다음 명령을 실행합니다.

podman machine init

Podman 머신을 시작하려면 다음 명령을 실행합니다.

podman machine start

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

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

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

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

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

  • atlas config init 를 실행하고 프로필 에 API 키를 추가하거나 환경 변수 에 API 키를 추가합니다. 사용자 지정 이름으로 프로필을 만들었거나 둘 이상의 프로필을 사용하는 경우 --profile 플래그를 사용하여 올바른 프로필을 지정합니다.

  • atlas auth login 를 실행하여 Atlas 로그인 자격 증명과 인증 토큰을 사용하여 인증합니다.

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

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

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

제공한 자격 증명이 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 IDproject ID 은 MongoDB cloud 서비스에서 동의어입니다.

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

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

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

← 페더레이션 인증