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 키 생성에 대해 자세히 알아보려면 다음 문서를 참조하세요.
HTTP_PROXY
HTTPS_PROXY
MongoDB CLI 설치가 방화벽으로 보호되고 프록시 URL 을 사용하려는 경우 또는 환경 변수 를 설정합니다. MongoDB CLI는http
,https
및socks5
체계를 지원합니다. 또한 프록시 서비스의 액세스 목록에서 기본 대상 URL로cloud.mongodb.com/
를 지정합니다. 프록시 구성에서 인증이 활성화된 경우에도 사용자 이름과 비밀번호를 지정해야 합니다.자세한 내용은 프록시 서버를 참조하세요.
절차
Atlas에 인증합니다.
mongocli auth login 명령을 실행합니다.
mongocli auth login 이 명령은 브라우저 창을 열고 일회성 활성화 코드를 반환합니다. 이 코드는 10분 후에 만료됩니다.
아직 로그인하지 않은 경우 브라우저에서 Atlas 계정에 로그인하십시오.
활성화 코드를 브라우저에 붙여넣고 Confirm Authorization을 클릭합니다.
프로필을 만듭니다.
터미널에서 Enter
를 눌러 default
MongoDB CLI 구성 파일 에 라는 프로필 을 만듭니다.
기본 프로젝트를 선택합니다.
프로젝트를 선택하세요.
Down Arrow
및Up Arrow
키를 눌러 원하는 프로젝트를 강조 표시하거나사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.
? Choose a default project: [Use arrows to move, type to filter] Project1 (5e5ebffd0c04a97009061234) Project2 (5cfacee6014b761b07f15678) Project3 (5e39bf4979358e6857741212) Project4 (5c815cc7014b768fb67e3434) Enter
키를 누릅니다.
시스템에서mongosh
MongoDB Shell경로를 지정합니다.
MongoDB CLI는 사용자가 배포에 액세스할 수 있도록 지정된 mongosh
경로를 사용합니다. 기본값은 /usr/local/bin/mongosh
입니다. 기본값을 수락하려면 Enter
을(를) 누르거나 다음을 수행하세요.
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
선택 사항: 프로필에 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 키를 참조하세요.
프로필을 인증합니다.
구성 파일을 보거나 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
MongoDB Cloud Manager 에 인증합니다.
mongocli auth login 명령을 실행합니다.
mongocli auth login --cm 이 명령은 브라우저 창을 열고 일회성 활성화 코드를 반환합니다. 이 코드는 10분 후에 만료됩니다.
아직 로그인하지 않은 경우 브라우저에서 MongoDB Cloud Manager 계정에 로그인합니다.
활성화 코드를 브라우저에 붙여넣고 Confirm Authorization을 클릭합니다.
프로필을 만듭니다.
터미널에서 Enter
을(를) 눌러 MongoDB CLI 구성 파일에 default
(이)라는 프로필을 만듭니다.
기본 프로젝트를 선택합니다.
프로젝트를 선택하세요.
Down Arrow
및Up Arrow
키를 눌러 원하는 프로젝트를 강조 표시하거나사용 가능한 프로젝트를 필터링하려면 프로젝트 이름을 입력하세요.
? Choose a default project: [Use arrows to move, type to filter] Project1 (5e5ebffd0c04a97009061234) Project2 (5cfacee6014b761b07f15678) Project3 (5e39bf4979358e6857741212) Project4 (5c815cc7014b768fb67e3434) Enter
키를 누릅니다.
시스템에서mongosh
MongoDB Shell경로를 지정합니다.
MongoDB CLI는 사용자가 배포에 액세스할 수 있도록 지정된 mongosh
경로를 사용합니다. 기본값은 /usr/local/bin/mongosh
입니다. 기본값을 수락하려면 Enter
을(를) 누르거나 다음을 수행하세요.
시스템에서
mongosh
에 대한 경로를 지정하세요.? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh) Enter
키를 누릅니다.
선택 사항: 프로필에 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 키를 참조하세요.
프로필을 인증합니다.
구성 파일을 보거나 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
전제 조건을 완료합니다.
MongoDB CLI 를 구성하기 전에 다음을 수행합니다.
의 액세스 목록에 또는 API CIDR 차단 IP 을 추가합니다.MongoDB Ops Manager
프로그래밍 방식 API 키가 아직 없는 경우 생성합니다.
참고
프로그래매틱 API 키는 역할 기반입니다. 역할에 따라 권한과 기능이 다르며, 일부 MongoDB CLI 명령은 일부 역할에서 사용할 수 있지만 다른 역할에서는 사용할 수 없습니다. 사용하려는 명령에 적합한 역할을 프로그래매틱 API 키에 할당해야 합니다.
용 프로그래밍 방식 API 키를 생성하는 방법에 학습 MongoDB Ops Manager 보려면 MongoDB Ops Manager API 액세스를 참조하세요.
프로필을 만듭니다.
이 명령은 MongoDB CLI 구성 파일 에 라는 프로필을 생성합니다.default
mongocli config 명령을 실행합니다.
mongocli config --service ops-manager
이 명령은 MongoDB CLI 구성 파일 에 사용자 지정 이름으로 프로필 을 생성합니다. 명령에서 이 프로필을 사용하려면 --profile
플래그를 사용하여 프로필을 지정해야 합니다.
mongocli config 명령을 실행합니다.
mongocli config --service ops-manager --profile <profile-name>
Ops Manager 에 액세스 하는 데 사용할 URL 을 입력합니다.
? 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
키를 눌러 원하는 조직을 강조 표시하거나조직 이름을 입력하여 사용 가능한 조직을 필터링합니다.
? Choose a default organization: [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 명령을 실행하여 프로필을 확인합니다.
예시
다음 명령은 기본 프로필의 설정을 반환합니다.
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
다음 단계
프로필을 추가하거나 수정하려면 구성 파일을 편집합니다.
환경 변수를 설정하여 더 쉽게 스크립팅할 수 있습니다.
자동 완성을 활성화하면 사용 가능한 명령과 해당 구문을 셸에서 직접 확인할 수 있습니다.