Vercel es una plataforma de desarrollo que simplifica las implementaciones de aplicaciones. Vercel tiene un mercado para que los desarrolladores descubran paquetes de software y aprovisionen aplicaciones.
La integración nativa de MongoDB Atlas con Vercel le permite:
Aprovisione recursos de Atlas directamente desde el panel de Vercel y administre la facturación a través de su cuenta de Vercel.
Acceda a recursos en Atlas a través de una cuenta vinculada aprovisionada.
Implementar clústeres de MongoDB Atlas para aplicaciones Vercel nuevas y existentes.
Elegir entre clústeres de MongoDB gratuitos, dedicados y Flex, con opciones para cada caso de uso.
Después de crear clústeres de MongoDB Atlas, Vercel agrega sus credenciales de clúster de Atlas y otras configuraciones a sus entornos de Vercel.
Encuentra Atlas en Vercel
Si se es usuario de Vercel con cualquier rol, se puede descubrir Atlas mediante los siguientes métodos:
Iniciar sesión en la Interfaz de Usuario de Vercel.
Bajo el Overview pestaña ubique el botón Add new en la esquina superior derecha y en el menú desplegable, seleccione Integration.
Considerations
Cuentas en Vercel (Personal o de equipo)
La integración con Vercel requiere que:
Crear una nueva cuenta personal o crear un nuevo equipo en Vercel.
Usa una cuenta personal o de equipo existente en Vercel.
Proyectos en Vercel
Se puede vincular un clúster de Atlas a más de un proyecto en Vercel
Si se crea una integración nativa de Atlas en Vercel, Atlas crea una nueva organización y un nuevo proyecto en Atlas gestionados por Vercel.
Listas de acceso IP en Atlas y listas de permisos IP en Vercel
Las implementaciones de Vercel utilizan direcciones IP dinámicas.
Para conectarse a un clúster Atlas, el La lista de acceso IP de su clúster Atlas debe permitir todas las direcciones IP (0.0.0.00/). Si Atlas no encuentra una entrada 0.0.0 para.0/0 en la lista de acceso IP de su proyecto Atlas, la agregará en su nombre, como parte del flujo de trabajo de integración.
Nota
Si se añade el CIDR 0.0.0.0/0 a la lista de acceso de un proyecto, Atlas envía un correo electrónico de alerta a todos los usuarios a los que se les haya otorgado un rol en el proyecto de forma directa o indirecta a través de la pertenencia al equipo (si al equipo se le otorga un rol en el proyecto).
Atlas crea un usuario de base de datos con el siguiente formato: Vercel-Admin-[name of resource] en la base de datos de administración y otorga el rol de base de datos MongoDB readWriteAnyDatabase integrado a todas las bases de datos no del sistema del clúster Atlas. Por ejemplo, si su recurso Vercel se my-first-atlas-cluster llama, el usuario de base de datos que Atlas crea Vercel-Admin-my-first-atlas-cluster es.
Integración nativa de Vercel
Para integrarlo con Vercel, busque MongoDB Atlas en Vercel Marketplace y cree una nueva cuenta de MongoDB Atlas con facturación a través de Vercel. Una integración nativa de MongoDB Atlas en Vercel le permite:
Aprovisione recursos de Atlas directamente desde el panel de control de Vercel y gestione la facturación a través de su cuenta de Vercel. También puede acceder directamente a los recursos de Atlas mediante una cuenta vinculada aprovisionada.
Implementar clústeres de MongoDB Atlas para aplicaciones Vercel nuevas y existentes.
Después de crear clústeres de MongoDB Atlas, Vercel agrega sus credenciales de clúster de Atlas y otras configuraciones a sus entornos de Vercel.
Atlas se encarga del provisionamineto de la cuenta si no se tiene una. La cuenta de Atlas está vinculada a la instalación de Vercel. Se dispone de credenciales separadas para iniciar sesión en Atlas.
Consideraciones: Integración nativa
Las siguientes consideraciones se aplican a la integración nativa de Atlas en Vercel.
Mapeo de recursos
Una "instalación de equipo" en Vercel se corresponde con una organización en Atlas. Un producto instalado (recurso) en Vercel se asigna a un proyecto y un clúster en Atlas.
Acceso a la API
Vercel requiere acceso programático a las API de Atlas para crear y gestionar recursos en nombre de los usuarios y propagar cambios ambientales.
Provisionamineto de usuarios y vinculación de cuentas
Atlas permite el provisionamiento de nuevas cuentas de Atlas user para usuarios de Vercel, vincula cuentas existentes y envía un correo electrónico de restablecimiento de contraseña si no se configuran las credenciales de Atlas. La autenticación de usuario requiere credenciales de Atlas para acceder a Atlas.
El usuario que instala inicialmente la integración nativa de Atlas para el equipo de Vercel se convierte en el
Organization Ownerde Atlas.Acceder al |servicio| desde Vercel
Se puede navegar a la Interfaz de Usuario de Atlas desde Vercel con el botón Open in Atlas. Después de iniciar sesión con las credenciales de Atlas, Atlas redirige al recurso correspondiente de Atlas.
Usuarios con cuentas de Atlas existentes. Al acceder a Atlas desde Vercel, Vercel pide a los usuarios con cuentas de Atlas existentes que confirmen vincular su cuenta de Atlas a su instalación de Vercel. Después de que los usuarios confirmen el enlace e inicien sesión con las credenciales de Atlas para demostrar su identidad, Atlas vincula las cuentas de Atlas de los usuarios a su instalación de Vercel.
Nuevos usuarios. Atlas realiza el provisionamiento de una cuenta para nuevos usuarios y envía un correo electrónico de restablecimiento de contraseña para que los usuarios puedan configurar sus contraseñas y probar su identidad. Una vez que Atlas obtiene las credenciales del usuario, Atlas vincula la cuenta de Atlas del usuario a su instalación de Vercel y concede a este usuario el rol
Organization Owneren Atlas. Atlas mantiene los permisos de la organización en línea con los permisos de Vercel. Los roles de "Administrador" y "Usuario" de Vercel se asignan a rolesOrganization OwneryOrganization Read Onlyen Atlas, respectivamente.
Si cualquier usuario del equipo de Vercel instala clústeres de Atlas adicionales utilizando la integración nativa, Atlas no añade automáticamente estos usuarios a la organización de Atlas creada para el equipo de Vercel. El propietario de la organización Atlas debe asegurarse de que todos los usuarios del equipo Vercel que necesitan acceso a la organización Atlas lo tengan. Esto también se aplica a los nuevos usuarios del equipo de Vercel que se unen al equipo de Vercel después de la instalación inicial de la Integración nativa.
Utiliza uno de los siguientes métodos para asegurarte de que Atlas añada usuarios adicionales del equipo de Vercel a la organización de Atlas:
Los usuarios del equipo de Vercel pueden acceder a la organización de Atlas en la Interfaz de Usuario de Atlas a través de la Interfaz de Usuario de Vercel. Si aún no son usuarios de Atlas, Atlas realiza el provisionamiento de cuentas para ellos, con asignación a la organización de Atlas para la integración nativa.
El propietario de la Organización Atlas puede invitar a usuarios de Atlas a la Organización Atlas.
Variables de entorno
La integración nativa configura automáticamente la variable de entorno
MONGODB_URIpara conexiones seguras de base de datos. Para la lista completa de variables de entorno, se puede consultar la interfaz de Vercel de la integración nativa de Atlas.Facturación
La integración nativa de Vercel crea una nueva organización Atlas desde la Interfaz de Usuario de Vercel, que se conecta automáticamente a un plan de facturación del mercado de Vercel como método de pago activo para la organización Atlas. La facturación se produce por organización de Atlas e incluye una factura colectiva de todos los clústeres y servicios de MongoDB Atlas en la organización. En Vercel y Atlas, se puede ver la confirmación de la facturación de Vercel Marketplace para la organización Atlas, así como los costos de uso diario.
Seguridad
Atlas garantiza conexiones seguras mediante autenticación SCRAM con listas de IP admitidas para los clústeres de Atlas que se crean a través de la integración nativa en Vercel.
Eliminación o desinstalación de la integración nativa
Después de desinstalar una integración de Vercel, se recomienda que el propietario de la organización de Atlas verifique que las asignaciones de acceso y los métodos de facturación estén actualizados, y remueva los accesos obsoletos o no deseados para evitar recordatorios automáticos de MongoDB sobre pagos pendientes. Atlas envía una factura final de Vercel por el Atlas a Vercel y remueve el método de pago del Mercado Vercel de la Organización Atlas.
Esta factura no es una factura final de Atlas, ya que aún podría haber cargos adicionales por parte de la Organización después de la desinstalación por el uso más reciente que quizás aún no se haya facturado. Es responsabilidad del usuario agregar un nuevo método de pago para la Organización para garantizar que se puedan cubrir los consumos pendientes.
No es posible desinstalar o desvincular la integración nativa desde la interfaz de Atlas, aunque siempre se pueden borrar los recursos en Atlas. Si se borra un clúster vinculado a Vercel, esto se reflejará en la Interfaz de Usuario de Vercel.
Comenzar en la Interfaz de Usuario de Vercel para Next.js
La interfaz de usuario de Vercel para la integración nativa incluye instrucciones para comenzar con Next.js y Atlas.
Plantillas de implementación
La Interfaz de Usuario de Vercel para la integración nativa incluye plantillas de implementación. Estas plantillas incluyen código de ejemplo y archivos de configuración para ayudar a empezar con los proyectos de Atlas en Vercel.
Agregar una integración nativa
Para agregar la integración nativa de MongoDB Atlas en Vercel:
Instalar la integración nativa de MongoDB Atlas.
Ir al Mercado Vercel y utilizar la búsqueda o el filtro de categoría del lado izquierdo para Storage para localizar MongoDB Atlas en la lista de Integraciones Nativas.
Hacer clic en Install en la página de MongoDB Atlas para la integración, o hacer clic en Install en la esquina superior derecha de la página de la Interfaz de Usuario de Vercel para la integración.
Elegir un nivel de clúster.
Elegir un clúster Atlas gratuito, flexible o dedicado:
Gratis ($0, Almacenamiento: 512 MB, RAM: Compartida, vCPU: Compartida)
Flex ($0.011/hora, Almacenamiento: hasta 5 GB, RAM: compartida, vCPU: compartida)
Dedicado ($0.08/hora, Almacenamiento: 10 GB, RAM: 2 GB, vCPU: 2xCPU)
Importante
Los clústeres gratuitos están disponibles en todos los planes de instalación. Los clústeres Flex y dedicados solo están disponibles en los planes de instalación de pago.
Seleccionar una región de clúster.
Se muestra una lista de regiones de Vercel. Estas regiones se corresponden con regiones de MongoDB Atlas en la mayoría de los casos. Si se elige una región de Vercel que no tiene una región de Atlas correspondiente, Atlas elige la región más cercana a la región de Vercel que se seleccionó.
Seleccionar un plan de instalación: gratuito o de pago.
Plan gratuito $0
No se necesita tarjeta de crédito. Solo se pueden crear clústeres de MongoDB Atlas gratuitos con este plan.
Plan de pago
Se requiere tarjeta de crédito. Se pueden crear clústeres Free, Flex y clústeres dedicados con este plan. Solo se facturarán los clústeres Flex y dedicados.
Si se elige un clúster Flex o Atlas dedicado, el plan gratuito aparece en gris. Si algún nodo del equipo de Vercel utiliza este plan de integración nativa con un plan gratuito y decide crear un clúster Flex o dedicado, el plan pasa a ser un plan de pago. Incluso si se desinstala un clúster de MongoDB Atlas que no es gratuito, el plan sigue siendo pago. Para cambiar al plan gratuito, se debe desinstalar la integración nativa y luego instalarla nuevamente, eligiendo un clúster gratuito y un plan gratuito. Para aprender cómo desinstalar cualquier integración nativa, se puede consultar la documentación de Vercel.
Ahora se puede utilizar la integración nativa de Atlas en Vercel para:
Conectarse a un proyecto de Vercel.
Extraer las últimas variables de entorno.
Si ya no se necesita este clúster de MongoDB Atlas, se puede desinstalar la Integración Nativa y, al hacerlo, borrar una base de datos de MongoDB Atlas. Para obtener instrucciones, se puede consulta la documentación de Vercel.
También se puede borrar la base de datos (el recurso) sin desinstalar toda la integración. Esto es útil en los casos en que se desea mantener la integración para crear otros recursos en el futuro, o si se tienen otros recursos en la misma integración.
Si se borra un clúster de Atlas vinculado a Vercel, los proyectos que se hayan vinculado a este clúster en Vercel ya no tendrán acceso a esta base de datos. Antes de continuar con la desinstalación y eliminación del clúster de Atlas, se debe verificar que este clúster de Atlas ya no esté siendo utilizado por ningún proyecto o aplicación.
Ponte en contacto con soporte
Si se presentan problemas al utilizar una integración nativa de Vercel con MongoDB Atlas, se debe contactar al soporte de integraciones de Vercel en MongoDB en vercel-integation-support@mongodb.com.
Desconecta una integración de Vercel
Antes de desconectar los Proyectos de Vercel de los clústeres de Atlas, para evitar tiempo de inactividad en cualquier aplicación conectada a los mismos clústeres de Atlas, se debe verificar que los usuarios del clúster y las reglas de acceso de red no compartan otros proyectos y aplicaciones conectadas a este clúster de Atlas.
Haga clic para desinstalar o eliminar la integración.
Siga las instrucciones de la interfaz de usuario de Vercel para desinstalar la integración. Para obtener instrucciones detalladas, consulte la documentación de Vercel.
Confirma si deseas desconectar esta integración de Vercel.
Desconectar la integración puede provocar un tiempo de inactividad de tus aplicaciones Vercel y de cualquier otra aplicación que se conecte a los clústeres Atlas que vinculaste a Vercel.
Después de desinstalar una integración de Vercel, recomendamos que Atlas se asegure de Organization Owner que las asignaciones de acceso y los métodos de facturación estén actualizados, y elimine el acceso obsoleto o no deseado para evitar recordatorios automáticos de MongoDB sobre pagos de facturación vencidos.
Atlas envía una factura final de Vercel para la integración de Atlas Vercel a Vercel y elimina el método de pago Vercel Marketplace de la Organización Atlas.
Esta factura no es definitiva, ya que la organización podría tener cargos adicionales incurridos tras la desinstalación por el uso más reciente, que podrían no haberse facturado aún. Usted es responsable de agregar un nuevo método de pago a la organización para garantizar que se pueda pagar cualquier uso pendiente.