자주 사용하는 연결 설정을 프로필로 저장할 수 있습니다. 프로필은 프로젝트 ID, 조직 ID 및 선택 사항으로 향후 Atlas CLI 세션에서 사용할 API 키를 저장합니다. 시간을 절약하기 위해 각 명령에 --projectId 및 --orgId 플래그를 사용하는 대신 프로필을 지정할 수 있습니다. Atlas CLI는 config.toml 이라는 구성 파일 에 프로필을 저장합니다.
참고
환경 변수 에 저장된 모든 설정은 프로필에 저장된 설정보다 우선합니다. --projectId 및 --orgId 플래그로 지정된 모든 프로젝트 또는 조직 은 프로필과 환경 변수 모두보다 우선합니다.
구성 파일 찾기
Atlas CLI는 운영 체제에 따라 구성 파일을 다음 위치에 저장합니다.
%AppData/atlascli
/Users/{username}/Library/Application Support/atlascli
$XDG_CONFIG_HOME/atlascli
기본값 으로 Atlas CLI $XDG_CONFIG_HOME 환경 변수에 정의된 경로에 구성 파일 저장합니다. $XDG_CONFIG_HOME 변수에 정의된 경로를 원하는 위치 로 수정할 수 있습니다. $XDG_CONFIG_HOME 변수 수정에 대해 자세히 학습하려면 XDG 기본 디렉토리 사양을참조하세요.
$XDG_CONFIG_HOME 이(가) 설정되지 않은 경우 Atlas CLI는 다음을 사용합니다.
$HOME/.config/atlascli
Atlas CLI는 명령을 실행한 사용자에게 파일에 대한 읽기 및 쓰기 액세스 권한을 부여합니다.
프로필 만들기
atlas auth login 또는 atlas config init 명령을 처음 실행하면 Atlas CLI가 자동으로 config.toml 파일과 기본 프로필을 생성합니다. 프로필, 환경 변수 또는 --projectId 및 --orgId 플래그를 지정하지 않고 명령을 실행하는 경우 Atlas CLI는 명령에 기본 프로필을 사용합니다.
사용 사례 선택
사용 사례에 따라 연결 방법을 선택하세요.
옵션 | 인증 방법 | 사용 사례 |
|---|---|---|
| Atlas 로그인 자격 증명 및 인증 토큰 | 프로그래밍이 아닌 용도에 적합 |
| 서비스 계정 | 서비스 계정과 함께 프로그래밍 방식으로 사용하기에 가장 좋습니다. |
| API 키 | API 키와 함께 프로그래밍 방식으로 사용하는 데 가장 적합합니다. |
자세한 내용 은 연결 방법 선택을 참조하세요.
사전 요구 사항을 완료하세요.
호스트의 IP 주소를 IP 액세스 목록에추가합니다.
연결 방법으로
atlas config init를 선택하는 경우 API 키를 구성해야 합니다.방화벽으로 보호되는 Atlas CLI 설치에서 프록시 URL 을 사용하려는 경우
HTTP_PROXY또는HTTPS_PROXY환경 변수를 설정합니다.중요
Atlas CLI는
http,https및socks5체계를 지원합니다. 프록시 서비스의 액세스 목록에서 기본 대상 URL로cloud.mongodb.com/를 지정해야 합니다. 프록시 구성에서 인증이 활성화된 경우에는 사용자 이름과 비밀번호도 지정해야 합니다.
다음 단계를 따르세요.
사용 사례를 선택하고 절차에 따라 프로필을 만듭니다.
기본 프로필 또는 명명된 프로필을 선택합니다.
다음을 위한 기본 프로필을 생성합니다.
프로필, 환경 변수 또는
--projectId및--orgId플래그를 지정하지 않고 명령을 실행합니다.--profile default플래그를 사용합니다.
--profile <profileName> 플래그를 사용하려면 명명된 프로필을 만듭니다.
다음 단계에 따라 기본 프로필을 만듭니다. 기본 프로필이 이미 존재하는 경우 이 명령은 기본 프로필의 값을 업데이트합니다.
시스템에서mongosh MongoDB Shell경로를 지정합니다.
Atlas CLI 는 지정된 mongosh 경로를 사용하므로 배포서버에 액세스 할 수 있습니다. 기본값 은 /usr/local/bin/mongosh 입니다. Enter 를 눌러 기본값 을 수락하거나 시스템에서 mongosh 의 경로를 지정하고 Enter 를 누릅니다.
? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)
프로필 설정을 확인합니다.
구성 파일을 보거나 atlas config describe 명령을 실행하여 프로필을 확인합니다. 기본 프로필의 경우 <profileName> 은 default 입니다.
atlas config describe <profileName>
이 명령은 다음 설정을 반환합니다. Atlas CLI는 보안을 위해 액세스 토큰을 삭제하고 토큰 값을 새로 고칩니다.
SETTING VALUE "access_token": "redacted", "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "project_id": "60c94857241ae99848af45ad", "refresh_token": "redacted", "service": "cloud"
사용자 지정 이름으로 프로필을 만들려면 다음 단계를 따르세요.
시스템에서mongosh MongoDB Shell경로를 지정합니다.
Atlas CLI 는 지정된 mongosh 경로를 사용하므로 배포서버에 액세스 할 수 있습니다. 기본값 은 /usr/local/bin/mongosh 입니다. Enter 를 눌러 기본값 을 수락하거나 시스템에서 mongosh 의 경로를 지정하고 Enter 를 누릅니다.
? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)
프로필 설정을 확인합니다.
구성 파일을 보거나 atlas config describe 명령을 실행하여 프로필을 확인합니다. 기본 프로필의 경우 <profileName> 은 default 입니다.
atlas config describe <profileName>
이 명령은 다음 설정을 반환합니다. Atlas CLI는 보안을 위해 액세스 토큰을 삭제하고 토큰 값을 새로 고칩니다.
SETTING VALUE "access_token": "redacted", "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "project_id": "60c94857241ae99848af45ad", "refresh_token": "redacted", "service": "cloud"
기본 프로필 또는 명명된 프로필을 선택합니다.
다음을 위한 기본 프로필을 생성합니다.
프로필, 환경 변수 또는
--projectId및--orgId플래그를 지정하지 않고 명령을 실행합니다.--profile default플래그를 사용합니다.
--profile <profileName> 플래그를 사용하려면 명명된 프로필을 만듭니다.
다음 단계에 따라 기본 프로필을 만듭니다. 기본 프로필이 이미 존재하는 경우 이 명령은 기본 프로필의 값을 업데이트합니다.
시스템에서mongosh MongoDB Shell경로를 지정합니다.
Atlas CLI 는 지정된 mongosh 경로를 사용하므로 배포서버에 액세스 할 수 있습니다. 기본값 은 /usr/local/bin/mongosh 입니다. Enter 를 눌러 기본값 을 수락하거나 시스템에서 mongosh 의 경로를 지정하고 Enter 를 누릅니다.
? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)
프로필 설정을 확인합니다.
구성 파일을 보거나 atlas config describe 명령을 실행하여 프로필을 확인합니다. 기본 프로필의 경우 <profileName> 은 default 입니다.
atlas config describe <profileName>
이 명령은 다음 설정을 반환합니다. Atlas CLI 는 보안을 위해 API 키 값을 삭제합니다.
SETTING VALUE "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "private_api_key": "redacted", "project_id": "60c94857241ae99848af45ad", "public_api_key": "redacted", "service": "cloud"
사용자 지정 이름으로 프로필을 만들려면 다음 단계를 따르세요.
시스템에서mongosh MongoDB Shell경로를 지정합니다.
Atlas CLI 는 지정된 mongosh 경로를 사용하므로 배포서버에 액세스 할 수 있습니다. 기본값 은 /usr/local/bin/mongosh 입니다. Enter 를 눌러 기본값 을 수락하거나 시스템에서 mongosh 의 경로를 지정하고 Enter 를 누릅니다.
? Default MongoDB Shell Path: [? for help] (/usr/local/bin/mongosh)
프로필 설정을 확인합니다.
구성 파일을 보거나 atlas config describe 명령을 실행하여 프로필을 확인합니다. 기본 프로필의 경우 <profileName> 은 default 입니다.
atlas config describe <profileName>
이 명령은 다음 설정을 반환합니다. Atlas CLI 는 보안을 위해 API 키 값을 삭제합니다.
SETTING VALUE "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "private_api_key": "redacted", "project_id": "60c94857241ae99848af45ad", "public_api_key": "redacted", "service": "cloud"
프로필 업데이트
다음과 같은 방법으로 구성 파일에 저장된 설정을 업데이트할 수 있습니다.
텍스트 편집기로
config.toml파일을 편집합니다.설정에 대해
atlas config set명령을 실행합니다. 이렇게 하면config.toml파일의 개별 값이 편집됩니다.
프로필로 명령 실행
프로필을 사용하여 Atlas CLI 명령을 실행하려면 다음을 수행합니다.
명령에
--profile <profileName>플래그를 추가하거나--profile <profileName>플래그를 생략하여 기본 프로필을 사용합니다.
예시
이 명령은 myProfile 이라는 프로필을 사용합니다.
atlas <command> --profile myProfile
이 명령은 기본 프로필을 사용합니다.
atlas <command>