Docs Menu
Docs Home
/
MongoDB Atlas
/
MongoDB CLI

MongoDB CLI 구성

이 페이지의 내용

  • 전제 조건
  • 절차
  • 다음 단계

mongocli 인증 로그인 또는 mongocli config 명령을 사용하여 가 , 및 와 같은 MongoDB CLI MongoDB 서비스와 상호 작용 하는 데 사용하는 설정을 정의할 수 Atlas 있습니다. Cloud Manager MongoDB Ops Manager 이러한 명령 중 하나를 처음 실행 하면 MongoDB CLI 가 config.toml 라는 구성 파일 을 생성하여 설정을 저장 합니다.

전제 조건

MongoDB CLI를 구성하려면 다음을 실행합니다.

  • MongoDB 서비스의 API 액세스 목록에IP 또는 CIDR 블록을 추가합니다.

  • 프로그래밍 방식 API 키가 아직 없는 경우 생성합니다.

    참고

    프로그래매틱 API 키는 역할 기반입니다. 역할에 따라 권한과 기능이 다르며, 일부 MongoDB CLI 명령은 일부 역할에서 사용할 수 있지만 다른 역할에서는 사용할 수 없습니다. 프로그래매틱 API 키에 할당된 역할이 사용하려는 명령에 적합한지 확인하세요.

    MongoDB 서비스를 위한 프로그래매틱 API 키 생성에 대해 자세히 알아보려면 다음 문서를 참조하세요.

    • Atlas API Access

    • Cloud Manager API 액세스

    • Ops Manager API 액세스

  • HTTP_PROXY HTTPS_PROXY MongoDB CLI 설치가 방화벽으로 보호되고 프록시 URL 을 사용하려는 경우 또는 환경 변수 를 설정합니다. MongoDB CLI는 http, https 및 socks5 체계를 지원합니다. 또한 프록시 서비스의 액세스 목록에서 기본 대상 URL로 cloud.mongodb.com/ 를 지정합니다. 프록시 구성에서 인증이 활성화된 경우에도 사용자 이름과 비밀번호를 지정해야 합니다.

    자세한 내용은 프록시 서버를 참조하세요.

절차

1

Atlas에 인증합니다.

  1. mongocli auth login 명령을 실행합니다.

    mongocli auth login

    이 명령은 브라우저 창을 열고 일회성 활성화 코드를 반환합니다. 이 코드는 10분 후에 만료됩니다.

  2. 아직 로그인하지 않은 경우 브라우저에서 Atlas 계정에 로그인하십시오.

  3. 활성화 코드를 브라우저에 붙여넣고 Confirm Authorization을 클릭합니다.

2

프로필을 만듭니다.

터미널에서 Enter 를 눌러 default MongoDB CLI 구성 파일 에 라는 프로필 을 만듭니다.

3

기본값 조직 을 선택합니다.

  1. 조직을 선택합니다.

    • Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하거나

    • 조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.

    ? Choose a default organization:  [Use arrows to move, type to filter]
    > Org1 (5e39bf1212121e685774c81c)

  2. Enter키를 누릅니다.

4

기본 프로젝트를 선택합니다.

  1. 프로젝트를 선택하세요.

    • Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하거나

    • 사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.

    ? Choose a default project:  [Use arrows to move, type to filter]
      Project1 (5e5ebffd0c04a97009061234)
      Project2 (5cfacee6014b761b07f15678)
    > Project3 (5e39bf4979358e6857741212)
      Project4 (5c815cc7014b768fb67e3434)

  2. Enter키를 누릅니다.

5

기본 출력 형식을 선택합니다.

  1. Down Arrow 및 Up Arrow 키를 눌러 원하는 기본 출력 형식을 강조 표시합니다.

    ? Default Output Format:  [Use arrows to move, type to filter]
    > plaintext
      json
    옵션
    설명
    plaintext
    사람이 읽을 수 있는 출력으로, MongoDB CLI가 반환하는 모든 필드를 포함합니다.
    json
    MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

  2. Enter키를 누릅니다.

