Overview
Puedes actualizar una aplicación existente modificando su configuración subyacente y luego implementando esos cambios. Hay varias maneras de hacerlo:
La interfaz de administración de App Services: una aplicación web integrada en MongoDB Atlas. Incluye una interfaz gráfica para cualquier configuración de la aplicación.
La CLI de App Services: una herramienta de línea de comandos que permite configurar e implementar la aplicación localmente. Trabaja directamente con los archivos de configuración subyacentes de la aplicación.
API de administración: una API REST que permite configurar e implementar la aplicación mediante programación. Las solicitudes de la API de administración leen y escriben los archivos de configuración subyacentes de la aplicación.
Implementación automática de GitHub: una integración de GitHub que sincroniza la configuración de tu app con un repositorio de GitHub. Puedes usar GitHub para administrar los archivos de configuración de tu app e implementarla enviando los cambios al repositorio.
Actualizar una aplicación existente
Antes de comenzar
Necesitará lo siguiente para actualizar una aplicación en la interfaz de usuario de Atlas:
Una cuenta de MongoDB Atlas con permisos de propietario del proyecto. Para saber cómo crear una cuenta gratuita, consulte Comience a utilizar Atlas.
Necesitará lo siguiente para actualizar una aplicación en la CLI:
Una cuenta de MongoDB Atlas con permisos de propietario de proyecto. Para obtener información sobre cómo crear una cuenta gratuita, consulte Introducción a Atlas.
Un par de claves pública/privada de la API de administración de MongoDB Atlas. La clave de API debe tener permisos de propietario del proyecto para funcionar con la API de administración de App Services.
Una copia de la CLI de App Services instalada y agregada a su sistema local
PATHPara saber cómo hacerlo,consulte Instalar la CLI de App Services.
Necesitará lo siguiente para actualizar una aplicación con la API de administración:
Una cuenta de MongoDB Atlas con permisos de propietario de proyecto. Para obtener información sobre cómo crear una cuenta gratuita, consulte Introducción a Atlas.
Un par de claves pública/privada de la API de administración de MongoDB Atlas. La clave de API debe tener permisos de propietario del proyecto para funcionar con la API de administración de App Services.
Para actualizar una aplicación según los archivos de configuración en un repositorio de GitHub, debe habilitar la Implementación automática de GitHub para la aplicación.
Procedimiento
Realice cambios en su aplicación
Empieza por añadir, modificar o eliminar cualquier elemento que quieras incluir en la implementación a través de la interfaz de usuario de App Services. Si tienes habilitados los borradores, los cambios se guardarán automáticamente como borrador.
Tip
Nota
Solo puedes crear borradores de cambios a través de la interfaz de usuario de App Services o la API de administración. Cualquier cambio que realices con GitHub o la CLI de App Services se implementa independientemente de los borradores de cambios. Para evitar posibles conflictos o inconsistencias, es mejor realizar los cambios en un solo lugar a la vez.
Revisar los cambios del borrador
Puede revisar todos los borradores de cambios en su aplicación antes de implementarlos.
Haga clic Deployment En el menú de navegación izquierdo, accede a la tabla del historial de implementación de tu aplicación. La fila superior de la tabla representa todos los cambios preliminares que has realizado desde la implementación anterior.
Haga Review Draft and Deploy clic en el botón en la fila superior para ver una diferencia de los archivos de configuración de la aplicación subyacente que representan los cambios preliminares que ha realizado.
Nota
Es posible que desee descargar un borrador de sus cambios debido a conflictos de fusión o para guardarlo fuera de la interfaz de usuario. Puede hacerlo en el modal Review Draft and Deploy haciendo clic en Export State en la esquina superior derecha. Puede usar la descarga para implementar sus cambios en los servicios de aplicaciones o como referencia al reaplicar los cambios en la interfaz de usuario.
Implementar una nueva versión de la aplicación
Después de revisar los cambios del borrador y confirmar que desea implementarlos, haga clic en Deploy. App Services implementa una nueva versión de su aplicación que incluye los cambios del borrador. Las aplicaciones cliente usarán automáticamente la versión más reciente, así que asegúrese de actualizar también su código cliente para usar la nueva versión si es necesario.
Obtenga la última versión de su aplicación
Obtén una copia local de los archivos de configuración de tu aplicación. Para obtener la última versión, ejecuta el siguiente comando:
appservices pull --remote="<Your App ID>"
También puedes exportar una copia de los archivos de configuración de tu aplicación desde la interfaz de usuario o con la API de administración. Para saber cómo, consulta Exportar una aplicación.
Actualice su aplicación
Agregue, elimine y modifique archivos de configuración para los distintos componentes de su aplicación.
Crear un nuevo borrador (opcional)
Un borrador representa un grupo de cambios en la aplicación que se pueden implementar o descartar como una sola unidad. Si no se crea un borrador, las actualizaciones se implementan automáticamente de forma individual.
Para crear un borrador, envíe una POST solicitud sin cuerpo al punto final Crear un nuevo borrador de implementación:
curl -X POST 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/drafts' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <access_token>'
Importante
Un borrador por usuario
Cada usuario solo puede crear un borrador a la vez, ya sea a través de la interfaz de usuario o de la API de administración. Si ya tiene un borrador, puede descartar los cambios asociados enviando una DELETE solicitud al punto final "Descartar un borrador de implementación":
curl -X DELETE 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/drafts/{draftId}' \ -H 'Authorization: Bearer <access_token>'
Realice cambios en su aplicación
Puede configurar su aplicación y agregar, modificar o eliminar componentes llamando a los puntos de conexión de la API de administración para cada operación. Para obtener ejemplos e información de referencia detallada, consulte la API de administración de Atlas App Services.
Si no creó un borrador, cada solicitud de API de administración exitosa implementará inmediatamente las actualizaciones asociadas a la aplicación.
Si creaste un borrador, cada solicitud exitosa de la API de administración agrega las actualizaciones correspondientes. Envía solicitudes para todos los cambios que quieras incluir en el borrador.
Implementar el borrador
Si creó un borrador, puede implementar todos los cambios en el borrador enviando una POST solicitud sin cuerpo al punto final Implementar un borrador de implementación:
curl -X POST \ 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/drafts/{draftId}/deployment' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <access_token>' \
Con la Implementación Automática de GitHub habilitada, tu aplicación siempre usa los archivos de configuración de la confirmación más reciente en tu repositorio vinculado. Para obtener más información sobre cómo organizar y definir los archivos de configuración, consulta Configuración de la aplicación.
Actualice su aplicación agregando, modificando y eliminando archivos de configuración localmente.
Cuando estés listo para implementar tus cambios, compromete los archivos de configuración y luego súbelos a GitHub:
git add -A git commit -m "<commit message>" git push origin <branch name>
Después de enviar, la integración de GitHub implementa automáticamente una versión actualizada de su aplicación en función de los archivos de configuración en la última confirmación.
Borradores de implementación
Un borrador de implementación es un conjunto de una o más actualizaciones de tu aplicación que puedes aplicar o descartar como un solo grupo. Implementar un borrador es útil cuando los cambios incluyen servicios o funciones que interactúan entre sí.
La interfaz de usuario de App Services usa borradores de implementación de forma predeterminada. Si esta opción está habilitada, cualquier cambio que realices en la configuración de tu aplicación en la interfaz de usuario de App Services se añadirá a un borrador que implementarás manualmente. Puedes deshabilitar los borradores de la interfaz de usuario si prefieres implementarlos inmediatamente al guardar en la interfaz de usuario.
Tanto la CLI de App Services como la implementación de GitHub crean e implementan borradores automáticamente. Al ejecutar el comando push de git push la CLI o en la rama de implementación, la CLI o la aplicación de GitHub crean una comparación de los archivos de configuración locales con la configuración implementada. A continuación, crean e implementan un borrador basado en la comparación.
La API de administración de App Services permite crear e implementar borradores manualmente. Para saber cómo, consulta "Implementar un grupo de cambios".
Conflictos del borrador
Evite que varios usuarios realicen cambios conflictivos en los borradores de la interfaz de usuario o la API simultáneamente. Si hay varios borradores simultáneos con cambios conflictivos, no podrá implementar uno o más de ellos.
Por ejemplo, si implementa cambios a través de la API pero tiene un borrador de IU existente con cambios conflictivos, su borrador de IU dejará de ser válido y no podrá implementarlo.
Para solucionar un conflicto, puede descargar los archivos de configuración de un borrador de IU desde la página Deployment. Puede usarlos como referencia para volver a aplicar los cambios en la IU o implementarlos directamente con la CLI o la API de administración.
Deshabilitar borradores de implementación de UI
Puedes desactivar los borradores de la interfaz de usuario si prefieres implementarlos inmediatamente al guardar en la interfaz. Esta configuración no impide crear borradores manualmente con la API de administración.
Para deshabilitar los borradores de IU directamente desde la IU:
Haga clic en Deployment en el menú de navegación de la izquierda
Haz clic en la pestaña Configuration
Bajo el encabezado Disable Drafts in Atlas App Services, haga clic en Disable Drafts y luego confirme su decisión en la ventana modal.
Para deshabilitar los borradores de UI con la API de administración, envíe una solicitud al punto final Configurar implementación con ui_drafts_disabled establecido true en.
curl -X PATCH https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deploy/config \ -H 'Authorization: Bearer <access_token>' \ -H 'Content-Type: application/json' \ -d '{ "ui_drafts_disabled": true, "automatic_deployment": { "enabled": false, "installationIds": [], "lastModified": 0 } }'