클러스터에 연결
고려 사항
Atlas는 토폴로지 변경 시 노드 유형과 관련하여 호스트 이름이 일관되게 유지된다는 것을 보장하지 않습니다.
예시
분석 노드 foo123-shard-00-03-a1b2c.mongodb.net:27017을 포함하는 foo123이라는 이름의 클러스터가 있는 경우 클러스터를 확장하여 노드 또는 리전 수를 수정하는 등 토폴로지를 변경한 후에도 특정 호스트 이름이 계속해서 분석 노드를 참조하도록 Atlas가 보장하지는 않습니다.
비공개 엔드포인트를 통한 샤딩된 클러스터에 대한 연결 성능 향상
Atlas는 비공개 엔드포인트 서비스의 로드 밸런서를 사용하여 샤딩된 클러스터에 대해 최적화된 SRV 연결 문자열을 생성할 수 있습니다. 최적화된 연결 문자열을 사용하는 경우 Atlas는 애플리케이션과 샤딩된 클러스터 간의 mongos당 연결 수를 제한합니다. mongos당 제한된 연결은 연결 수가 급증하는 동안 성능을 향상시킵니다.
참고
Atlas는 Google Cloud 또는 Azure에서 실행되는 클러스터에 대해 최적화된 연결 문자열을 지원하지 않습니다.
최적화된 연결 문자열을 사용하려면 다음 기준을 모두 충족해야 합니다.
샤딩된 클러스터가 AWS에서 실행되는지 확인합니다.
샤딩된 클러스터가 MongoDB 버전 5.0 이상을 실행하는지 확인합니다. 현재 클러스터에서 이전 버전의 MongoDB를 실행 중인 경우, 최적화된 SRV 연결 문자열을 사용하려면 클러스터의 MongoDB 버전을 버전 5.0 이상으로 업그레이드하세요.
cluster용 비공개 엔드포인트를 설정합니다 .
다음 중 하나를 사용합니다.
단일 리전 클러스터 또는
리전화된 프라이빗 엔드포인트가 허용된 멀티 리전 클러스터. 멀티 리전 클러스터의 AWS 리전만 최적화된 SRV 연결 문자열을 지원합니다.
Atlas는 단일 SRV 기록을 통한 멀티 리전 클러스터로의 최적화된 연결을 지원하지 않습니다.
다음 방법 중 하나를 사용하여 연결합니다.
최적으로 연결하는 데 최소 드라이버 버전을충족하거나 초과하는 드라이버를 사용하여 연결합니다.
참고
클러스터가 최적화된 SRV 문자열에 대한 기준을 충족하는 경우, Atlas는 Optimized SRV Connection 문자열을 생성합니다. 클러스터에 레거시 연결 문자열이 있는 경우, Atlas는 해당 문자열을 무기한 유지하며 사용자가 Private Endpoint 연결 유형을 선택할 때 Legacy SRV Connection 문자열을 포함합니다. 최적의 성능을 위해 Optimized SRV Connection으로 전환하는 것을 권장하며, 연결 문자열을 사용할 때마다 업데이트하세요.
Atlas에서 이 기능을 릴리스한 후 클러스터를 만들고 비공개 엔드포인트를 활성화하는 경우, Private Endpoint 연결 유형을 선택할 때 기본적으로 최적화된 연결 문자열이 Atlas에 표시됩니다. 다음 예시와 같이 연결 문자열에 lb를 추가하면 최적화된 연결 문자열을 식별할 수 있습니다.
mongodb+SRV://User1:P@ssword@cluster0-pl-0-lb.oq123.mongodb-dev.net/
Legacy SRV Connection 옵션이 없는 클러스터에 대해 최적화된 연결 문자열을 사용하지 않으려면 지원팀에 문의하세요.
드라이버와 함께 최적화된 연결 문자열 사용
드라이버 및 최적화된 연결 문자열을 사용하여 연결하는 방법을 알아보려면 애플리케이션 연결 절차에서 Private Endpoint Connection 탭을 선택합니다.
Compass와 함께 최적화된 연결 문자열 사용
Compass와 최적화된 연결 문자열을 사용해 연결하는 방법을 알아보려면 클러스터에 연결 절차에서 Private Endpoint Connection 탭을 선택합니다.
다음에 최적화된 연결 문자열 사용 mongosh
mongosh 및 최적화된 연결 문자열을 활용하여 연결하는 방법을 학습하려면 클러스터베이스 연결 절차에서 Private Endpoint Connection 탭을 선택합니다.
전제 조건
IP 액세스 목록
클러스터에 액세스하려면 Atlas 프로젝트의 IP 액세스 목록에 있는 IP 주소에서 연결해야 합니다. IP 액세스 목록에 IP 주소를 추가해야 하는 경우 Connect 대화 상자에서 추가할 수 있습니다. 네트워크 액세스 탭에서 IP 주소를 추가할 수도 있습니다.
데이터베이스 사용자
클러스터에 액세스하려면 Atlas 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 데이터베이스 사용자 를 만들어야 합니다. 데이터베이스 사용자는 Atlas 사용자와는 별개입니다. 데이터베이스 사용자는 MongoDB 데이터베이스에 대한 액세스 권한이 있는 반면 Atlas 사용자는 Atlas 애플리케이션 자체에 대한 액세스 권한이 있습니다.
Connect 대화 상자에서 Atlas 클러스터에 액세스할 데이터베이스 사용자를 생성할 수 있습니다. 클러스터 보기에서 데이터베이스 사용자를 추가할 수도 있습니다.
Atlas 데이터베이스에 액세스하려면 27015~27017 포트를 엽니다.
애플리케이션이 MongoDB Atlas 환경에 연결할 수 있는지 확인하세요. 애플리케이션 환경에서 Atlas로의 인바운드 네트워크 액세스를 추가하려면 다음 중 하나를 수행하세요.
IP 액세스 목록에 공인 IP 주소 추가하기
VPC/VNet 피어링을 사용하여 비공개 IP 주소를 추가합니다.
비공개 엔드포인트를 추가합니다.
방화벽이 아웃바운드 네트워크 연결을 차단하는 경우, 애플리케이션 환경에서 MongoDB Atlas로의 아웃바운드 액세스 권한을 허용해야 합니다. 애플리케이션이 Atlas 호스트의 TCP 트래픽에 대해 포트 27015부터 27017까지 아웃바운드 연결을 할 수 있도록 방화벽을 구성해야 합니다. 이렇게 하면 애플리케이션이 Atlas에 저장된 데이터베이스에 액세스할 수 있습니다.
참고
기본적으로 MongoDB Atlas 클러스터는 귀하의 애플리케이션 환경에 대한 연결을 시작할 필요가 없습니다. LDAP 인증 및 권한 부여를 통해 Atlas 클러스터를 활성화하고자 한다면 Atlas 클러스터가 귀하의 보안 LDAP로 직접 네트워크 액세스를 허용해야 합니다. 공개 또는 비공개 IP를 사용하여 귀하의 LDAP에 대한 액세스를 허용할 수 있으며, 이때 퍼블릭 DNS 호스트명이 Atlas 클러스터가 접근할 수 있는 IP를 가르키고 있어야 합니다.
VPC/VNet 피어링을 사용하지 않고 공용 IP 주소를 사용하여 Atlas에 연결하려는 경우, 다음 페이지에서 추가 정보를 확인하세요.
클라우드 클러스터에 연결
클러스터에 연결하려면 배포서버의 연결 문자열을 가져와야 합니다. 연결 문자열이 있으면 다음 연결 방법을 사용하여 배포에 연결할 수 있습니다.
참고
mongodump 또는 mongorestore를 사용하여 연결하려면 명령줄 도구 탭을 사용하세요. 이 탭은 선호하는 도구를 사용하여 Atlas 클러스터에 연결하기 위한 자동 생성 템플릿을 생성합니다.
배포의 연결 문자열을 가져오려면 Atlas CLI 또는 Atlas UI를 사용하면 됩니다.
Atlas CLI를 사용하여 배포의 표준 연결 문자열을 가져올 수 있습니다.
Atlas CLI를 사용하여 Atlas 클러스터의 SRV 연결 문자열을 반환하려면 다음 명령을 실행합니다.
atlas clusters connectionStrings describe <clusterName> [options]
명령 구문과 매개 변수에 관한 자세한 내용은 Atlas CLI 설명서의 Atlas 클러스터 connectionStrings 설명을 참조하세요.
예를 들어, Atlas CLI가 다음과 같은 연결 문자열을 반환하는 경우입니다.
mongodb+srv://mycluster.abcd1.mongodb.net
mongosh 명령에 연결 문자열을 포함하는 방식으로 mongosh를 사용해 배포서버에 연결할 수 있습니다.
mongosh "mongodb+srv://mycluster.abcd1.mongodb.net/myFirstDatabase" --apiVersion 1 --username <username>
참고
Atlas에 성공적으로 연결하려면 연결 문자열에 사용자 이름과 데이터베이스 이름을 추가해야 합니다. 터미널에서 mongosh를 사용하는 경우와 같이 Atlas에서 데이터베이스 사용자의 비밀번호를 입력하라는 메시지가 표시되는 경우도 있습니다.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
클러스터에 대한 연결을 제한하는 방법을 선택합니다.
Add a Connection IP Address
중요
Setup connection security 단계에서 클러스터에 이미 IP 액세스 목록 항목을 구성했다고 Atlas가 표시하는 경우 이 단계를 건너뜁니다. IP 액세스 목록을 관리하려면 액세스 목록에 항목 추가를 참조하십시오.
Atlas는 프로젝트의 IP 액세스 목록 항목에서 클러스터에 대한 표준 클라이언트 연결을 허용합니다. 프로젝트 IP 액세스 목록은 특정 IP 또는 CIDR 주소로 API 액세스를 제한하는 API 액세스 목록과 다릅니다.
IP 액세스 목록이 비어 있으면 Atlas는 프로젝트의 IP 액세스 목록에 IP 주소를 추가하라는 메시지를 표시합니다. 둘 중 하나를 수행하면 됩니다.
현재 IP 주소에서 액세스를 허용하려면 Add Your Current IP Address을 클릭합니다.
Add an IP Address을 클릭하여 단일 IP 주소 또는 CIDR로 표기된 주소 범위를 추가합니다.
새로 추가된 IP 주소 또는 CIDR 범위에 대한 선택적 설명을 제공합니다. Add IP Address를 클릭하여 IP 액세스 목록에 주소를 추가합니다.
Add a Connection IP Address
중요
Setup connection security 단계에서 클러스터에 이미 IP 액세스 목록 항목을 구성했다고 Atlas가 표시하는 경우 이 단계를 건너뜁니다. IP 액세스 목록을 관리하려면 IP 액세스 목록에 항목 추가를 참조하세요.
Atlas는 프로젝트의 IP 액세스 목록 항목에서 클러스터에 대한 표준 클라이언트 연결을 허용합니다. 프로젝트 IP 액세스 목록은 특정 IP 또는 CIDR 주소로 API 액세스를 제한하는 API 액세스 목록과 다릅니다.
IP 액세스 목록이 비어 있으면 Atlas는 프로젝트의 IP 액세스 목록에 IP 주소를 추가하라는 메시지를 표시합니다. Add a Different IP Address을 클릭하여 단일 IP 주소 또는 CIDR로 표기된 주소 범위를 추가합니다.
새로 추가된 IP 주소 또는 CIDR 범위에 대한 선택적 설명을 제공합니다. Add IP Address를 클릭하여 IP 액세스 목록에 주소를 추가합니다.
Choose Connection Type에서 Private Endpoint을 선택합니다.
Private Link Type 옵션이 표시되면 다음 옵션 중 하나를 선택합니다.
Optimized SRV Connection 로드 밸런싱된 연결의 경우.
Legacy SRV Connection 로드 밸런싱되지 않은 연결의 경우.
자세한 내용은 비공개 엔드포인트를 통한 샤딩된 클러스터에 대한 연결 성능 향상을 참조하세요.
Choose Private Endpoint 아래에서 사용할 엔드포인트를 선택합니다.
데이터베이스 사용자를 생성합니다.
중요
Setup connection security 단계에서 프로젝트에 데이터베이스 사용자가 하나 이상 구성되어 있다고 Atlas에서 표시하는 경우 이 단계를 건너뛰세요. 기존 데이터베이스 사용자를 관리하려면 데이터베이스 사용자 구성을 참조하세요.
클러스터에 액세스하려면 프로젝트에 있는 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 MongoDB 사용자가 필요합니다. 프로젝트에 MongoDB 사용자가 없는 경우 Atlas에서는 Atlas Admin 역할이 있는 새로운 사용자를 생성하라는 메시지가 표시됩니다.
새로운 사용자의 Username을(를) 입력합니다.
이 새 사용자에 대한 Password를 입력하거나 Autogenerate Secure Password를 클릭합니다.
사용자를 저장하려면 Create Database User 을(를) 클릭합니다.
다음 단계에서 이 사용자를 통해 클러스터에 연결합니다.
IP 액세스 목록에 IP 주소를 추가하고 데이터베이스 사용자를 추가한 경우 Choose Your Connection Method 을(를) 클릭합니다.
Atlas CLI로 로컬 배포에 연결하기
Atlas CLI를 사용하여 Atlas 배포를 시작하려면 다음 명령을 실행하세요.
atlas deployments connect [deploymentName] [options]
명령 구문과 매개 변수에 관한 자세한 설명은 Atlas 배포서버 연결에 관한 Atlas CLI 설명서를 참조하세요.
문제 해결
클러스터에 연결하는 데 문제가 있는 경우 연결 문제 해결을 참조하세요.