6

시스템에서mongosh MongoDB Shell경로를 지정합니다.

MongoDB CLI는 사용자가 배포에 액세스할 수 있도록 지정된 mongosh 경로를 사용합니다. 기본값은 /usr/local/bin/mongosh입니다. 기본값을 수락하려면 Enter을(를) 누르거나 다음을 수행하세요.

  1. 시스템에서 mongosh에 대한 경로를 지정하세요.

    ? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

  2. Enter키를 누릅니다.

7

선택 사항: 프로필에 API 키를 추가합니다.

인증에 성공하면 12 시간 동안 MongoDB CLI에 계속 로그인할 수 있습니다. 12 시간 이상 프로그래밍 방식으로 액세스해야 하는 계정의 경우 mongocli config set 명령을 사용하여 프로필에 대한 API 키를 구성합니다.

mongocli config set public_api_key abcdef
mongocli config set private_api_key a123bc45-ab1c-234d-5678-f91234a5bc6d

참고

프로그래매틱 API 키는 역할 기반입니다. 역할에 따라 권한과 기능이 다르며, 일부 MongoDB CLI 명령은 일부 역할에서 사용할 수 있지만 다른 역할에서는 사용할 수 없습니다. 사용하려는 명령에 적합한 역할을 프로그래매틱 API 키에 할당해야 합니다.

Atlas용 API 키 생성에 대해 자세히 알아보려면 프로그래밍 방식 API 키를 참조하세요.

8

프로필을 인증합니다.

구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.

예시

다음 명령은 기본 프로필의 설정을 반환합니다.

mongocli config describe default

앞의 명령은 다음과 같은 설정을 반환합니다. 보안상의 이유로 이 명령은 출력에서 API 키를 삭제합니다.

SETTING           VALUE
mongosh_path      /usr/local/bin/mongosh
org_id            5f1f39ffc902201990f12345
private_api_key   redacted
project_id        7ehf04abc10defb66c7d1234c
public_api_key    redacted
service           cloud

예시

다음 명령은 myMongoDB 프로필의 설정을 반환합니다.

mongocli config describe myMongoDB

이 명령은 다음 설정을 반환합니다. 보안을 위해 이 명령은 출력에서 API 키를 삭제합니다.

SETTING           VALUE
org_id            5f1f39ffc902201990f12345
private_api_key   redacted
project_id        7ehf04abc10defb66c7d1234c
public_api_key    redacted
service           cloud
1

MongoDB Cloud Manager 에 인증합니다.

  1. mongocli auth login 명령을 실행합니다.

    mongocli auth login --cm

    이 명령은 브라우저 창을 열고 일회성 활성화 코드를 반환합니다. 이 코드는 10분 후에 만료됩니다.

  2. 아직 로그인하지 않은 경우 브라우저에서 MongoDB Cloud Manager 계정에 로그인합니다.

  3. 활성화 코드를 브라우저에 붙여넣고 Confirm Authorization을 클릭합니다.

2

프로필을 만듭니다.

터미널에서 Enter을(를) 눌러 MongoDB CLI 구성 파일에 default(이)라는 프로필을 만듭니다.

3

기본값 조직 을 선택합니다.

  1. 조직을 선택합니다.

    • Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하거나

    • 조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.

    ? Choose a default organization:  [Use arrows to move, type to filter]
    > Org1 (5e39bf1212121e685774c81c)

  2. Enter키를 누릅니다.

4

기본 프로젝트를 선택합니다.

  1. 프로젝트를 선택하세요.

    • Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하거나

    • 사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.

    ? Choose a default project:  [Use arrows to move, type to filter]
      Project1 (5e5ebffd0c04a97009061234)
      Project2 (5cfacee6014b761b07f15678)
    > Project3 (5e39bf4979358e6857741212)
      Project4 (5c815cc7014b768fb67e3434)

  2. Enter키를 누릅니다.

5

