Vistas previas web para solicitudes de extracción

Las vistas previas web ofrecen a los equipos de desarrollo y control de calidad (QA) una manera de previsualizar los cambios de las solicitudes de extracción (PR) antes de fusionar el código en una ramificación de producción o integración. Las solicitudes de extracción le permiten informar a otros sobre los cambios introducidos en una ramificación de un repositorio. Tras abrir una solicitud de extracción, puede analizar y revisar los posibles cambios con sus colaboradores y añadir confirmaciones de seguimiento antes de fusionar los cambios en la ramificación base.

La vista previa web presenta todas las solicitudes de extracción realizadas en el repositorio en una URL de vista previa única. Esta URL es totalmente diferente a la de su sitio principal. En el caso de las aplicaciones con entornos de backend aprovisionados mediante la CLI de Amplify o Amplify Studio, cada solicitud de extracción (solo repositorios Git privados) crea un backend temporal que se elimina al cerrar la PR.

Cuando las vistas previas web están activadas para su aplicación, cada PR cuenta para la cuota de Amplify, que consiste en 50 ramificaciones por aplicación. Para evitar superar esta cuota, asegúrese de cerrar sus PR. Para obtener más información sobre las cuotas, consulte Service Quotas de Amplify Hosting.

nota

Actualmente, la variable de entorno AWS_PULL_REQUEST_ID no está disponible cuando se utiliza AWS CodeCommit como el proveedor de repositorios.

Habilite las vistas previas web

En el caso de aplicaciones almacenadas en un repositorio de GitHub, las vistas previas emplean la aplicación de Amplify GitHub para acceder al repositorio. Si habilita las vistas previas web en una aplicación de Amplify existente que haya implementado previamente desde un repositorio de GitHub con acceso mediante OAuth, deberá migrar la aplicación para poder usar la aplicación de Amplify GitHub. Para obtener información sobre cómo realizar la migración, consulte Migrar una aplicación de OAuth existente a la aplicación de Amplify GitHub.

importante

Por motivos de seguridad, puede habilitar las vistas previas web en todas las aplicaciones con repositorios privados, pero no en todas las aplicaciones con repositorios públicos. Si su repositorio de Git es público, puede configurar vistas previas solo para las aplicaciones que no requieran un rol de servicio de IAM.

Por ejemplo, las aplicaciones con backend y aquellas que se implementan en la plataforma de alojamiento de WEB_COMPUTE requieren un rol de servicio de IAM. Por lo tanto, si su repositorio es público, no podrá habilitar las vistas previas web para este tipo de aplicaciones.

Amplify aplica esta restricción para evitar que posibles terceros envíen un código arbitrario que se ejecutaría con los permisos de rol de IAM de su aplicación.

Para habilitar las vistas previas web de solicitudes de extracción

1. Seleccione Alojamiento y, a continuación, Vistas previas.

   nota

   Vistas previas solo es visible en el menú Configuración de aplicación cuando una aplicación está configurada para implementación continua y conectada a un repositorio de git. Para obtener instrucciones sobre este tipo de implementación, consulte Primeros pasos con el código existente.

2. En repositorios de GitHub, siga estos pasos para instalar y autorizar la aplicación de Amplify GitHub en su cuenta:

   1. En la ventana Instalar la aplicación GitHub para habilitar vistas previas, elija Instalar aplicación GitHub.

   2. Seleccione la cuenta de GitHub en la que desea configurar la aplicación de Amplify GitHub.

   3. Se abrirá una página en GitHub.com para configurar los permisos de repositorio de su cuenta.

   4. Realice una de las siguientes acciones siguientes:

      • Para aplicar la instalación a todos los repositorios, elija Todos los repositorios.

      • Para limitar la instalación solo a repositorios específicos, elija Solo los repositorios seleccionados. Asegúrese de incluir en esta selección el repositorio de la aplicación para la que desea habilitar las vistas previas web.

   5. Elija Guardar

3. Tras habilitar las vistas previas para su repositorio, vuelva a la consola de Amplify para habilitar las vistas previas de ramificaciones específicas. En la página Vistas previas, elija una ramificación de la lista y elija Editar configuración.

4. En la ventana Administrar la configuración de la vista previa, active Vistas previas de solicitudes de extracción. A continuación, seleccione Confirm (Confirmar).

5. Para aplicaciones de pila completa, siga uno de estos pasos:

   • Elija Crear nuevo entorno de backend para cada solicitud de extracción. Esta opción le permitirá probar los cambios sin que ello afecte a la producción.

   • Elija Dirigir todas las solicitudes de extracción de esta ramificación a un entorno existente.

6. Elija Confirmar.

La próxima vez que envíe una solicitud de extracción a esa ramificación, Amplify compilará e implementará su PR en una URL de vista previa. Una vez cerrada la solicitud de extracción, se eliminará la URL de vista previa, así como cualquier entorno de backend temporal vinculado a la solicitud de extracción. En repositorios de GitHub, puede acceder a una vista previa de su URL directamente desde la solicitud de extracción en su cuenta de GitHub.

Acceso a vista previa web con subdominios

Es posible acceder a vistas previas web de las solicitudes de extracción con los subdominios de una aplicación de Amplify que esté conectada a un dominio personalizado administrado por Amazon Route 53. Una vez cerrada la solicitud de extracción, las ramificaciones y subdominios asociados a la misma se eliminarán automáticamente. Tras configurar la implementación de ramificaciones con características basadas en patrón para su aplicación, este será el comportamiento predeterminado de las vistas previas web. Para obtener más información sobre cómo configurar los subdominios automáticos, consulte Configuración de subdominios automáticos para un dominio personalizado de Amazon Route 53.