이 페이지에서는 Atlas CLI 또는 Atlas UI 사용하여 Atlas cluster 에 연결하는 방법을 설명합니다.
전제 조건
IP 액세스 목록
클러스터 에 액세스 하려면 Atlas 프로젝트의 IP 액세스 목록 에 있는 IP 주소 에서 연결해야 합니다. IP 액세스 목록 에 Connect IP 주소 추가해야 하는 경우 대화 상자에서 추가할 수 있습니다.네트워크 액세스 탭 에서 IP 주소 추가할 수도 있습니다.
데이터베이스 사용자
클러스터에 액세스하려면 Atlas cluster에서 원하는 데이터베이스에 액세스할 수 있는 데이터베이스 사용자 를 만들어야 합니다. 데이터베이스 사용자는 Atlas 사용자와는 별개입니다. 데이터베이스 사용자는 MongoDB 데이터베이스에 액세스할 수 있는 반면, Atlas 사용자는 Atlas 애플리케이션 자체에 액세스할 수 있습니다.
Connect 대화 상자에서 Atlas 클러스터에 액세스할 데이터베이스 사용자를 생성할 수 있습니다. 클러스터 보기에서 데이터베이스 사용자를 추가할 수도 있습니다.
Atlas 데이터베이스에 액세스하려면 27015~27017 포트를 엽니다.
애플리케이션이 MongoDB Atlas 환경에 연결할 수 있는지 확인하세요. 애플리케이션 환경에서 Atlas로의 인바운드 네트워크 액세스를 추가하려면 다음 중 하나를 수행하세요.
IP 액세스 목록에 공인 IP 주소 추가하기
VPC/VNet 피어링을 사용하여 비공개 IP 주소를 추가합니다.
비공개 엔드포인트를 추가합니다.
방화벽 이 아웃바운드 네트워크 연결을 차단하는 경우 애플리케이션 환경에서 Atlas 로의 아웃바운드 액세스 도 허용해야 합니다. 애플리케이션이 클러스터의 호스트 이름 또는 IP 주소에서 포트 27015 ~ 27017 ~ TCP 트래픽에 아웃바운드 연결을 할 수 있도록 방화벽 구성해야 합니다. 이렇게 하면 애플리케이션이 Atlas 에 저장된 데이터베이스에 액세스 .
클러스터 IP 주소의 현재 목록을 얻으려면 Atlas 관리 API 의 Return All IP for One 프로젝트 엔드포인트 를 사용합니다.
curl --header "Authorization: Bearer <access-token>" \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --request GET \ "https://cloud.mongodb.com/api/atlas/v2/groups/{GROUP-ID}/ipAddresses"
참고
기본적으로 MongoDB Atlas 클러스터는 귀하의 애플리케이션 환경에 대한 연결을 시작할 필요가 없습니다. LDAP 인증 및 권한 부여를 통해 Atlas 클러스터를 활성화하고자 한다면 Atlas 클러스터가 귀하의 보안 LDAP로 직접 네트워크 액세스를 허용해야 합니다. 공개 또는 비공개 IP를 사용하여 귀하의 LDAP에 대한 액세스를 허용할 수 있으며, 이때 퍼블릭 DNS 호스트명이 Atlas 클러스터가 접근할 수 있는 IP를 가르키고 있어야 합니다.
VPC/VNet 피어링을 사용하지 않고 공용 IP 주소를 사용하여 Atlas에 연결하려는 경우, 다음 페이지에서 추가 정보를 확인하세요.
고려 사항
Atlas는 토폴로지 변경 시 노드 유형과 관련하여 호스트 이름이 일관되게 유지된다는 것을 보장하지 않습니다.
예시
분석 노드 foo123-shard-00-03-a1b2c.mongodb.net:27017를 포함하는 foo123이라는 이름의 클러스터가 있는 경우, 클러스터를 확장하여 노드 또는 리전 수를 수정하는 등 토폴로지를 변경한 후에도 특정 호스트 이름이 계속해서 분석 노드를 참조하도록 Atlas가 보장하지는 않습니다.
클라우드 클러스터에 연결
배포의 연결 문자열을 가져오려면 Atlas CLI 또는 Atlas UI를 사용하면 됩니다.
다른 방법을 사용하여 클라우드 클러스터에 연결
클러스터 에 연결하려면 배포의 연결 문자열을 가져와야 합니다. 연결 문자열 있으면 다음 연결 방법을 사용하여 배포서버 에 연결할 수 있습니다.
참고
mongodump 또는 mongorestore 를 사용하여 연결하려면 사이드바의 명령줄 도구 옵션을 Cluster 사용합니다. 이렇게 하면 원하는 도구를 사용하여 Atlas cluster 에 연결하기 위한 자동 생성 템플릿이 생성됩니다.
문제 해결
클러스터에 연결하는 데 문제가 있는 경우 연결 문제 해결을 참조하세요.