기본 출력 형식을 선택합니다.

  1. Down Arrow 및 Up Arrow 키를 눌러 원하는 기본 출력 형식을 강조 표시합니다.

    ? Default Output Format:  [Use arrows to move, type to filter]
    > plaintext
      json
    옵션
    설명
    plaintext
    사람이 읽을 수 있는 출력으로, MongoDB CLI가 반환하는 모든 필드를 포함합니다.
    json
    MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

  2. Enter키를 누릅니다.

6

시스템에서mongosh MongoDB Shell경로를 지정합니다.

MongoDB CLI는 사용자가 배포에 액세스할 수 있도록 지정된 mongosh 경로를 사용합니다. 기본값은 /usr/local/bin/mongosh입니다. 기본값을 수락하려면 Enter을(를) 누르거나 다음을 수행하세요.

  1. 시스템에서 mongosh에 대한 경로를 지정하세요.

    ? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

  2. Enter키를 누릅니다.

7

선택 사항: 프로필에 API 키를 추가합니다.

인증에 성공하면 12 시간 동안 MongoDB CLI에 계속 로그인할 수 있습니다. 12 시간 이상 프로그래밍 방식으로 액세스해야 하는 계정의 경우 mongocli config set 명령을 사용하여 프로필에 대한 API 키를 구성합니다.

mongocli config set public_api_key abcdef
mongocli config set private_api_key a123bc45-ab1c-234d-5678-f91234a5bc6d

참고

프로그래매틱 API 키는 역할 기반입니다. 역할에 따라 권한과 기능이 다르며, 일부 MongoDB CLI 명령은 일부 역할에서 사용할 수 있지만 다른 역할에서는 사용할 수 없습니다. 사용하려는 명령에 적합한 역할을 프로그래매틱 API 키에 할당해야 합니다.

MongoDB Cloud Manager 용 API 키 생성에 대해 자세히 알아보려면 API 키를 참조하세요.

8

프로필을 인증합니다.

구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.

예시

다음 명령은 기본 프로필의 설정을 반환합니다.

mongocli config describe default

앞의 명령은 다음과 같은 설정을 반환합니다. 보안상의 이유로 이 명령은 출력에서 API 키를 삭제합니다.

SETTING           VALUE
mongosh_path      /usr/local/bin/mongosh
org_id            5f1f39ffc902201990f12345
private_api_key   redacted
project_id        7ehf04abc10defb66c7d1234c
public_api_key    redacted
service           cloud-manager

예시

다음 명령은 myMongoDB 프로필의 설정을 반환합니다.

mongocli config describe myMongoDB

이 명령은 다음 설정을 반환합니다. 보안을 위해 이 명령은 출력에서 API 키를 삭제합니다.

SETTING           VALUE
org_id            5f1f39ffc902201990f12345
private_api_key   redacted
project_id        7ehf04abc10defb66c7d1234c
public_api_key    redacted
service           cloud-manager
1

전제 조건을 완료합니다.

MongoDB CLI 를 구성하기 전에 다음을 수행합니다.

  1. 의 액세스 목록에 또는 API CIDR 차단 IP 을 추가합니다.MongoDB Ops Manager

  2. 프로그래밍 방식 API 키가 아직 없는 경우 생성합니다.

참고

프로그래매틱 API 키는 역할 기반입니다. 역할에 따라 권한과 기능이 다르며, 일부 MongoDB CLI 명령은 일부 역할에서 사용할 수 있지만 다른 역할에서는 사용할 수 없습니다. 사용하려는 명령에 적합한 역할을 프로그래매틱 API 키에 할당해야 합니다.

용 프로그래밍 방식 API 키를 생성하는 방법에 학습 MongoDB Ops Manager 보려면 MongoDB Ops Manager API 액세스를 참조하세요.

2

프로필을 만듭니다.

이 명령은 MongoDB CLI 구성 파일 에 라는 프로필을 생성합니다.default

mongocli config 명령을 실행합니다.

mongocli config --service ops-manager

