Vercel과 통합
Vercel 을(를) 사용하여 배포하는 애플리케이션에 Atlas 클러스터를 연결할 수 있습니다. .
이 페이지를 사용하여 다음 작업을 완료하세요:
Vercel 사용자와 팀을 Atlas의 조직에 연결하세요.
이러한 사용자와 팀을 위해 Vercel 프로젝트에서 Atlas cluster로 연결되는 링크를 생성하세요.
Vercel에 배포한 서버리스 함수를 Atlas 클러스터에 연결하려면 MongoDB Node.js 드라이버 또는 Mongoose ODM 라이브러리를 사용할 수도 있습니다.
고려 사항
Vercel 계정(개인 또는 팀)
Vercel 과의 통합 를 사용하려면 다음이 필요합니다.
새 개인 계정 만들기 또는 새 팀 만들기 Vercel에서.
Vercel에서 기존 개인 또는 팀 계정을 사용하세요.
참고
개인 계정 사용자로 Vercel 통합을 추가한 다음 팀 사용자로 Vercel 통합을 추가할 수 있습니다. Vercel에서는 기존 통합의 범위를 개인 계정에서 팀 수준 계정으로 변경할 수 없습니다.
개인 Vercel 계정용 MongoDB 통합에서 동일한 Atlas 조직의 팀 범위와의 통합으로 전환하려면 Atlas에서 기존 통합을 연결 해제하고 팀 범위와의 새 통합을 추가합니다.
Vercel의 프로젝트
하나의 Atlas cluster를 Vercel 에서 둘 이상의 프로젝트에 연결할 수 있습니다. .
통합을 구성하려면 개인 또는 팀 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에서 조직, 프로젝트 및 사용자 역할로 새 계정을 만든 다음 새 클러스터를 만들거나 기존 Atlas 계정, 조직, 프로젝트 및 Atlas 클러스터를 사용하여 Vercel 과 통합할 수 있습니다. .
Vercel 애플리케이션을 Atlas 클러스터와 통합하려면 Vercel 에서 시작합니다. UI.
MongoDB Atlas 통합으로 이동합니다.
Vercel에서 MongoDB Atlas 통합으로 이동 을 클릭하고 를 Add integration 클릭합니다.
통합 범위(사용자 또는 팀)를 선택합니다.
드롭다운 메뉴에서 Vercel 범위 중 하나를 선택합니다.
Personal Account
Team
통합 범위를 설정한 후에는 변경할 수 없습니다. 선택한 범위와 다른 범위로 전환하려면 이 절차에 따라 통합 하나를 연결 해제하고 다른 통합을 생성합니다.
Continue를 클릭합니다.
Atlas cluster에 연결할 Vercel 프로젝트를 선택하세요.
특정 프로젝트 또는 모든 프로젝트를 선택할 수 있습니다.추후 통합을 편집하여 프로젝트를 변경할 수 있습니다.프로젝트 목록은 이전 단계에서 지정한 사용자 또는 팀 범위에 따라 다릅니다.
다음 옵션 중 하나를 선택합니다.
All Projects
Specific Projects
아직 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 프로젝트 하나 이상과 연결하세요.
Return to Vercel을(를) 클릭하고 통합 세부정보를 검토합니다.
Atlas는 통합에 관한 세부 정보가 포함된 확인 이메일을 전송합니다. 통합 창이 닫히고 나면 이 통합에서 Vercel 프로젝트를 업데이트할 수 있는 Vercel UI로 돌아갑니다.
Atlas UI에서 Vercel 통합 관리하기
Vercel 과의 통합을 관리하려면 Integrations Atlas에서 조직 의 페이지를 사용하세요.
탐색 표시줄의 Organizations 메뉴에서 조직을 선택합니다.
사이드바에서 Integrations을 클릭한 다음 Vercel을 선택합니다.
여기에서 이러한 작업을 수행할 수 있습니다:
추가 Atlas cluster 연결
조직의 추가 클러스터를 Vercel 의 프로젝트에 연결하려면 Link clusters Integrations Vercel의 경우 Atlas 페이지의 버튼을 사용하세요.
참고
이미 구성된 통합에 대해 이 절차를 사용합니다. 초기 통합을 구성하려면 Vercel 통합 추가를 참조하세요.
조직으로 이동합니다.
탐색 표시줄의 Organizations 메뉴에서 조직을 선택하세요.
Vercel 통합으로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
Vercel0}을 선택합니다.
다른 Atlas cluster를 하나 이상의 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 cluster가 표시됩니다.
조직의 다른 Atlas 프로젝트의 클러스터를 Vercel에 연결하려면 해당 프로젝트에 대해 이 절차를 반복합니다.
Atlas cluster에 대한 연결 편집 또는 제거하기
Atlas cluster에 연결한 Vercel 프로젝트를 추가하거나 제거할 수 있습니다.
Vercel 통합으로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
Vercel0}을 선택합니다.
일부 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 연결을 해제해야 합니다.
Save 를 클릭합니다.
Vercel 통합 연결 해제
Vercel 연결을 해제하기 전에 동일한 Atlas cluster에 연결된 모든 애플리케이션의 다운타임을 방지하려면 클러스터의 사용자 및 네트워크 액세스 규칙이 이 Atlas cluster에 연결된 다른 프로젝트 및 애플리케이션을 공유하지 않는지 확인하세요.
Atlas UI에서 Vercel 통합으로 이동합니다.
사이드바에서 Integrations를 클릭합니다.
Vercel0}을 선택합니다.
Disconnect Vercel 를 클릭합니다.
이 단계에서 Atlas가 다음과 같은 선택적 작업을 대신 수행하도록 요청하려면 아이콘을 클릭하세요.
Delete the database users created as part of this integration
Delete the network access rules created as part of this integration
해당 Vercel 통합의 연결을 끊을 것인지 확인합니다.
Atlas는 Vercel에서 Atlas 조직의 연결을 해제한다는 사실을 확인하도록 요청합니다.
통합 연결을 해제하면 Vercel 애플리케이션과 Vercel에 연결된 Atlas cluster에 연결하는 다른 애플리케이션의 가동 중지 시간이 발생할 수 있습니다.
확인하려면 대문자로 'Disconnect Vercel'을 입력한 다음 Disconnect Vercel을 클릭합니다.
Atlas는 프로젝트를 Atlas cluster에 연결할 때 생성한 Vercel 프로젝트의 환경 변수를 제거하여 통합을 제거합니다.
또한 Vercel은 통합을 제거하고 Vercel UI에 더 이상 표시하지 않습니다.
Vercel 통합의 연결을 끊은 후에도 사용자, 액세스 목록 또는 Atlas Data API 키를 삭제하지 않은 경우 다음을 수행할 수 있습니다.
참고
Vercel UI에서 통합을 제거하면 Atlas는 통합도 제거하므로 Atlas UI에서 통합 연결을 해제 필요가 없습니다.