

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Vistas previas web para solicitudes de extracción
<a name="pr-previews"></a>

Las vistas previas web ofrecen a los equipos de desarrollo y control de calidad (QA) una forma de previsualizar los cambios de las solicitudes de cambios (PRs) antes de fusionar el código en una rama 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úrate de cerrar la tuya PRs. Para obtener más información sobre las cuotas, consulte [Service Quotas de Amplify Hosting](quotas-chapter.md).

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

**Seguridad de vista previa web**

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.

Cuando las vistas previas web están habilitadas para una aplicación en un repositorio público, con una función de SSR Compute, es necesario administrar de manera muy cuidadosa qué sucursales pueden acceder a esa función. Se recomienda que no utilice un rol a nivel de aplicación. En su lugar, se debe asignar un rol de Compute a nivel de ramificación. Esto permite conceder permisos solo a las ramificaciones que requieren acceso a recursos específicos. Para obtener más información, consulte [Añadir un rol de SSR Compute para permitir el acceso a los recursos AWS](amplify-SSR-compute-role.md) .

## Habilitar las vistas previas web de solicitudes de extracción
<a name="enable-web-previews"></a>

En el caso de las aplicaciones almacenadas en un GitHub repositorio, las vistas previas web utilizan la aplicación GitHub Amplify para acceder al repositorio. Si está habilitando las vistas previas web en una aplicación Amplify existente que implementó anteriormente desde un GitHub repositorio utilizando OAuth para acceder, primero debe migrar la aplicación para usar la aplicación Amplify. GitHub Para obtener información sobre cómo realizar la migración, consulte [Migración de una OAuth aplicación existente a la aplicación Amplify GitHub](setting-up-GitHub-access.md#migrating-to-github-app-auth).

**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](getting-started.md).

1. Solo para GitHub los repositorios, haz lo siguiente para instalar y autorizar la aplicación GitHub Amplify en tu cuenta:

   1. En la ventana **Instalar GitHub aplicación para habilitar las vistas previas**, seleccione **Instalar GitHub ** aplicación.

   1. Seleccione la GitHub cuenta en la que desee configurar la aplicación Amplify GitHub.

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

   1. Realice una de las siguientes acciones:
      + 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.

   1. Elija **Guardar**

1. 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**. 

1. 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)**.

1. 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**.

1. 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. Solo en el caso de GitHub los repositorios, puedes acceder a una vista previa de tu URL directamente desde la solicitud de extracción de información de tu GitHub cuenta.

## Acceso a vista previa web con subdominios
<a name="web-preview-access-on-subdomains"></a>

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](to-set-up-automatic-subdomains-for-a-Route-53-custom-domain.md).