Revisión de una solicitud de extracción
Puede utilizar la consola de Amazon CodeCatalyst para revisar y comentar de forma colaborativa los cambios incluidos en una solicitud de extracción. Puede añadir comentarios en líneas de código individuales en la diferencia entre las ramificaciones de origen y destino, o en la diferencia entre las revisiones de la solicitud de extracción. Puede optar por crear un resumen de los comentarios relativos a los cambios de código en la solicitud de extracción para entender más rápidamente los comentarios que hayan dejado otros usuarios. También puede optar por crear un entorno de desarrollo para trabajar con el código.
nota
nota
Con tecnología de Amazon Bedrock: AWS implementa la detección automática de abusos. Como las características Escribir descripción automáticamente, Crear un resumen del contenido, Recomendar tareas, Utilizar Amazon Q para crear o agregar características a un proyecto y Asignar problemas a Amazon Q del agente de Amazon Q Developer para el desarrollo de software están basadas 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
Como parte de su configuración de perfil, puede establecer de qué eventos de solicitudes de extracción quiere recibir correos electrónicos. Para obtener más información, consulte Envío de 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 se encontraba en el extremo de la ramificación de destino cuando se creó la solicitud de extracción. Esto se denomina base de combinación. Para obtener más información sobre las diferencias y las bases de combinación en Git, consulte git-merge-base
sugerencia
Al trabajar en la consola, sobre todo si tiene una solicitud de extracción abierta desde hace algún tiempo, plantéese la actualización de su navegador para asegurarse de que tenga disponible la última revisión de una solicitud de extracción disponible antes de empezar a revisarla.
Revisión de una solicitud de extracción en la consola de CodeCatalyst
-
Vaya a su proyecto.
-
Acceda a las solicitudes de extracción de una de estas formas:
-
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, seleccione Ver todo. Use los filtros y los criterios de ordenación para encontrar la solicitud de extracción y selecciónela de la lista.
-
En el panel de navegación, seleccione Código y después Solicitudes de extracción.
-
-
Elija la solicitud de extracción que quiera revisar en la lista. Puede filtrar la lista de solicitudes de extracción escribiendo parte de su nombre en la barra de filtros.
-
En Información general, puede revisar el nombre y el título de la solicitud de extracción. Puede crear y ver los comentarios que se hayan dejado en la propia solicitud de extracción. También puede ver los detalles de la solicitud de extracción, incluida la información sobre las ejecuciones de flujos de trabajo, los problemas relacionados, los revisores, el autor de la solicitud de extracción y las posibles estrategias de combinación.
nota
Los comentarios que se dejan en líneas de código específicas aparecen en Cambios.
-
(Opcional) Para agregar un comentario que se aplique a toda la solicitud de extracción, expanda Comentarios sobre la solicitud de extracción y seleccione Crear comentario.
-
(Opcional) Para ver un resumen de todos los comentarios que se hayan dejado sobre los cambios en las revisiones de esta solicitud de extracción, seleccione Crear resumen de comentarios.
nota
Esta funcionalidad requiere que las características de IA generativa estén habilitadas para el espacio y solo está disponible en la región Oeste de EE. UU. (Oregón). Para obtener más información, consulte Managing generative AI features.
-
En Cambios, puede ver las diferencias entre la ramificación de destino y la revisión más reciente de la solicitud de extracción. Si hay más de una revisión, puede cambiar las revisiones que se comparan en la diferencia entre ellas. Para obtener más información acerca de las revisiones, consulte Revisiones.
sugerencia
En Archivos cambiados puede 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. El número de comentarios que se muestra junto a una carpeta indica el número de comentarios en los archivos de esa carpeta. Expanda la carpeta para ver el número de comentarios de cada archivo de la carpeta.
-
Para cambiar la forma en que se muestran las diferencias, elija entre Unificado y Dividido.
-
Para agregar un comentario a una línea en la solicitud de extracción, vaya a la línea sobre la que desee realizar un comentario. Elija el icono de comentario que aparece para esa línea, introduzca un comentario y elija Guardar.
-
Para ver los cambios entre las revisiones de una solicitud de extracción, o entre sus ramificaciones de origen y destino, seleccione una de las opciones disponibles en Comparando. Los comentarios sobre las líneas de las revisiones se conservan en esas revisiones.
-
Si ha configurado el flujo de trabajo para generar un informe de cobertura del código sobre los activadores de las solicitudes de extracción, puede ver los resultados de cobertura de las líneas y ramificaciones en la solicitud de extracción pertinente. Para ocultar los resultados de la cobertura del código, seleccione Ocultar la cobertura del código. Para obtener más información, consulte Informes de cobertura de código.
Si quiere hacer cambios en el código de la solicitud de extracción, puede crear un entorno de desarrollo a partir de la solicitud de extracción. Seleccione Crear entorno de desarrollo. Puede agregar un nombre para el entorno de desarrollo o editar su configuración; a continuación, seleccione Crear.
-
En Informes puede ver los informes de calidad de esta solicitud de extracción. Si hay más de una revisión, puede 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
Debe configurar un flujo de trabajo para generar informes de modo que aparezcan en las solicitudes de extracción. Para obtener más información, consulte Configuración de informes de calidad en una acción.
-
Para ver un informe específico, selecciónelo en la lista. Para obtener más información, consulte Pruebas con flujos de trabajo.
-
Si aparece como revisor de esta solicitud de extracción y quiere aprobar los cambios, asegúrese de que está viendo la revisión más reciente y seleccione Aprobar.
nota
Todos los revisores necesarios deben aprobar una solicitud de extracción antes de que se pueda combinar.
