Vercel 은 애플리케이션 배포를 간소화하는 개발 플랫폼입니다. Vercel에는 개발자가 소프트웨어 패키지를 검색하고 애플리케이션을 프로비저닝할 수 있는 마켓플레이스가 있습니다.
Vercel과 MongoDB Atlas 네이티브 통합을 통해 다음을 수행할 수 있습니다.
Vercel 대시보드 에서 직접 Atlas 리소스를 프로비저닝하고 Vercel 계정을 통해 청구를 managed .
프로비저닝된 연결 계정을 통해 Atlas 의 리소스에 액세스하세요.
신규 및 기존 Vercel 애플리케이션을 위한 MongoDB Atlas 클러스터를 배포합니다.
모든 사용 사례 에 맞는 옵션이 있는 무료, 전용 및 Flex MongoDB 클러스터 중에서 선택하세요.
MongoDB Atlas 클러스터를 생성한 후 Vercel은 Atlas cluster 자격 증명 및 기타 설정을 Vercel 환경에 추가합니다.
Vercel에서 Atlas 찾기
역할 있는 Vercel 사용자인 경우 다음 방법을 통해 Atlas 검색할 수 있습니다.
Vercel UI 에 로그인합니다.
Overview 탭 아래 오른쪽 상단 모서리에 있는 Add new 버튼을 찾아 드롭다운에서 Integration을 선택합니다.
고려 사항
Vercel 계정(개인 또는 팀)
Vercel과 통합하려면 다음이 필요합니다.
새 개인 계정을 만들 거나 Vercel에서 새 팀 만들 수 있습니다.
Vercel에서 기존 개인 또는 팀 계정을 사용하세요.
Vercel의 프로젝트
Vercel 에서 하나의 Atlas 클러스터를 둘 이상의 프로젝트에 연결할 수 있습니다.
Vercel에서 Atlas 의 네이티브 통합을 생성하는 경우, Atlas Atlas 에서 Vercel에서 관리하는 새로운 조직 및 프로젝트 생성합니다.
Atlas의 IP 액세스 목록 및 Vercel의 IP 허용 목록
Vercel 배포는 동적 IP 주소를 사용합니다.
Atlas 클러스터에 연결하려면 Atlas 클러스터의 IP 액세스 목록에서 모든 IP 주소(0.0.0.0/0)를 허용해야 합니다. Atlas 프로젝트의 IP 액세스 목록에서 0.0.0.0/0에 대한 항목을 찾지 못하면 Atlas가 통합 워크플로의 일부로 사용자를 대신하여 해당 항목을 추가합니다.
참고
프로젝트 액세스 목록에 0.0.0.0/0 CIDR을 추가하면 Atlas 프로젝트 에 직접 역할 부여하거나 팀 멤버십을 통해 역할 간접적으로 부여받은 모든 사용자( 팀 에 프로젝트 에 역할 부여된 경우)에게 경고 이메일 보냅니다. .
Atlas 관리 데이터베이스 에 형식의 데이터베이스 사용자를 생성하고 Atlas cluster 의 모든Vercel-Admin-[name of resource] 비시스템 데이터베이스에 내장 readWriteAnyDatabase MongoDB database 역할 부여합니다. 예시 들어 Vercel 리소스 의 이름이 인 my-first-atlas-cluster 경우 Atlas 생성하는 데이터베이스 사용자는 입니다.Vercel-Admin-my-first-atlas-cluster
Vercel 네이티브 통합
Vercel과 통합하려면 Vercel 마켓플레이스에서 MongoDB Atlas 찾아 Vercel을 통해 청구되는 새 MongoDB Atlas 계정을 만듭니다. Vercel에서 MongoDB Atlas 의 기본 통합을 통해 다음을 수행할 수 있습니다.
Vercel 대시보드 에서 직접 Atlas 리소스를 프로비저닝하고 Vercel 계정을 통해 청구를 관리 . 프로비저닝된 연결 계정을 통해 Atlas 의 리소스에 직접 액세스 수도 있습니다.
신규 및 기존 Vercel 애플리케이션을 위한 MongoDB Atlas 클러스터를 배포합니다.
MongoDB Atlas 클러스터를 생성한 후 Vercel은 Atlas cluster 자격 증명 및 기타 설정을 Vercel 환경에 추가합니다.
계정이 없는 경우 Atlas 계정을 프로비저닝합니다. Atlas 계정은 Vercel 설치에 연결됩니다. Atlas 에 로그인하기 위한 별도의 자격 증명 있습니다.
고려 사항: 네이티브 통합
다음 고려 사항은 Vercel에서 Atlas 의 네이티브 통합에 적용 .
리소스 매핑
Vercel의 ' 팀 설치'는 Atlas 의 조직 에 매핑됩니다. Vercel에 설치된 제품(리소스 )은 Atlas 의 프로젝트 및 클러스터 에 매핑됩니다.
API 액세스
Vercel은 사용자를 대신하여 리소스를 생성 및 관리 하고 환경 변화를 전파하기 위해 Atlas API에 프로그래밍 방식으로 액세스 해야 합니다.
사용자 프로비저닝 및 계정 연결
Atlas 자격 증명 구성하지 않은 경우 Atlas Vercel 사용자를 위해 새 Atlas user 계정을 프로비저닝하고, 기존 계정을 연결한 다음 비밀번호 재설정 이메일 보냅니다. 사용자 인증 Atlas 액세스 하려면 Atlas 자격 증명 필요합니다.
Vercel 팀 위해 Atlas Native Integration을 처음 설치하는 사용자는 Atlas
Organization Owner가 됩니다.액세스 |service| Vercel에서
Open in Atlas 버튼을 통해 Vercel에서 Atlas UI 로 이동할 수 있습니다. Atlas 자격 증명 으로 로그인하면 Atlas 해당 Atlas 리소스 로 리디렉션됩니다.
기존 Atlas 계정이 있는 사용자. Vercel에서 Atlas 에 액세스할 때, Vercel은 기존 Atlas 계정이 있는 사용자에게 Vercel 설치에 Atlas 계정을 연결할지 확인하라는 메시지를 표시합니다. 사용자가 연결을 확인하고 Atlas 자격 증명 으로 로그인 신원을 증명하면 Atlas 사용자의 Atlas 계정을 Vercel 설치에 연결합니다.
신규 사용자. Atlas 신규 사용자를 위한 계정을 프로비저닝하고 사용자가 비밀번호를 구성하고 신원을 증명할 수 있도록 비밀번호 재설정 이메일 보냅니다. Atlas 사용자의 자격 증명 얻으면 Atlas 사용자의 Atlas 계정을 Vercel 설치에 연결하고 이 사용자에게 Atlas 에서
Organization Owner역할 부여합니다. Atlas 조직의 권한을 Vercel의 권한에 따라 유지합니다. Vercel의 '관리자' 및 '사용자' 역할은 각각 Atlas 에서Organization Owner및Organization Read Only역할에 매핑됩니다.
Vercel 팀 의 사용자가 네이티브 통합을 사용하여 추가 Atlas 클러스터를 설치하는 경우, Atlas 이러한 사용자를 Vercel 팀 위해 생성된 Atlas 조직 에 자동으로 추가하지 않습니다. Atlas 조직 소유자는 Atlas 조직 에 액세스 해야 하는 모든 Vercel 팀 사용자가 이를 보유하고 있는지 확인해야 합니다. 이는 네이티브 통합을 처음 설치한 후 Vercel 팀 합류한 새로운 Vercel 팀 사용자에게도 적용됩니다.
다음 방법 중 하나를 사용하여 Atlas Atlas 조직에 Vercel 팀의 사용자를 추가하도록 합니다.
Vercel 팀 사용자는 Vercel UI 통해 Atlas UI 에서 Atlas 조직 에 액세스 할 수 있습니다. 아직 Atlas 사용자가 아닌 경우 Atlas 계정을 프로비저닝하고 네이티브 통합을 위해 Atlas 조직 에 할당합니다.
Atlas 조직 소유자는 Atlas 사용자를 Atlas 조직에 초대할 수 있습니다.
환경 변수
네이티브 통합은 보안 데이터베이스 연결을 위해
MONGODB_URI환경 변수를 자동으로 구성합니다. 환경 변수의 전체 목록은 Atlas 의 네이티브 통합을 위한 Vercel UI 참조하세요.청구
Vercel Native Integration은 Vercel UI 에서 새 Atlas 조직을 생성하며, 이 조직은 Atlas 조직의 활성 결제 수단인 Vercel Marketplace 요금제에 자동으로 연결됩니다. 결제는 Atlas 조직 1개당 발생하며 조직의 모든 MongoDB Atlas 클러스터 및 서비스에 대한 일괄 청구가 포함됩니다. Vercel 및 Atlas 에서는 Atlas Organization에 대한 Vercel Marketplace 청구 내역과 일일 사용 비용을 확인할 수 있습니다.
보안
Atlas Vercel의 네이티브 통합을 통해 생성한 Atlas 클러스터에 대한 IP 허용 목록을 사용하여 SCRAM 인증 통해 보안 연결을 보장합니다.
네이티브 통합의 삭제 또는 제거
Vercel 통합을 제거한 후에는 Atlas 조직 소유자가 액세스 할당 및 청구 방법을 최신 상태로 유지하고 부실하거나 원치 않는 액세스 제거하여 MongoDB 에서 연체된 청구 결제와 관련하여 자동 알림을 보내는 것을 방지할 것을 권장합니다. Atlas Atlas 에 대한 최종 Vercel 청구서를 Vercel에 제출하고 Atlas Organization에서 Vercel Marketplace 결제 방법을 제거합니다.
가장 최근 사용량에 대해 제거 후에도 아직 청구되지 않았을 수 있는 추가 요금이 있을 수 있으므로 이 청구서는 최종 Atlas 청구서가 아닙니다. 사용자는 미결제 사용량을 모두 결제할 수 있도록 조직에 새 결제 수단을 추가할 책임이 있습니다.
Atlas 에서 리소스를 언제든지 삭제 수 있지만, Atlas UI 에서 Native Integration을 제거하거나 연결을 해제할 수는 없습니다. Vercel 연결된 클러스터 삭제 하면 이는 Vercel UI 에 반영됩니다.
Next.js용 Vercel UI 시작하기
네이티브 통합을 위한 Vercel UI Next.js 및 Atlas 시작하기 위한 지침이 포함되어 있습니다.
배포 템플릿
네이티브 통합을 위한 Vercel UI 배포서버 템플릿이 포함되어 있습니다. 이러한 템플릿에는 Vercel에서 Atlas 프로젝트를 시작하는 데 도움이 되는 예시 코드와 구성 파일이 포함되어 있습니다.
네이티브 통합 추가
Vercel에 MongoDB Atlas 네이티브 통합을 추가하려면 다음을 수행합니다.
클러스터 리전 선택합니다.
Vercel 리전 목록이 표시됩니다. 이러한 리전은 대부분의 경우 MongoDB Atlas 리전에 매핑됩니다. 해당 Atlas 리전 없는 Vercel 리전 선택하면 Atlas 사용자가 선택한 Vercel 리전 에 가장 가까운 리전 선택합니다.
설치 요금제를 무료 또는 유료 중에서 선택합니다.
무료 요금제 $0
크레딧 카드는 필요하지 않습니다. 이 요금제로는 무료 MongoDB Atlas 클러스터만 생성할 수 있습니다.
유료 요금제
신용카드가 필요합니다. 이 플랜으로 무료, Flex 및 Dedicated 클러스터를 생성할 수 있습니다. Flex 및 전용 클러스터에 대해서만 요금이 청구됩니다.
Flex 또는 Dedicated Atlas cluster 선택하면 무료 플랜이 회색으로 표시됩니다. Vercel 팀 구성원 중 누군가가 이 무료 통합 플랜을 사용하고 Flex 또는 전용 클러스터 생성하기로 선택한 경우, 해당 요금제가 유료 플랜으로 변경됩니다. 무료가 아닌 MongoDB Atlas cluster 제거하더라도 요금제는 유료 요금제로 유지됩니다. 플랜을 무료 플랜으로 변경하려면 네이티브 통합을 제거한 다음 무료 클러스터 와 무료 플랜을 선택하여 다시 설치합니다. 네이티브 통합을 제거하는 방법을 학습하려면 Vercel 설명서를 참조하세요.
이제 Vercel에서 Atlas 의 네이티브 통합을 사용하여 다음을 수행할 수 있습니다.
Vercel 프로젝트 에 연결합니다.
최신 환경 변수를 가져옵니다.
이 MongoDB Atlas cluster 더 이상 필요하지 않은 경우 Native Integration을 제거하고 MongoDB Atlas 데이터베이스 삭제 수 있습니다. 자세한 내용은 Vercel 문서를 참조하세요.
전체 통합을 제거하지 않고도 데이터베이스 ( 리소스 )를 삭제 수도 있습니다. 이는 향후 다른 리소스를 생성하기 위해 통합을 유지하려는 경우 또는 동일한 통합에 다른 리소스가 있는 경우에 유용합니다.
Vercel에 연결된 Atlas cluster 삭제 하면 Vercel에서 이 클러스터 에 연결한 모든 프로젝트가 더 이상 이 데이터베이스 클러스터 에 액세스 할 수 없습니다. Atlas cluster 제거 및 삭제를 진행하기 전에 이 Atlas cluster 프로젝트나 애플리케이션 에서 더 이상 사용하고 있지 않은지 확인하세요.
지원 팀에 문의하기
MongoDB Atlas 와 Vercel 네이티브 통합을 사용하는 동안 문제가 실행 하면 MongoDB vercel-integation-support@mongodb.com으로 Vercel 통합 지원팀에 문의 .
Vercel 통합 연결 해제
동일한 Atlas 클러스터에 연결된 모든 애플리케이션의 다운타임을 방지하려면 Vercel 프로젝트를 Atlas 클러스터에서 연결 해제하기 전에 클러스터의 사용자 및 네트워크 액세스 규칙이 이 Atlas 클러스터에 연결된 다른 프로젝트 및 애플리케이션을 공유하지 않는지 확인하세요.
통합을 제거하거나 제거 을(를) 클릭합니다.
Vercel UI 프롬프트에 따라 통합을 제거합니다. 자세한 지침은 Vercel 문서를 참조하세요.
해당 Vercel 통합의 연결을 끊을 것인지 확인합니다.
통합 연결을 해제하면 Vercel 애플리케이션과 Vercel에 연결된 Atlas cluster에 연결하는 다른 애플리케이션의 가동 중지 시간이 발생할 수 있습니다.
Vercel 통합을 제거한 후에는 Atlas 에서 Organization Owner 액세스 할당 및 청구 방법을 최신 상태로 유지하고 부실하거나 원치 않는 액세스 제거하여 MongoDB 에서 연체된 청구 결제와 관련하여 자동 알림을 보내는 것을 방지하는 것이 좋습니다.
Atlas Atlas Vercel 통합에 대한 최종 Vercel 청구서를 Vercel에 제출하고, Atlas Organization에서 Vercel Marketplace 결제 방법을 제거합니다.
가장 최근 사용량에 대해 제거 후에도 아직 청구되지 않았을 수 있는 추가 요금이 조직 에서 여전히 발생할 수 있으므로 이 청구서는 최종 Atlas 청구서가 아닙니다. 사용자는 미결제 사용량을 모두 결제할 수 있도록 조직 에 새 결제 수단을 추가할 책임이 있습니다.