Revisión de una solicitud de extracción

Puedes usar la CodeCatalyst consola de Amazon para revisar y comentar de forma colaborativa los cambios incluidos en una solicitud de cambios. Puedes añadir comentarios a líneas de código individuales en la diferencia entre la rama de origen y la de destino, o en la diferencia entre las revisiones de la solicitud de cambios. Puedes optar por crear un resumen de los comentarios dejados sobre los cambios de código en la solicitud de extracción para ayudarte a entender rápidamente los comentarios dejados por otros usuarios. También puedes optar por crear un entorno de desarrollo para trabajar con el código.

nota

Desarrollado por Amazon Bedrock: AWS implementa la detección automática de abusos. Como las funciones Escribir una descripción para mí y Crear un resumen de contenido están integradas en Amazon Bedrock, los usuarios pueden aprovechar al máximo los controles implementados en Amazon Bedrock para garantizar la protección, la seguridad y el uso responsable de la inteligencia artificial (IA).

sugerencia

Puedes configurar los eventos de pull request sobre los que recibirás correos electrónicos como parte de tu perfil. Para obtener más información, consulte Enviar notificaciones de Slack y por correo electrónico desde CodeCatalyst.

Las solicitudes de extracción muestran cuál es la diferencia entre la revisión de la solicitud de extracción y la confirmación que estaba en la punta de la sucursal de destino cuando creaste la solicitud de extracción. Esto se denomina base de fusión. Para obtener más información sobre las diferencias y las bases de fusión en Git, consulta git-merge-basela documentación de Git.

sugerencia

Cuando trabajes en la consola, sobre todo si llevas un tiempo abierta una solicitud de extracción, te recomendamos actualizar tu navegador para asegurarte de que tienes disponible la última versión de una solicitud de extracción antes de empezar a revisarla.

Para revisar una solicitud de extracción en la CodeCatalyst consola

1. Vaya a su proyecto.

2. Para acceder a las solicitudes de extracción, realiza una de las siguientes acciones:

   • Si la solicitud de extracción aparece en la página del proyecto, selecciónela de la lista.

   • Si la solicitud de extracción no aparece en la página del proyecto, selecciona Ver todo. Usa los filtros y ordena para encontrar la solicitud de extracción y, a continuación, selecciónela de la lista.

   • En el panel de navegación, selecciona Código y, a continuación, selecciona Solicitudes de extracción.

3. Selecciona de la lista la solicitud de extracción que deseas revisar. Puedes filtrar la lista de solicitudes de extracción escribiendo parte de su nombre en la barra de filtros.

4. En Descripción general, puedes revisar el nombre y el título de la solicitud de extracción. Puedes crear y ver los comentarios dejados en la propia solicitud de extracción. También puedes ver los detalles de la solicitud de extracción, incluida la información sobre la ejecución del flujo de trabajo, los problemas relacionados, los revisores, el autor de la solicitud de extracción y las posibles estrategias de fusión.

   nota

   Los comentarios que se dejan en líneas de código específicas aparecen en Cambios.

5. (Opcional) Para añadir un comentario que se aplique a toda la solicitud de extracción, expande Comentarios en la solicitud de extracción y, a continuación, selecciona Crear comentario.

6. (Opcional) Para ver un resumen de todos los comentarios dejados sobre los cambios en las revisiones de esta solicitud de extracción, selecciona Crear resumen de comentarios.

   nota

   Esta funcionalidad requiere que las funciones de IA generativa estén habilitadas en el espacio y solo está disponible en la región EE.UU. Oeste (Oregón). Para obtener más información, consulte Administrar las funciones de IA generativa.

7. En Cambios, puedes ver las diferencias entre la sucursal de destino y la revisión más reciente de la pull request. Si hay más de una revisión, puedes cambiar las revisiones que se comparan en la diferencia entre ellas. Para obtener más información sobre las revisiones, consulteRevisiones.

   sugerencia

   Puedes ver rápidamente cuántos archivos tienen cambios en la solicitud de extracción y qué archivos de la solicitud de extracción tienen comentarios, en Archivos cambiados. El número de comentarios que se muestra junto a una carpeta indica el número de comentarios en los archivos de esa carpeta. Amplíe la carpeta para ver el número de comentarios de cada archivo de la carpeta.

8. Para cambiar la forma en que se muestran las diferencias, elija entre Unificado y Dividido.

9. Para añadir un comentario a una línea de la solicitud de extracción, dirígete a la línea sobre la que quieres añadir un comentario. Elige el icono de comentario que aparece en esa línea, introduce un comentario y, a continuación, selecciona Guardar.

10. Para ver los cambios entre las revisiones de una solicitud de cambios o entre sus ramas de origen y destino, selecciona una de las opciones disponibles en Comparación. Los comentarios sobre las líneas de las revisiones se conservan en esas revisiones.

11. Si has configurado tu flujo de trabajo para generar un informe de cobertura de códigos sobre los activadores de las solicitudes de extracción, puedes ver los datos de cobertura de las líneas y sucursales en la solicitud de extracción correspondiente. Para ocultar los resultados de la cobertura del código, selecciona Ocultar la cobertura del código. Para obtener más información, consulte Informes de cobertura de código.

12. Si quieres hacer cambios de código en la solicitud de extracción, puedes crear un entorno de desarrollo a partir de la solicitud de extracción. Seleccione Crear entorno de desarrollo. Si lo desea, agregue un nombre para el entorno de desarrollo o edite su configuración y, a continuación, elija Crear.

13. En Informes, puedes ver los informes de calidad de esta solicitud de extracción. Si hay más de una revisión, puedes cambiar las revisiones que se comparan en la diferencia entre ellas. Puede filtrar los informes por nombre, estado, flujo de trabajo, acción y tipo.

    nota

    Debes configurar un flujo de trabajo para generar informes para que aparezcan en tus solicitudes de extracción de cambios. Para obtener más información, consulte Configuración de informes de calidad en una acción.

14. Para ver un informe específico, selecciónalo de la lista. Para obtener más información, consulte Pruebas con flujos de trabajo.

15. Si apareces como revisor de esta solicitud de información y deseas aprobar los cambios, asegúrate de que estás viendo la revisión más reciente y, a continuación, selecciona Aprobar.

    nota

    Todos los revisores necesarios deben aprobar una solicitud de extracción antes de que se pueda fusionar.