Atlas CLI에서 연결
연결 방법을 선택합니다.
Atlas CLI에서 기존 Atlas 계정에 연결하는 경우 다음 명령 중 하나를 사용하여 인증할 수 있습니다.
명령 | 인증 방법 | 사용 사례 |
|---|---|---|
atlas auth login | Atlas 로그인 자격 증명 및 인증 토큰 | 프로그래밍이 아닌 용도에 적합 |
atlas config init | API 키 | 프로그래밍 방식에 가장 적합 |
중요
API 키는 Atlas CLI 구성 파일에 플레인 텍스트로 저장됩니다. API 키는 패스워드와 동일합니다. 구성 파일을 적절히 보호하고 있는지 확인합니다.
새 Atlas 계정을 생성하거나 클러스터가 없는 기존 계정을 온보딩하려면 Atlas 시작하기를 참조하세요.
사용 가능한 연결 옵션에 대해 자세히 알아보려면 아래에서 사용 사례를 선택하세요.
atlas auth login 명령을 사용하여 Atlas 로그인 자격 증명과 일회성 인증 토큰으로 인증합니다. atlas auth
login 사용 시에는 수동 로그인 및 인증 토큰 확인이 필요하며, 인증 토큰은 12시간 동안 유효합니다. atlas auth login 연결 시 API 키는 선택 사항입니다.
atlas auth login을 실행한 후에는 다음을 수행할 수 있습니다.
최소한의 필수 설정으로 연결하고 각 명령에
--projectId및--orgId플래그를 지정합니다. 처음 로그인하는 경우 가장 빠르게 시작할 수 있는 방법입니다.연결 설정을 프로필에 저장합니다. 프로필은 프로젝트 ID, 조직 ID, 향후 Atlas CLI 세션에서 사용할 API 키(선택 사항)를 저장합니다. 시간을 절약하기 위해 각 명령에
--projectId및--orgId플래그를 사용하지 않고 대신 프로필을 지정할 수 있습니다.
이 명령으로 인증하려면 API 키를 구성해야 합니다.
atlas config init 명령을 실행하면 Atlas CLI에서 API 키를 제공하라는 메시지를 표시하고 API 키를 저장하는 프로필을 자동으로 생성합니다. atlas config init는 수동 로그인 또는 토큰 확인이 필요하지 않으므로 프로그래밍 방식으로 사용하는 데 가장 적합합니다.
atlas config init과 연결을 사용하면 다음을 수행할 수 있습니다.
최소한의 필수 설정으로 연결하고 각 명령에
--projectId및--orgId플래그를 지정합니다. 처음 로그인하는 경우 가장 빠르게 시작할 수 있는 방법입니다.프로필에 추가 연결 설정을 저장합니다. 프로필은 프로젝트 ID, 조직 ID 및 선택적으로 향후 Atlas CLI 세션에서 사용할 API 키를 저장합니다. 시간을 절약하기 위해 각 명령에
--projectId및--orgId플래그를 사용하는 대신 프로필을 지정할 수 있습니다.
최소 필수 설정으로 연결
사용 사례를 선택하고 단계에 따라 최소 필수 설정으로 Atlas CLI에서 연결합니다.
사전 요구 사항을 완료하세요.
호스트의 IP 주소를 IP 액세스 목록에추가합니다.
Atlas user 자격 증명으로 인증하고 조직의 소유자가 조직의 UI에IP 대한 액세스 Atlas 목록을 IP IP 활성화한 경우, 이 조직에서 명령을 실행하려면 주소를 액세스 목록에 추가해야 합니다. 자세한 내용 은 Atlas UI에 IP 액세스 목록 필요를 참조하세요.
다음 단계를 따르세요.
사용 사례를 선택하고 절차에 따라 Atlas CLI에서 빠르게 연결합니다.
Atlas CLI로 돌아가서 기본 프로필 옵션을 수락합니다.
터미널로 돌아갑니다. 연결에 성공하면 메시지가 표시됩니다.
Successfully logged in as {Your Email Address}.
다음 옵션이 표시되면 Enter 눌러 기본 프로필 구성을 수락합니다.
Default Org IDDefault Project IDDefault Output FormatDefault MongoDB Shell Path
중요
이전에 MongoCLI용 API 키로 프로필을 설정한 적이 있다면 프로필이 자동으로 마이그레이션됩니다. 마이그레이션된 일부 프로필로 인해 atlas auth login으로 인증할 때 Atlas CLI 명령이 실패할 수 있습니다. 충돌이 있는 경우 atlas auth login을 실행하면 다음 메시지가 표시됩니다.
There was an error fetching your organizations: Global user is from outside whitelisted subnets.
충돌을 해결하려면 구성 파일을 열고 기본 프로필을 제거한 다음 atlas auth login를 다시 실행하십시오.
및 플래그를 사용하여 명령을 --projectId --orgId 실행합니다.
Atlas CLI 세션 중에 Atlas CLI 명령을 실행하는 경우 --projectId 및 --orgId 플래그를 사용하여 프로젝트 ID와 조직 ID를 지정합니다.
예시
atlas alerts list --projectId 60b3c81153cf986293e2608b
및 플래그를 사용하여 명령을 --projectId --orgId 실행합니다.
Atlas CLI 세션 중에 Atlas CLI 명령을 실행하는 경우 --projectId 및 --orgId 플래그를 사용하여 프로젝트 ID와 조직 ID를 지정합니다.
예시
atlas alerts list --projectId 60b3c81153cf986293e2608b
다음 단계로 넘어갑니다.
Atlas CLI 명령 사용을 시작하세요.
기본 프로필을 수정하여 연결 설정을 저장하거나 다른 프로필을 만들려면 연결 설정 저장을 참조하세요.