MongoDB CLI 구성
You can define the settings that the MongoDB CLI uses to interact with MongoDB services like Atlas, Cloud Manager, and Ops Manager by using the mongocli config command. The first time you run this command, the MongoDB CLI creates a configuration file called mongocli.toml
to store your settings.
전제 조건
MongoDB CLI를 구성하려면 다음을 실행합니다.
MongoDB 서비스의 API 액세스 목록에IP 또는 CIDR 블록을 추가합니다.
프로그래밍 방식 API 키가 아직 없는 경우 생성합니다.
참고
프로그래매틱 API 키는 역할 기반입니다. 역할마다 권한과 기능이 다르며, 일부 MongoDB CLI 명령은 일부 역할에서는 사용할 수 있지만 다른 역할에서는 사용할 수 없습니다. 프로그래매틱 API 키에 할당된 역할이 사용하려는 명령에 적합한지 확인하세요.
MongoDB 서비스를 위한 프로그래매틱 API 키 생성에 대해 자세히 알아보려면 다음 문서를 참조하세요.
절차
mongocli config 명령은 MongoDB CLI를 구성하려는 MongoDB 서비스에 따라 약간 다릅니다.
프로필을 만듭니다.
이 명령은 MongoDB CLI 구성 파일 에 사용자 지정 이름으로 프로필 을 생성합니다. 명령에서 이 프로필을 사용하려면 --profile
플래그를 사용하여 프로필을 지정해야 합니다.
mongocli config 명령을 실행합니다.
mongocli config --profile <profile-name>
Optional: Enter your Programmatic API Key.
메시지가 표시되면 Atlas 배포서버에 사용할 Public API Key
및 Private API Key
를 입력합니다.
? Public API Key: [? for help] abcdef ? Private API Key: [? for help] ************************************
기본값 조직 을 선택합니다.
If you entered API keys, the command displays the name and ID of organizations that your API key can access.
조직을 선택합니다.
Press the
Down Arrow
andUp Arrow
keys to highlight the desired organization, or조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.
? Default Org ID: [Use arrows to move, type to filter] Org1 (5e39bf1212121e685774c81c) Enter
키를 누릅니다.
API 키를 입력하지 않은 경우 명령은 Default Organization ID
을(를) 입력하라는 메시지를 표시합니다.
기본 프로젝트를 선택합니다.
API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 프로젝트의 이름과 ID 를 표시합니다.
프로젝트를 선택하세요.
Down Arrow
및Up Arrow
키를 눌러 원하는 프로젝트를 강조 표시하거나사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.
? Default Project ID: [Use arrows to move, type to filter] Project1 (5e5ebffd0c04a97009061234) Project2 (5cfacee6014b761b07f15678) Project3 (5e39bf4979358e6857741212) Project4 (5c815cc7014b768fb67e3434) Enter
키를 누릅니다.
API 키를 입력하지 않은 경우 명령은 Default Project ID
을(를) 입력하라는 메시지를 표시합니다.
Specify the path to the MongoDB Shell, mongosh
, on your system.
MongoDB CLI uses mongosh
path that you specify to allow you to access your deployments. The default value is /usr/local/bin/mongosh
. Press Enter
to accept the default or:
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
프로필을 인증합니다.
구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.
중요
Your API keys are like passwords. The configuration file stores API keys in plaintext, so ensure that you secure the configuration file appropriately.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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
프로필을 만듭니다.
이 명령은 MongoDB CLI 구성 파일 에 라는 프로필을 생성합니다.default
mongocli config 명령을 실행합니다.
mongocli config --service cloud-manager
이 명령은 MongoDB CLI 구성 파일 에 사용자 지정 이름으로 프로필 을 생성합니다. 명령에서 이 프로필을 사용하려면 --profile
플래그를 사용하여 프로필을 지정해야 합니다.
mongocli config 명령을 실행합니다.
mongocli config --service cloud-manager --profile <profile-name>
Optional: Enter your API keys.
When prompted, enter the Public API Key
and Private API Key
for your MongoDB Cloud Manager deployment.
? Public API Key: [? for help] abcdef ? Private API Key: [? for help] ************************************
기본값 조직 을 선택합니다.
If you entered API keys, the command displays the name and ID of organizations that your API key can access.
조직을 선택합니다.
Down Arrow
및Up Arrow
키를 눌러 원하는 조직을 강조 표시하거나조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.
? Default Org ID: [Use arrows to move, type to filter] Org1 (5e39bf1212121e685774c81c) Enter
키를 누릅니다.
API 키를 입력하지 않은 경우 명령은 Default Organization ID
을(를) 입력하라는 메시지를 표시합니다.
기본 프로젝트를 선택합니다.
API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 프로젝트의 이름과 ID 를 표시합니다.
프로젝트를 선택하세요.
Down Arrow
및Up Arrow
키를 눌러 원하는 프로젝트를 강조 표시하거나사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.
? Default Project ID: [Use arrows to move, type to filter] Project1 (5e5ebffd0c04a97009061234) Project2 (5cfacee6014b761b07f15678) Project3 (5e39bf4979358e6857741212) Project4 (5c815cc7014b768fb67e3434) Enter
키를 누릅니다.
API 키를 입력하지 않은 경우 명령은 Default Project ID
을(를) 입력하라는 메시지를 표시합니다.
Specify the path to the MongoDB Shell, mongosh
, on your system.
MongoDB CLI uses mongosh
path that you specify to allow you to access your deployments. The default value is /usr/local/bin/mongosh
. Press Enter
to accept the default or:
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
프로필을 인증합니다.
구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.
중요
Your API keys are like passwords. The configuration file stores API keys in plaintext, so ensure that you secure the configuration file appropriately.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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
프로필을 만듭니다.
이 명령은 MongoDB CLI 구성 파일 에 라는 프로필을 생성합니다.default
mongocli config 명령을 실행합니다.
mongocli config --service ops-manager
이 명령은 MongoDB CLI 구성 파일 에 사용자 지정 이름으로 프로필 을 생성합니다. 명령에서 이 프로필을 사용하려면 --profile
플래그를 사용하여 프로필을 지정해야 합니다.
mongocli config 명령을 실행합니다.
mongocli config --service ops-manager --profile <profile-name>
Enter the URL you use to access Ops Manager.
? URL to Access Ops Manager: http://mms.example.com:8080
Optional: Enter your API keys.
메시지가 표시되면 MongoDB Ops Manager 배포서버 서버에 대한 Public API Key
및 Private API Key
를 입력합니다.
? Public API Key: [? for help] abcdef ? Private API Key: [? for help] ************************************
기본값 조직 을 선택합니다.
If you entered API keys, the command displays the name and ID of organizations that your API key can access.
조직을 선택합니다.
Down Arrow
및Up Arrow
키를 눌러 원하는 조직을 강조 표시하거나조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.
? Default Org ID: [Use arrows to move, type to filter] Org1 (5e39bf1212121e685774c81c) Enter
키를 누릅니다.
API 키를 입력하지 않은 경우 명령은 Default Organization ID
을(를) 입력하라는 메시지를 표시합니다.
기본 프로젝트를 선택합니다.
API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 프로젝트의 이름과 ID 를 표시합니다.
프로젝트를 선택하세요.
Down Arrow
및Up Arrow
키를 눌러 원하는 프로젝트를 강조 표시하거나사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.
? Default Project ID: [Use arrows to move, type to filter] Project1 (5e5ebffd0c04a97009061234) Project2 (5cfacee6014b761b07f15678) Project3 (5e39bf4979358e6857741212) Project4 (5c815cc7014b768fb67e3434) Enter
키를 누릅니다.
API 키를 입력하지 않은 경우 명령은 Default Project ID
을(를) 입력하라는 메시지를 표시합니다.
Specify the path to the MongoDB Shell, mongosh
, on your system.
MongoDB CLI uses mongosh
path that you specify to allow you to access your deployments. The default value is /usr/local/bin/mongosh
. Press Enter
to accept the default or:
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
프로필을 인증합니다.
구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.
중요
Your API keys are like passwords. The configuration file stores API keys in plaintext, so ensure that you secure the configuration file appropriately.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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
다음 단계
프로필을 추가하거나 수정하려면 구성 파일을 편집합니다.
환경 변수를 설정하여 더 쉽게 스크립팅할 수 있습니다.