연결 설정 저장

이 페이지의 내용

구성 파일 찾기

프로필 만들기
프로필 업데이트
프로필로 명령 실행

자주 사용하는 연결 설정을 프로필로 저장할 수 있습니다. 프로필은 프로젝트 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 auth login`	Atlas 로그인 자격 증명 및 인증 토큰	프로그래밍이 아닌 용도에 적합
`atlas config init`	API 키	프로그래밍 방식에 가장 적합

자세한 내용 은 연결 방법 선택을 참조하세요.

사전 요구 사항을 완료하세요.

Atlas CLI를 설치합니다.
호스트의 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> 플래그를 사용하려면 명명된 프로필을 만듭니다.

다음 단계에 따라 기본 프로필을 만듭니다. 기본 프로필이 이미 존재하는 경우 이 명령은 기본 프로필의 값을 업데이트합니다.

인증 명령을 실행합니다.

터미널에서 atlas auth login 명령을 실행합니다.

atlas auth login

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

Atlas에 로그인합니다.

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

권한 부여 코드를 입력합니다.

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

Atlas CLI로 돌아갑니다.

터미널로 돌아갑니다. 연결에 성공하면 메시지가 표시됩니다.

Successfully logged in as {Your Email Address}.

기본 조직을 선택합니다.

Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하고 Enter 을 누릅니다.

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

참고

500개 이상의 조직에 액세스할 수 있는 경우 화살표를 사용하여 조직을 선택하기 전에 결과를 필터링할 조직 ID 또는 조직 이름을 입력해야 합니다.

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하고 Enter 를 누릅니다.

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

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 출력 형식을 강조 표시하고 Enter 를 누릅니다.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

옵션	설명
`plaintext`	사람이 읽을 수 있는 출력으로, 다음과 같은 모든 필드를 포함합니다. Atlas CLI가 반환됩니다.
`json`	MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

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

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"

사용자 지정 이름으로 프로필을 만들려면 다음 단계를 따르세요.

인증 명령을 실행합니다.

터미널에서 profile <profileName> 플래그를 사용하여 atlas auth login 명령을 실행합니다. <profileName> 는 새 프로필에 사용할 이름이어야 합니다.

atlas auth login --profile myProfile

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

Atlas에 로그인합니다.

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

권한 부여 코드를 입력합니다.

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

Atlas CLI로 돌아갑니다.

터미널로 돌아갑니다. 연결에 성공하면 메시지가 표시됩니다.

Successfully logged in as {Your Email Address}.

기본 조직을 선택합니다.

Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하고 Enter 를 누릅니다.

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

참고

500개 이상의 조직에 액세스할 수 있는 경우 화살표를 사용하여 조직을 선택하기 전에 결과를 필터링할 조직 ID 또는 조직 이름을 입력해야 합니다.

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하고 Enter 를 누릅니다.

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

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 출력 형식을 강조 표시하고 Enter 를 누릅니다.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

옵션	설명
`plaintext`	사람이 읽을 수 있는 출력으로, 다음과 같은 모든 필드를 포함합니다. Atlas CLI가 반환됩니다.
`json`	MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

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

? 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> 플래그를 사용하려면 명명된 프로필을 만듭니다.

다음 단계에 따라 기본 프로필을 만듭니다. 기본 프로필이 이미 존재하는 경우 이 명령은 기본 프로필의 값을 업데이트합니다.

인증 명령을 실행합니다.

터미널에서 atlas config init 명령을 실행합니다.

atlas config init

API 키를 입력합니다.

메시지가 표시되면 공개 키와 비공개 키를 입력합니다.

기본 조직을 선택합니다.

Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하고 Enter 를 누릅니다.

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

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하고 Enter 를 누릅니다.

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

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 출력 형식을 강조 표시하고 Enter 를 누릅니다.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

옵션	설명
`plaintext`	사람이 읽을 수 있는 출력으로, Atlas CLI가 반환하는 모든 필드를 포함합니다.
`json`	MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

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

? 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"

사용자 지정 이름으로 프로필을 만들려면 다음 단계를 따르세요.

인증 명령을 실행합니다.

터미널에서 profile <profileName> 플래그를 사용하여 atlas config init 명령을 실행합니다. <profileName> 는 새 프로필에 사용할 이름이어야 합니다.

atlas config init --profile myProfile

API 키를 입력합니다.

메시지가 표시되면 공개 키와 비공개 키를 입력합니다.

기본 조직을 선택합니다.

Down Arrow 및 Up Arrow 키를 눌러 원하는 조직을 강조 표시하고 Enter 를 누릅니다.

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

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 프로젝트를 강조 표시하고 Enter 를 누릅니다.

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

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

Down Arrow 및 Up Arrow 키를 눌러 원하는 출력 형식을 강조 표시하고 Enter 를 누릅니다.

? Default Output Format:  [Use arrows to move, type to filter]
> plaintext
  json

옵션	설명
`plaintext`	사람이 읽을 수 있는 출력으로, Atlas CLI가 반환하는 모든 필드를 포함합니다.
`json`	MongoDB CLI가 반환하는 모든 필드를 포함하는 JSON 출력입니다.

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

? 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>

돌아가기

Atlas CLI에서 연결

Atlas CLI로 마이그레이션합니다.

연결 설정 저장.leafygreen-ui-m0pgrr{-webkit-align-self:center;-ms-flex-item-align:center;align-self:center;padding:0 10px;visibility:hidden;}.leafygreen-ui-a30zj9{color:#889397;vertical-align:middle;margin-top:-2px;}.css-1l4s55v{margin-top:-175px;position:absolute;padding-bottom:2px;}

참고

구성 파일 찾기

프로필 만들기

사용 사례 선택

사전 요구 사항을 완료하세요.

중요

다음 단계를 따르세요.

인증 명령을 실행합니다.

Atlas에 로그인합니다.

권한 부여 코드를 입력합니다.

Atlas CLI로 돌아갑니다.

기본 조직을 선택합니다.

참고

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

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

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

프로필 설정을 확인합니다.

인증 명령을 실행합니다.

Atlas에 로그인합니다.

권한 부여 코드를 입력합니다.

Atlas CLI로 돌아갑니다.

기본 조직을 선택합니다.

참고

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

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

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

프로필 설정을 확인합니다.

인증 명령을 실행합니다.

API 키를 입력합니다.

기본 조직을 선택합니다.

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

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

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

프로필 설정을 확인합니다.

인증 명령을 실행합니다.

API 키를 입력합니다.

기본 조직을 선택합니다.

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

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

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

프로필 설정을 확인합니다.

프로필 업데이트

프로필로 명령 실행

예제

연결 설정 저장

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

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

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

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