MongoDB CLI 구성
mongocli config 명령을 사용하여 MongoDB CLI MongoDB MongoDB CLI 가 Atlas Atlas Cloud Manager, Cloud Manager 및 MongoDB Ops Manager 와 같은 MongoDB 서비스와 상호 작용 하는 데 사용하는 설정을 정의할 수 있습니다.MongoDB Ops Manager 이 명령을 처음 실행 하면 MongoDB CLI 가 라는 구성 파일 을 생성하여 설정을 저장 mongocli.toml
합니다.
전제 조건
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>
선택 사항:프로그래매틱 API 키를 입력합니다.
메시지가 표시되면 Atlas 배포서버에 사용할 Public API Key
및 Private API Key
를 입력합니다.
? Public API Key: [? for help] abcdef ? Private API Key: [? for help] ************************************
기본값 조직 을 선택합니다.
API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 조직의 이름과 ID 를 표시합니다.
조직을 선택합니다.
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
을(를) 입력하라는 메시지를 표시합니다.
시스템에서mongosh
MongoDB Shell경로를 지정합니다.
MongoDB CLI 는 지정한 경로를 사용하여 배포서버에 액세스 할 수 있습니다.mongosh
기본값 은 /usr/local/bin/mongosh
입니다. 기본값 을 수락하려면 Enter
를 누르거나 다음을 수행합니다.
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
프로필을 인증합니다.
구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.
중요
API 키는 비밀번호와 같습니다. 구성 파일 은 API 키를 일반 텍스트로 저장하므로 구성 파일 을 적절히 보호해야 합니다.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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>
기본값 조직 을 선택합니다.
API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 조직의 이름과 ID 를 표시합니다.
조직을 선택합니다.
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
을(를) 입력하라는 메시지를 표시합니다.
시스템에서mongosh
MongoDB Shell경로를 지정합니다.
MongoDB CLI 는 지정한 경로를 사용하여 배포서버에 액세스 할 수 있습니다.mongosh
기본값 은 /usr/local/bin/mongosh
입니다. 기본값 을 수락하려면 Enter
를 누르거나 다음을 수행합니다.
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
프로필을 인증합니다.
구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.
중요
API 키는 비밀번호와 같습니다. 구성 파일 은 API 키를 일반 텍스트로 저장하므로 구성 파일 을 적절히 보호해야 합니다.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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>
MongoDB Ops Manager URL 에 액세스 할 때 사용할 URL 을 입력합니다.MongoDB Ops Manager
? URL to Access Ops Manager: http://mms.example.com:8080
선택 사항:API 키를 입력합니다.
메시지가 표시되면 MongoDB Ops Manager 배포서버 서버에 대한 Public API Key
및 Private API Key
를 입력합니다.
? Public API Key: [? for help] abcdef ? Private API Key: [? for help] ************************************
기본값 조직 을 선택합니다.
API 키를 입력한 경우 명령은 API 키가 액세스 할 수 있는 조직의 이름과 ID 를 표시합니다.
조직을 선택합니다.
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
을(를) 입력하라는 메시지를 표시합니다.
시스템에서mongosh
MongoDB Shell경로를 지정합니다.
MongoDB CLI 는 지정한 경로를 사용하여 배포서버에 액세스 할 수 있습니다.mongosh
기본값 은 /usr/local/bin/mongosh
입니다. 기본값 을 수락하려면 Enter
를 누르거나 다음을 수행합니다.
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
프로필을 인증합니다.
구성 파일을 보거나 mongocli config explain 명령을 실행하여 프로필을 확인합니다.
중요
API 키는 비밀번호와 같습니다. 구성 파일 은 API 키를 일반 텍스트로 저장하므로 구성 파일 을 적절히 보호해야 합니다.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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
다음 단계
프로필을 추가하거나 수정하려면 구성 파일을 편집합니다.
환경 변수를 설정하여 더 쉽게 스크립팅할 수 있습니다.
자동 완성을 활성화하면 사용 가능한 명령과 해당 구문을 셸에서 직접 확인할 수 있습니다.