이 명령은 MongoDB CLI 구성 파일 에 사용자 지정 이름으로 프로필 을 생성합니다. 명령에서 이 프로필을 사용하려면 --profile 플래그를 사용하여 프로필을 지정해야 합니다.

mongocli config 명령을 실행합니다.

mongocli config --service ops-manager --profile <profile-name>
3

Ops Manager 에 액세스 하는 데 사용할 URL 을 입력합니다.

? URL to Access Ops Manager: http://mms.example.com:8080/
4

선택 사항:API 키를 입력합니다.

메시지가 표시되면 MongoDB Ops Manager 배포서버 서버에 대한 Public API Key 및 Private API Key 를 입력합니다.

? Public API Key: [? for help] abcdef
? Private API Key: [? for help]
************************************
5

기본값 조직 을 선택합니다.

API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 조직의 이름과 ID 를 표시합니다.

  1. 조직을 선택합니다.

    • Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하거나

    • 조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.

    ? Choose a default organization:  [Use arrows to move, type to filter]
    > Org1 (5e39bf1212121e685774c81c)

  2. Enter키를 누릅니다.

API 키를 입력하지 않은 경우 명령은 Default Organization ID 을(를) 입력하라는 메시지를 표시합니다.

6

기본 프로젝트를 선택합니다.

API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 프로젝트의 이름과 ID 를 표시합니다.

  1. 프로젝트를 선택하세요.

    • Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하거나

    • 사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.

    ? Default Project ID:  [Use arrows to move, type to filter]
      Project1 (5e5ebffd0c04a97009061234)
      Project2 (5cfacee6014b761b07f15678)
    > Project3 (5e39bf4979358e6857741212)
      Project4 (5c815cc7014b768fb67e3434)

  2. Enter키를 누릅니다.

API 키를 입력하지 않은 경우 명령은 Default Project ID 을(를) 입력하라는 메시지를 표시합니다.

7

기본 출력 형식을 선택합니다.

  1. Down Arrow 및 Up Arrow 키를 눌러 원하는 기본 출력 형식을 강조 표시합니다.

    ? Default Output Format:  [Use arrows to move, type to filter]
    > plaintext
      json
    옵션
    설명
    plaintext
    사람이 읽을 수 있는 출력으로, MongoDB CLI가 반환하는 모든 필드를 포함합니다.
    json
    MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

  2. Enter키를 누릅니다.

8

시스템에서mongosh MongoDB Shell경로를 지정합니다.

MongoDB CLI는 사용자가 배포에 액세스할 수 있도록 지정된 mongosh 경로를 사용합니다. 기본값은 /usr/local/bin/mongosh입니다. 기본값을 수락하려면 Enter을(를) 누르거나 다음을 수행하세요.

  1. 시스템에서 mongosh에 대한 경로를 지정하세요.

    ? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)

  2. Enter키를 누릅니다.

9

프로필을 인증합니다.

구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.

예시

다음 명령은 기본 프로필의 설정을 반환합니다.

mongocli config describe default

앞의 명령은 다음과 같은 설정을 반환합니다. 보안상의 이유로 이 명령은 출력에서 API 키를 삭제합니다.

SETTING           VALUE
mongosh_path      /usr/local/bin/mongosh
ops_manager_url = https://mms.example.com:8080/
org_id            5f1f39ffc902201990f12345
private_api_key   redacted
project_id        7ehf04abc10defb66c7d1234c
public_api_key    redacted
service           ops-manager

예시

다음 명령은 myMongoDB 프로필의 설정을 반환합니다.

mongocli config describe myMongoDB

이 명령은 다음 설정을 반환합니다. 보안을 위해 이 명령은 출력에서 API 키를 삭제합니다.

SETTING           VALUE
ops_manager_url = https://mms.example.com:8080/
org_id            5f1f39ffc902201990f12345
private_api_key   redacted
project_id        7ehf04abc10defb66c7d1234c
public_api_key    redacted
service           ops-manager

다음 단계

돌아가기

패키지 확인

다음

구성 파일

이 페이지의 내용