Vercel과 통합
Atlas App Services Data API는 더 이상 지원되지 않습니다. 수명이 다하여 2025년 9월 30일에 제거됩니다. 자세한 내용은 App Services 설명서의 사용 중단 페이지를 참조하세요.
Vercel을 사용하여 배포하는 애플리케이션에 Atlas 클러스터를 연결할 수 있습니다.
이 페이지를 사용하여 다음 작업을 완료하세요:
Vercel 사용자와 팀을 Atlas의 조직에 연결하세요.
이러한 사용자와 팀을 위해 Vercel 프로젝트에서 Atlas cluster로 연결되는 링크를 생성하세요.
Atlas Data API를 활성화합니다.
Vercel에 배포한 서버리스 기능을 Atlas 클러스터에 연결하려면 MongoDB Node.js 드라이버 또는 Mongoose ODM 라이브러리를 사용할 수도 있습니다.
고려 사항
Vercel 계정(개인 또는 팀)
Vercel과 통합하려면 다음이 필요합니다.
Vercel에서 새 개인 계정 생성하거나 새 팀을 생성합니다.
Vercel에서 기존 개인 또는 팀 계정을 사용하세요.
참고
개인 계정 사용자로 Vercel 통합을 추가한 다음 팀 사용자로 Vercel 통합을 추가할 수 있습니다. Vercel에서는 기존 통합의 범위를 개인 계정에서 팀 수준 계정으로 변경할 수 없습니다.
개인 Vercel 계정용 MongoDB 통합에서 동일한 Atlas 조직의 팀 범위와의 통합으로 전환하려면 Atlas에서 기존 통합을 연결 해제하고 팀 범위와의 새 통합을 추가합니다.
Vercel의 프로젝트
Vercel 에서 하나의 Atlas 클러스터를 둘 이상의 프로젝트에 연결할 수 있습니다.
통합을 구성하려면 개인 또는 팀 Vercel 계정에 프로젝트가 하나 이상 있어야 합니다.
통합을 위해 선택할 수 있는 Vercel 프로젝트 목록은 사용자 또는 팀 범위에 따라 다릅니다.
Atlas의 IP 액세스 목록 및 Vercel의 IP 허용 목록
Atlas 클러스터에 연결하려면 Atlas 클러스터의 IP 액세스 목록에서 모든 IP 주소(0.0.0.0/0)를 허용해야 합니다. Atlas 프로젝트의 IP 액세스 목록에서 0.0.0.0/0에 대한 항목을 찾지 못하면 Atlas가 통합 워크플로의 일부로 사용자를 대신하여 해당 항목을 추가합니다.
통합을 설정할 때 Atlas는 다음 작업을 수행하여 클러스터에 대한 Vercel 연결을 보호합니다.
이 클러스터를 연결하는 모든 Vercel 프로젝트에 대해 Atlas 클러스터의 연결 문자열 역할을 하는
MONGODB_URI환경 변수를 생성합니다.애플리케이션이 데이터베이스를 지정하지 않으면
MONGODB_URI변수는/myFirstDatabase를 기본 데이터베이스 이름으로 사용합니다. 이 이름을 데이터베이스 이름으로 바꾸거나 라이브러리를 사용하여 MongoDB와 인터페이스하는 경우, 애플리케이션 코드가 데이터베이스 이름을 지정하는지 확인하세요.관리 데이터베이스에 데이터베이스 사용자
vercel-admin-user를 만들고 클러스터의 다른 모든 비시스템 데이터베이스에 기본 제공 readWriteAnyDatabase MongoDB 데이터베이스 역할을 부여합니다.
Vercel 통합 추가
이 절차를 통해 Atlas에서 조직, 프로젝트, 사용자 역할로 새 계정을 만든 다음 새 클러스터를 만들거나 Vercel과의 통합을 위해 기존 Atlas 계정, 조직, 프로젝트, Atlas 클러스터를 사용할 수 있습니다.
Vercel 애플리케이션을 Atlas 클러스터와 통합하려면 Vercel UI에서 시작하면 됩니다.
MongoDB Atlas 통합으로 이동합니다.
Vercel의 MongoDB Atlas Integration으로 이동하여 Add integration을 클릭합니다.
통합 범위(사용자 또는 팀)를 선택합니다.
드롭다운 메뉴에서 Vercel 범위 중 하나를 선택합니다.
Personal Account
Team
통합 범위를 설정한 후에는 변경할 수 없습니다. 선택한 범위와 다른 범위로 전환하려면 이 절차에 따라 통합 하나를 연결 해제하고 다른 통합을 생성합니다.
Continue를 클릭합니다.
아직 MongoDB 계정이 없는 경우 계정을 생성합니다.
다음 옵션 중 하나를 선택합니다.
Google 계정을 사용 중인 경우 로그인 단계를 따르거나 새 Google 계정을 만듭니다.
이메일을 사용 중이라면 이미 입력이 완료되어 회색으로 표시됩니다.
회사에서 연합 인증을 사용하는 경우 회사의 이메일 주소를 사용합니다. 연합 사용자 액세스에 필요한 확인 단계를 진행하세요.
이미 Atlas 계정이 있는 경우 Log in now을(를) 클릭합니다. Atlas 계정에 로그인을 참조하세요.
이름과 성을 입력하고 비밀번호를 선택합니다. 비밀번호는 8자 이상이어야 하며 고유한 문자, 숫자 또는 기호를 포함해야 합니다. 이메일 주소는 포함하지 않습니다. 새 Atlas 계정 등록을 참조하세요.
I accept the Privacy Policy and the Terms of Service 확인란을 클릭합니다.
Vercel과 통합할 Atlas 조직을 선택합니다.
드롭다운에서 Atlas 조직을 선택하거나 새 Atlas 조직을 생성합니다.
Continue를 클릭합니다.
Atlas 조직에 대한 액세스를 확인합니다.
Atlas는 사용자를 위해 조직을 생성합니다. I Acknowledge를 클릭하여 Atlas 조직에 대한 액세스 권한을 Vercel에 부여하는 것을 확인합니다.
이 Vercel 연동 서비스에서 MongoDB Atlas 조직에 대한 액세스 권한을 제거하려면 이 연동 서비스의 연결을 해제해야 합니다.
드롭다운에서 Vercel과 통합할 Atlas 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
(선택 사항) Enable the Atlas Data API 스위치를 토글합니다. Atlas Data API를 활성화하면 HTTPS를 사용하여 이 조직의 Atlas 데이터베이스에 연결할 수 있습니다.
새로운 프리 티어 클러스터를 만들거나 기존 클러스터를 Vercel 프로젝트 하나 이상과 연결하세요.
이미 Atlas 계정이 있는 경우 기존 조직 및 프로젝트와 기존 클러스터를 차례로 선택할 수 있습니다.
Atlas Project Owner 역할이 있는지 확인하십시오.
매핑 왼쪽에 있는 드롭다운에서 Atlas 클러스터를 선택합니다.
오른쪽 드롭다운에서 하나 이상의 Vercel 프로젝트를 선택합니다. 하나의 Atlas 클러스터를 하나 이상의 Vercel 프로젝트에 매핑할 수 있습니다. 드롭다운 메뉴에는 이 절차의 앞부분에서 이 통합을 위해 선택한 항목에 따라 하나의 프로젝트 또는 모든 프로젝트가 표시됩니다. 나중에 이 통합을 통해 더 많은 Vercel 프로젝트를 동일한 Atlas 클러스터에 연결할 수 있습니다.
선택한 프로젝트에서 Atlas 액세스 목록에 0.0.0.0./0 엔트리가 없는 경우, Atlas는 Vercel에서 동적 IP 주소로 인해 전체 액세스 권한이 있는 Atlas 클러스터를 생성한다는 사실을 확인하도록 요청합니다. Atlas에서 이 정보를 포함하여 이메일을 전송합니다.
Atlas 클러스터가 없으면 새 클러스터를 생성하세요. 나중에 생성한 클러스터를 수정할 수 있습니다.
Atlas
Project Owner역할이 있는지 확인하십시오.Atlas는 새 무료 계층 클러스터를 생성하고 이를 선택한 Vercel 프로젝트에 연결합니다. 나중에 동일한 Atlas 클러스터에 더 많은 Vercel 프로젝트를 연결할 수 있습니다.
을(를) 클릭하여 이러한 진술을 승인합니다.
Atlas UI에서 Vercel 통합 관리하기
Vercel과의 통합을 관리하려면 다음을 수행하세요.
Atlas에서 Organization Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.
1} 메뉴 옆에 있는 아이콘을 클릭합니다.Organization Settings Organizations
조직 설정 페이지가 표시됩니다.
Organization Integrations 페이지로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
조직 통합 페이지가 표시됩니다.
추가 Atlas 클러스터 연결
조직의 추가 클러스터를 Vercel의 프로젝트에 연결하려면:
참고
이미 구성된 통합에 대해 이 절차를 사용합니다. 초기 통합을 구성하려면 Vercel 통합 추가를 참조하세요.
Atlas에서 Organization Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.
1} 메뉴 옆에 있는 아이콘을 클릭합니다.Organization Settings Organizations
조직 설정 페이지가 표시됩니다.
Organization Integrations 페이지로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
조직 통합 페이지가 표시됩니다.
다른 Atlas 클러스터를 하나 이상의 Vercel 프로젝트에 연결합니다.
Link Clusters를 클릭합니다.
Add Another Cluster Link with Vercel 창이 열리고 Atlas 조직이 표시됩니다.
Atlas 프로젝트를 선택합니다.
왼쪽 드롭다운 목록에서 Vercel에 연결되지 않은 클러스터를 선택합니다. 프로젝트에 다른 Atlas 클러스터가 없는 경우 새로 생성할 수 있습니다.
오른쪽 드롭다운 목록에서 하나 이상의 Vercel 프로젝트를 선택합니다.
(선택 사항) Enable the Atlas Data API 스위치를 토글합니다. Atlas Data API를 활성화하면 HTTPS를 사용하여 이 조직의 Atlas 데이터베이스에 연결할 수 있습니다.
Save를 클릭합니다.
Atlas에서 통합에 대한 세부 정보를 담은 확인 이메일을 받게 됩니다.
연결된 클러스터 목록에 새롭게 연결된 Atlas 클러스터가 표시됩니다.
조직의 다른 Atlas 프로젝트의 클러스터를 Vercel에 연결하려면 해당 프로젝트에 대해 이 절차를 반복합니다.
Atlas 클러스터에 대한 연결 편집 또는 제거하기
Atlas 클러스터에 연결한 Vercel 프로젝트를 추가하거나 제거할 수 있습니다.
Atlas에서 Organization Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.
1} 메뉴 옆에 있는 아이콘을 클릭합니다.Organization Settings Organizations
조직 설정 페이지가 표시됩니다.
Organization Integrations 페이지로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
조직 통합 페이지가 표시됩니다.
일부 Vercel 프로젝트를 추가하거나 제거하려면 연결된 Atlas 프로젝트 옆의 Edit을 클릭합니다.
Atlas는 기존에 연결된 Vercel 프로젝트를 표시합니다.
오른쪽 목록에서 기존 링크를 편집하고 드롭다운에서 프로젝트를 선택합니다. 다음을 수행할 수 있습니다.
목록에서 Vercel 프로젝트 옆을 클릭하여 이 클러스터의 통합에 추가합니다.
이 통합에서 일부 Vercel 프로젝트를 제거하려면 을(를) 클릭합니다.
(선택 사항) Enable the Atlas Data API 스위치를 토글합니다. Atlas Data API를 활성화하면 HTTPS를 사용하여 이 조직의 Atlas 데이터베이스에 연결할 수 있습니다.
모든 Vercel 프로젝트에 대한 링크를 제거하려면 연결된 Atlas 프로젝트 옆의 Unlink를 클릭합니다.
Atlas는 프로젝트에서 클러스터 연결을 해제한다는 사실을 확인하도록 요청합니다. 확인하려면 Unlink를 클릭합니다. Atlas는 프로젝트를 Atlas 클러스터에 연결할 때 생성한 Vercel 프로젝트의 환경 변수를 제거합니다.
모든 프로젝트의 연결을 해제하면 Atlas는 다음과 같이 작동합니다.
이 통합을 위해 생성한 데이터, 데이터베이스 사용자, 또는 IP 액세스 목록은 제거하지 않습니다.
Atlas UI에 통합에 연결된 클러스터가 없다고 표시되더라도 클러스터 또는 통합을 삭제하지는 않습니다. 통합을 비활성화하려면 Vercel과의 연결을 해제해야 합니다.
Vercel 통합 연결 해제
동일한 Atlas 클러스터에 연결된 모든 애플리케이션의 다운타임을 방지하려면 Vercel 프로젝트를 Atlas 클러스터에서 연결 해제하기 전에 클러스터의 사용자 및 네트워크 액세스 규칙이 이 Atlas 클러스터에 연결된 다른 프로젝트 및 애플리케이션을 공유하지 않는지 확인하세요.
Atlas에서 Organization Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.
1} 메뉴 옆에 있는 아이콘을 클릭합니다.Organization Settings Organizations
조직 설정 페이지가 표시됩니다.
Organization Integrations 페이지로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
조직 통합 페이지가 표시됩니다.
해당 Vercel 통합의 연결을 끊을 것인지 확인합니다.
Atlas는 Vercel에서 Atlas 조직의 연결을 해제한다는 사실을 확인하도록 요청합니다.
통합 연결을 해제하면 Vercel 애플리케이션과 Vercel에 연결된 Atlas cluster에 연결하는 다른 애플리케이션의 가동 중지 시간이 발생할 수 있습니다.
확인하려면 대문자로 'Disconnect Vercel'을 입력한 다음 Disconnect Vercel을 클릭합니다.
Atlas는 프로젝트를 Atlas 클러스터에 연결할 때 생성한 Vercel 프로젝트의 환경 변수를 제거하여 통합을 제거합니다.
또한 Vercel은 통합을 제거하고 Vercel UI에 더 이상 표시하지 않습니다.
Vercel 연동 서비스를 끊은 후에도 사용자, 액세스 목록 또는 Atlas Data API 키를 삭제하지 않았다면 다음이 가능합니다.
참고
Vercel UI에서 통합을 제거하면 Atlas는 통합도 제거하므로 Atlas UI에서 통합 연결을 해제 필요가 없습니다.