Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md). 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. # Revisar el código con solicitudes de cambios en Amazon CodeCatalyst Una solicitud de extracción es el método principal para que usted u otros miembros del proyecto puedan revisar y combinar los cambios en el código entre ramificaciones o hacer comentarios sobre estos. Puede utilizar las solicitudes de extracción para revisar de forma colaborativa los cambios en el código relacionados con pequeños cambios o correcciones, incorporación de características importantes o versiones nuevas del software publicado. Si utiliza los problemas para hacer un seguimiento del trabajo en su proyecto, puede vincular problemas específicos a solicitudes de extracción para controlar mejor qué problemas están siendo abordados por los cambios de código de la solicitud de extracción. Al crear, actualizar, comentar, combinar o cerrar una solicitud de extracción, se envía automáticamente un correo electrónico al autor de la solicitud de extracción, así como a los revisores obligatorios u opcionales de la solicitud de extracción. **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](notifications-manage.md). Las solicitudes de extracción requieren dos ramificaciones en un repositorio de código fuente: una de origen, que contiene el código que se desea revisar, y otra de destino, donde se combina el código revisado. La ramificación de origen contiene la confirmación AFTER, que es la confirmación que contiene los cambios que se desean combinar en la ramificación de destino. La ramificación de destino contiene la confirmación BEFORE, que representa el estado del código antes de que la ramificación de la solicitud de extracción se combine con la ramificación de destino. **nota** Al crear una solicitud de extracción, la diferencia que se muestra es la diferencia entre el extremo de la ramificación de origen y el extremo de la ramificación de destino. Una vez creada la solicitud de extracción, la diferencia mostrada será aquella entre la revisión de la solicitud de extracción seleccionada y la confirmación que se encontraba en el extremo de la ramificación de destino cuando se creó la solicitud de extracción. Para obtener más información sobre las diferencias y las bases de fusión en Git, consulta [git-merge-base](https://git-scm.com/docs/git-merge-base)la documentación de Git. Mientras se crea una solicitud de extracción para un repositorio y unas ramificaciones de origen específicos, puede crear, visualizar, revisar y cerrarlas como parte del trabajo con su proyecto. No es necesario poder ver el repositorio de código fuente para poder ver las solicitudes de extracción y trabajar con ellas. El estado de una solicitud de extracción se establece en **Abierto** al crearla. La solicitud de extracción permanece abierta hasta que la combines en la CodeCatalyst consola, lo que cambia el estado a Combinado, **o** hasta que lo cierres, lo que cambia el estado a **Cerrado**. Una vez revisado el código, puede cambiar el estado de la solicitud de extracción de distintas maneras: + Combina la solicitud de extracción en la CodeCatalyst consola. El código de la ramificación de origen de la solicitud de extracción se combinará con la ramificación de destino. El estado de la solicitud de extracción cambiará a **Combinado**. No se puede volver a cambiar a **Abierto**. + Combina las ramas de forma local, inserta los cambios y, a continuación, cierra la solicitud de extracción en la CodeCatalyst consola. + Usa la CodeCatalyst consola para cerrar la solicitud de extracción sin fusionarla. Esto cambiará el estado a **Cerrado** y no fusionará el código de la ramificación de origen con el de la de destino. Antes de crear una solicitud de extracción: + Confirme e inserte los cambios del código que quiera revisar a la ramificación (ramificación de origen). + Configure las notificaciones para su proyecto de modo que otros usuarios puedan recibir notificaciones sobre cualquier flujo de trabajo que se ejecute al crear una solicitud de extracción. (Este paso es opcional, pero recomendable). **Topics** + [Creación de una solicitud de extracción](pull-requests-create.md) + [Visualización de solicitudes de extracción](pull-requests-view.md) + [Administración de los requisitos para combinar una solicitud de extracción con reglas de aprobación](source-pull-requests-approval-rules.md) + [Revisión de una solicitud de extracción](pull-requests-review.md) + [Actualización de una solicitud de extracción](pull-requests-update.md) + [Combinación de una solicitud de extracción](pull-requests-merge.md) + [Cierre de una solicitud de extracción](pull-requests-close.md) # Creación de una solicitud de extracción La creación de solicitudes de extracción ayuda a otros usuarios a ver y revisar los cambios en el código antes de combinarlos en otra ramificación. Primero debe crear una ramificación para los cambios de código. Esta es la ramificación de origen de una solicitud de extracción. Después de confirmar e insertar los cambios en el repositorio, puede crear una solicitud de extracción que compare el contenido de la ramificación de origen con el contenido de la ramificación de destino. Puedes crear una solicitud de extracción en la CodeCatalyst consola de Amazon desde una sucursal específica, desde la página de solicitudes de extracción o desde la descripción general del proyecto. Al crear una solicitud de extracción desde una ramificación específica, se obtiene automáticamente el nombre del repositorio y la ramificación de origen en la página de creación de la solicitud de extracción. Al crear una solicitud de extracción, recibirá automáticamente correos electrónicos sobre cualquier actualización de la solicitud de extracción, así como en los momentos en los que la solicitud de extracción se combine o cierre. **nota** Al crear una solicitud de extracción, la diferencia que se muestra es la diferencia entre el extremo de la ramificación de origen y el extremo de la ramificación de destino. Una vez creada la solicitud de extracción, la diferencia mostrada será aquella entre la revisión de la solicitud de extracción seleccionada y la confirmación que se encontraba en el extremo de la ramificación de destino cuando se creó la solicitud de extracción. Para obtener más información sobre las diferencias y las bases de fusión en Git, consulta [git-merge-base](https://git-scm.com/docs/git-merge-base)la documentación de Git. Puede usar la característica **Escribir descripción automáticamente** al crear solicitudes de extracción para que Amazon Q cree automáticamente una descripción de los cambios contenidos en una solicitud de extracción. Al elegir esta opción, Amazon Q analiza las diferencias entre la ramificación de origen, que contiene los cambios de código, y la ramificación de destino en la que quiera combinar estos cambios. A continuación, crea un resumen de cuáles son esos cambios, así como su mejor interpretación de la intención y el efecto de dichos cambios. Esta función solo está disponible en la región de EE.UU. Oeste (Oregón) para las solicitudes de CodeCatalyst extracción. La característica **Escribir descripción automáticamente** no está disponible para las solicitudes de extracción de datos en los repositorios vinculados. **nota** **Desarrollado por Amazon Bedrock**: AWS implementa la [detección automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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). **Creación de una solicitud de extracción** 1. Vaya a su proyecto. 1. Realice una de las siguientes acciones: + En el panel de navegación, seleccione **Código**, seleccione **Solicitudes de extracción** y seleccione **Crear solicitud de extracción**. + En la página de inicio del repositorio, seleccione **Más** y, después, seleccione **Crear solicitud de extracción**. + En la página del proyecto, seleccione **Crear solicitud de extracción**. 1. En **Repositorio de origen**, asegúrese de que el repositorio de código fuente especificado sea el que contenga el código confirmado. Esta opción solo aparece si no ha creado la solicitud de extracción desde la página principal del repositorio. 1. En **Ramificación de destino**, elija la ramificación en la que quiera combinar el código después de revisarlo. 1. En **Ramificación de origen**, elija la ramificación que contenga el código confirmado. 1. En **Título de la solicitud de extracción**, introduzca un título que ayude a otros usuarios a entender qué es lo que hay que revisar y por qué. 1. (Opcional) En **Descripción de la solicitud de extracción**, proporcione información, como un enlace a las incidencias o una descripción de los cambios. **sugerencia** Puedes elegir **Escribir una descripción para que yo** genere CodeCatalyst automáticamente una descripción de los cambios incluidos en la solicitud de cambios. Puede realizar cambios en la descripción generada automáticamente después de añadirla a la solicitud de extracción. Esta funcionalidad requiere que las características de IA generativa estén habilitadas en el espacio y no estén disponibles para las solicitudes de extracción en los repositorios vinculados. Para obtener más información, consulte [Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. (Opcional) En **Problemas**, seleccione **Vincular problemas** y, a continuación, elija un problema de la lista o introduzca su ID. Para desvincular un problema, seleccione el icono de desvinculación. 1. (Opcional) En **Revisores obligatorios**, seleccione **Agregar revisores obligatorios**. Elija en la lista miembros del proyecto para añadirlos. Los revisores obligatorios deben aprobar los cambios antes de poder combinar la solicitud de extracción en la ramificación de destino. **nota** No es posible agregar un revisor como revisor obligatorio y como revisor opcional. No es posible añadirse a uno mismo como revisor. 1. (Opcional) En **Revisores opcionales**, seleccione **Agregar revisores opcionales**. Elija en la lista miembros del proyecto para añadirlos. No es obligatorio que los revisores opcionales aprueben los cambios para poder combinar la solicitud de extracción en la ramificación de destino. 1. Revise las diferencias entre las ramificaciones. La diferencia que se muestra en una solicitud de extracción consiste en los cambios entre la revisión en la ramificación de origen y la base de combinación, que es la confirmación del encabezado en la ramificación de destino en el momento en que se creó la solicitud de extracción. Si no se muestra ningún cambio, es posible que las ramificaciones sean idénticas o que haya elegido la misma ramificación tanto para el origen como para el destino. 1. Cuando tenga claro que la solicitud de extracción contiene el código y los cambios que desea revisar, elija **Crear**. **nota** Una vez creada la solicitud de extracción, podrá añadir comentarios. Los comentarios se pueden añadir a la solicitud de extracción o a líneas individuales de los archivos, así como a la solicitud de extracción en general. Puede añadir enlaces a recursos, como archivos, utilizando el signo @ seguido del nombre del archivo. **Creación de una solicitud de extracción desde una ramificación** 1. Vaya al proyecto en el que quiera crear una solicitud de extracción. 1. En el panel de navegación, elija **Repositorios de origen** y luego seleccione el repositorio que contenga la ramificación en la que tenga cambios de código que quiera revisar. 1. Seleccione la flecha desplegable junto al nombre predeterminado de la ramificación y elija la ramificación que quiera en la lista. Para ver todas las ramificaciones de un repositorio, seleccione **Ver todo**. 1. Seleccione **Más** y haga clic en **Crear solicitud de extracción**. 1. El repositorio y la ramificación de origen se preseleccionan automáticamente. En **Ramificación de destino**, seleccione la ramificación en la que combinará el código una vez que se haya revisado. En **Título de la solicitud de extracción**, introduzca un título que ayude a otros usuarios del proyecto a entender qué se debe revisar y por qué. También puedes incluir más información en la **descripción de la solicitud de extracción**, por ejemplo, pegando un enlace a temas relacionados o añadiendo una descripción de los cambios que has realizado. CodeCatalyst **nota** Los flujos de trabajo configurados para ejecutarse en eventos de creación de solicitudes de extracción se ejecutarán una vez creada la solicitud de extracción, si la ramificación de destino de la solicitud de extracción coincide con una de las ramificaciones especificadas en el flujo de trabajo. 1. Revise las diferencias entre las ramificaciones. Si no se muestran cambios, es posible que las ramificaciones sean idénticas o que haya elegido la misma ramificación tanto para el origen como para el destino. 1. (Opcional) En **Problemas**, seleccione **Vincular problemas** y, a continuación, elija un problema de la lista o introduzca su ID. Para desvincular un problema, seleccione el icono de desvinculación. 1. (Opcional) En **Revisores obligatorios**, seleccione **Agregar revisores obligatorios**. Elija en la lista miembros del proyecto para añadirlos. Los revisores obligatorios deben aprobar los cambios antes de poder combinar la solicitud de extracción en la ramificación de destino. **nota** No es posible añadir un revisor como obligatorio y opcional a la vez. No es posible añadirse a uno mismo como revisor. 1. (Opcional) En **Revisores opcionales**, seleccione **Agregar revisores opcionales**. Elija en la lista miembros del proyecto para añadirlos. Los revisores opcionales no tienen que aprobar los cambios para poder fusionar la solicitud de extracción en la ramificación de destino. 1. Cuando tenga claro que la solicitud de extracción contiene los cambios que desea revisar e incluye a los revisores obligatorios, elija **Crear**. Si tiene algún flujo de trabajo configurado para que la ramificación coincida con la ramificación de destino en la solicitud de extracción, verá información sobre esas ejecuciones de flujo de trabajo en la **Información general**, en el área de **Detalles de la solicitud de extracción**, una vez creada la solicitud de extracción. Para obtener más información, consulte [Adición de desencadenadores a flujos de trabajo](workflows-add-trigger-add.md). # Visualización de solicitudes de extracción Puedes ver las solicitudes de cambios de un proyecto en la CodeCatalyst consola de Amazon. La página de resumen del proyecto muestra todas las solicitudes de extracción abiertas de un proyecto. Para ver todas las solicitudes de extracción independientemente de su estado, vaya a la página de solicitudes de extracción del proyecto. Al ver una solicitud de extracción, puede optar por que se cree y se le muestre un resumen de todos los comentarios que se hayan dejado sobre los cambios en la solicitud de extracción. **nota** **Desarrollado por Amazon Bedrock**: AWS implementa la [detección automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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). **Visualización de solicitudes de extracción abiertas** 1. Vaya al proyecto en el que quiera visualizar las solicitudes de extracción pendientes. 1. En la página se muestran las solicitudes de extracción abiertas, incluida información sobre quién creó la solicitud de extracción, qué repositorio contiene las ramificaciones de la solicitud de extracción y la fecha en la que se creó la solicitud de extracción. Puede filtrar la vista de solicitudes de extracción abiertas por repositorio de código fuente. 1. Para ver todas las solicitudes de extracción, seleccione **Ver todas**. Puede usar los selectores para elegir entre las opciones. Por ejemplo, para ver todas las solicitudes de extracción, seleccione **Cualquier estado** y **Cualquier autor**. Como alternativa, en el panel de navegación, seleccione **Código** y elija **Solicitudes de extracción**; después, use los selectores para delimitar la visualización. 1. En la página **Solicitudes de extracción**, puede ordenar las solicitudes de extracción por ID, título, estado y otras variables. Para personalizar qué información y cuánta información aparece en la página de solicitudes de extracción, haga clic en el icono de engranaje. 1. Para ver una solicitud de extracción específica, selecciónela en la lista. 1. Para ver el estado de las ejecuciones de flujos de trabajo asociadas a esta solicitud de extracción, si las hay, seleccione **Información general** y revise la información en el área de **Detalles de la solicitud de extracción** en la solicitud de extracción, bajo **Ejecuciones del flujo de trabajo**. Una ejecución de flujo de trabajo solo tiene lugar si el flujo de trabajo está configurado con eventos de creación o revisión de solicitudes de extracción y si los requisitos de la ramificación de destino del flujo de trabajo coinciden con los de la ramificación de destino especificada en la solicitud de extracción. Para obtener más información, consulte [Adición de desencadenadores a flujos de trabajo](workflows-add-trigger-add.md). 1. Para ver los problemas vinculados, si los hay, seleccione **Información general** y revise la información en **Detalles de la solicitud de extracción**, bajo **Problemas**. Si quiere ver un problema vinculado, seleccione su ID en la lista. 1. (Opcional) Para crear un resumen de los comentarios que se hayan dejado sobre los cambios de código en las revisiones de esta solicitud de extracción, seleccione **Crear resumen de contenido**. El resumen no incluirá ningún comentario que se haya dejado en la solicitud de extracción general. **nota** Esta funcionalidad requiere que las características de IA generativa estén habilitadas para el espacio, no está disponible para los repositorios vinculados 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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. Para ver los cambios de código en la solicitud de extracción, seleccione **Cambios**. 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. También puede ver los comentarios que se hayan dejado en líneas de código específicas. **nota** No todos los cambios de una solicitud de extracción se pueden mostrar en la consola. Por ejemplo, no puede ver los submódulos de Git en la consola, por lo que no es posible visualizar las diferencias de un submódulo en una solicitud de extracción. Es posible que algunas diferencias sean demasiado grandes para mostrarlas. Para obtener más información, consulte [Cuotas para los repositorios de fuentes en CodeCatalyst](source-quotas.md) y [Visualización de un archivoVisualización del historial de cambios en un archivo](source-files-view.md). 1. Para ver los informes de calidad de esta solicitud de extracción, seleccione **Informes**. **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 [Pruebas con flujos de trabajoPruebas con flujos de trabajo](test-workflow-actions.md). # Administración de los requisitos para combinar una solicitud de extracción con reglas de aprobación Al crear una solicitud de extracción, puede optar por agregar revisores obligatorios u opcionales a esa solicitud de extracción individual. Sin embargo, también puede crear requisitos que deberán cumplir todas las solicitudes de extracción al combinarse con una ramificación de destino específica. Estos requisitos se denominan reglas de aprobación. Las reglas de aprobación se configuran para las ramificaciones de un repositorio. Al crear una solicitud de extracción cuya ramificación de destino tenga configurada una regla de aprobación, deben cumplirse los requisitos de esa regla, además de las aprobaciones de los revisores necesarios, antes de poder combinar la solicitud de extracción con esa ramificación. La creación de reglas de aprobación puede ayudarle a mantener los estándares de calidad para las combinaciones de ramificaciones, como la ramificación predeterminada. Las reglas de aprobación que se apliquen a la ramificación predeterminada del repositorio de código fuente se comportarán de forma un poco diferente a aquellas reglas de aprobación que se apliquen a otras ramificaciones. Cualquier regla que se aplique a la ramificación predeterminada se aplicará automáticamente a cualquier ramificación que especifique como ramificación predeterminada. La ramificación que se hubiese establecido anteriormente como la ramificación predeterminada conservará las reglas que se le apliquen. Al crear reglas de aprobación, debe tener en cuenta cómo cumplirán esa regla los usuarios del proyecto, tanto en el presente como en el futuro. Por ejemplo, si tiene seis usuarios en un proyecto y crea una regla de aprobación que requiera cinco aprobaciones antes de que se pueda combinar con la ramificación de destino, habrá creado una regla que exigirá que todos, excepto la persona que creó la solicitud de extracción, aprueben esa solicitud de extracción antes de que se pueda combinar. **nota** Debe tener el rol de administrador de proyectos para crear y administrar las reglas de aprobación en CodeCatalyst los proyectos. No puede crear reglas de aprobación para repositorios vinculados. No puede eliminar las reglas de aprobación, pero puede actualizarlas para que no requieran ninguna aprobación, lo que, de hecho, elimina la regla. **Visualización y edición de reglas de aprobación de las ramificaciones de destino para las solicitudes de extracción** 1. Desplácese hasta el proyecto en el que esté su repositorio. 1. Seleccione el nombre del repositorio de la lista de repositorios de código fuente para el proyecto. Como alternativa, en el panel de navegación, elija **Código** y, a continuación, elija **Repositorios de origen**. Elija el repositorio cuyas reglas de aprobación quiera ver. 1. En la página de información general del repositorio, seleccione **Ramificaciones**. 1. En la columna **Reglas de aprobación**, seleccione **Ver** para ver el estado de las reglas de cada ramificación del repositorio. En **Número mínimo de aprobaciones**, el número corresponde al número de aprobaciones necesarias para poder combinar una solicitud de extracción con esa ramificación. 1. Para crear o cambiar una regla de aprobación, seleccione **Administrar configuración**. En la página de configuración del repositorio de código fuente, en **Reglas de aprobación**, seleccione **Editar**. **nota** Debe tener el rol de **Administrador del proyecto** para editar las reglas de aprobación. 1. En **Ramificación**, seleccione en la lista desplegable el nombre de la ramificación para la que quiera configurar una regla de aprobación. En **Número mínimo de aprobaciones**, introduzca un número y, a continuación, elija **Guardar**. # 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. 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** **Desarrollado por Amazon Bedrock**: AWS implementa la [detección automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). 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](notifications-manage.md). 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 fusión en Git, consulta [git-merge-base](https://git-scm.com/docs/git-merge-base)la documentación de Git. **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. **Para revisar una solicitud de cambios en la CodeCatalyst consola** 1. Vaya a su proyecto. 1. 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**. 1. 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. 1. 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**. 1. (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**. 1. (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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 1. 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](source-concepts.md#revision-concept). **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. 1. Para cambiar la forma en que se muestran las diferencias, elija entre **Unificado** y **Dividido**. 1. 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**. 1. 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. 1. 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](test-workflow-actions.md#test-code-coverage-reports). 1. 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**. 1. 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](test-config-action.md). 1. Para ver un informe específico, selecciónelo en la lista. Para obtener más información, consulte [Pruebas con flujos de trabajoPruebas con flujos de trabajo](test-workflow-actions.md). 1. 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. # Actualización de una solicitud de extracción Puede facilitar que otros miembros del proyecto revisen el código actualizando la solicitud de extracción. Puede actualizar una solicitud de extracción para cambiar sus revisores, sus enlaces a problemas, el título de la solicitud de extracción o su descripción. Por ejemplo, es posible que desee cambiar los revisores necesarios para que una solicitud de extracción elimine a una persona que esté de vacaciones y agregue a otra persona en su lugar. También puede actualizar una solicitud de extracción con más cambios de código enviando las confirmaciones a la ramificación de origen de una solicitud de extracción abierta. Cada vez que se envía a la rama de origen de una solicitud de incorporación de datos en el repositorio de CodeCatalyst origen, se crea una revisión. Los miembros del proyecto pueden ver las diferencias entre las revisiones en una solicitud de extracción. **Actualización de los revisores de una solicitud de extracción** 1. Vaya al proyecto en el que quiera actualizar los revisores de una solicitud de extracción. 1. En la página del proyecto, en **Solicitudes de extracción abiertas**, elija la solicitud de extracción para la que quiera actualizar los revisores. Como alternativa, en el panel de navegación, seleccione **Código**, luego **Solicitudes de extracción** y, a continuación, elija la solicitud de extracción que quiera actualizar. 1. (Opcional) En **Información general**, en el área **Detalles de la solicitud de extracción**, seleccione el signo de más para agregar revisores obligatorios u opcionales. Seleccione la **X** situada junto a un revisor para eliminarlo como revisor opcional u obligatorio. 1. (Opcional) En **Información general**, en el área **Detalles de la solicitud de extracción**, seleccione **Vincular problemas** para vincular un problema a la solicitud de extracción y después seleccione un problema de la lista o introduzca su ID. Para desvincular un problema, seleccione el icono de desvinculación situado junto al problema que quiera desvincular. **Actualización de los archivos y el código en la ramificación de origen de una solicitud de extracción** 1. Para actualizar varios archivos, [cree un entorno de desarrollo](devenvironment-create.md) o clone el repositorio y su ramificación de origen y use un cliente de Git o un entorno de desarrollo integrado (IDE) para realizar cambios en los archivos de la ramificación de origen. Confirma y envía los cambios a la rama fuente del repositorio CodeCatalyst fuente para actualizar automáticamente la solicitud de extracción con los cambios. Para obtener más información, consulte [Clonación de un repositorio de código fuente](source-repositories-clone.md) y [Cómo entender los cambios en el código fuente con las confirmaciones en Amazon CodeCatalyst](source-commits.md). 1. Para actualizar un archivo individual en una ramificación de origen, puede usar un cliente de Git o un IDE del modo en que lo haría con varios archivos. También puedes editarlo directamente en la CodeCatalyst consola. Para obtener más información, consulte [Edición de un archivo](source-files-edit.md). **Actualización del título y la descripción de una solicitud de extracción** 1. Vaya al proyecto en el que quiera actualizar el título o la descripción de una solicitud de extracción. 1. La página del proyecto muestra las solicitudes de extracción abiertas, incluida información sobre quién creó la solicitud de extracción, qué repositorio contiene las ramificaciones de la solicitud de extracción y cuándo se creó la solicitud de extracción. Puede filtrar la vista de solicitudes de extracción abiertas por repositorio de código fuente. Elija la solicitud de extracción que quiera cambiar en la lista. 1. Para ver todas las solicitudes de extracción, seleccione **Ver todas**. Como alternativa, en el panel de navegación, seleccione **Código** y después **Solicitudes de extracción**. Utilice el recuadro del filtro o las funciones de clasificación para encontrar la solicitud de extracción que quiera cambiar y selecciónela. 1. En **Información general**, seleccione **Editar**. 1. Cambie el título o la descripción y seleccione **Guardar**. # Combinación de una solicitud de extracción Una vez que hayas revisado tu código y lo hayan aprobado todos los revisores necesarios, puedes fusionar una solicitud de extracción en la CodeCatalyst consola utilizando una estrategia de fusión compatible, como la de acelerar. No todas las estrategias de fusión compatibles con la CodeCatalyst consola están disponibles como opciones para todas las solicitudes de extracción. CodeCatalyst evalúa la fusión y solo permite elegir entre las estrategias de fusión que están disponibles en la consola y que permiten fusionar la rama de origen con la de destino. También puede combinar una solicitud de extracción con las estrategias de combinación de Git que prefiera ejecutando el comando **git merge** en el equipo local o en un entorno de desarrollo para combinar la ramificación de origen con la de destino. A continuación, puede enviar esos cambios de la rama de destino al repositorio de origen. CodeCatalyst **nota** La combinación de las ramificaciones la inserción de los cambios en Git no cierra automáticamente la solicitud de extracción. Si tiene el rol de administrador del proyecto, también puede optar por combinar una solicitud de extracción que aún no cumpla todos los requisitos y las normas de aprobación. ## Combinación de una solicitud de extracción (consola) Puedes fusionar una solicitud de extracción en la CodeCatalyst consola si no hay conflictos de fusión entre las ramas de origen y de destino y si todos los revisores necesarios han aprobado la solicitud de extracción. Si hay conflictos o si la combinación no se puede completar, el botón de combinación estará inactivo y aparecerá la etiqueta **No se puede combinar**. En ese caso, debe obtener la aprobación de los aprobadores necesarios, resolver los conflictos localmente (en su caso) e introducir esos cambios antes de poder realizar la combinación. Al combinar una solicitud de extracción, se enviará automáticamente un correo electrónico al creador de la solicitud de extracción, así como a los revisores necesarios u opcionales. No se cerrará ni cambiará automáticamente el estado de ningún problema relacionado con la solicitud de extracción. **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](notifications-manage.md). **Combinación de una solicitud de extracción** 1. Vaya al proyecto en el que quiera combinar una solicitud de extracción. 1. En la página del proyecto, en **Solicitudes de extracción abiertas**, elija la solicitud de extracción que quiera combinar. Si no ve la solicitud de extracción, seleccione **Ver todas las solicitudes de extracción** y, a continuación, selecciónela de la lista. Como alternativa, en el panel de navegación, seleccione **Código**, luego **Solicitudes de extracción** y, a continuación, elija la solicitud de extracción que quiera combinar. Seleccione **Combinar**. 1. Elija entre las estrategias de combinación disponibles para la solicitud de extracción. Puede seleccionar o deseleccionar la opción para eliminar la ramificación de origen después de combinar la solicitud de extracción; después, seleccione **Combinar**. **nota** Si el botón **Fusionar** está inactivo o si ves la etiqueta **No se puede combinar**, significa que los revisores necesarios aún no han aprobado la solicitud de extracción o la solicitud de extracción no se puede fusionar en la consola. CodeCatalyst Si un revisor no ha aprobado una solicitud de extracción, aparece el icono de un reloj en el área **Detalles de la solicitud de extracción** en la sección **Información general**. Si todos los revisores necesarios han aprobado la solicitud de extracción, pero el botón **Combinar** sigue inactivo, es posible que se esté produciendo un conflicto de combinación. Seleccione la etiqueta subrayada **No se puede combinar** para ver más detalles sobre por qué la solicitud de extracción no se puede combinar. Puedes resolver los conflictos de fusión de la rama de destino en un entorno de desarrollo o en la CodeCatalyst consola y, a continuación, fusionar la solicitud de extracción, o puedes resolver los conflictos y fusionar localmente y, después, enviar la confirmación que contiene la fusión a la rama de origen. CodeCatalyst Para obtener más información, consulte [Combinación de una solicitud de extracción (Git)](#pull-requests-merge-git) y la documentación de Git. ## Anulación de los requisitos de combinación Si tiene el rol de **administrador del proyecto**, puede optar por combinar una solicitud de extracción que aún no cumpla todas las aprobaciones necesarias y las normas de aprobación. A esto se le denomina anulación de los requisitos de una solicitud de extracción. Puede decidir hacerlo si uno de los revisores necesarios no está disponible o si surge la necesidad urgente de combinar una solicitud de extracción específica en una ramificación que tenga reglas de aprobación que no se puedan cumplir rápidamente. **Combinación de una solicitud de extracción** 1. En la solicitud de extracción para la que quiera anular los requisitos y llevar a cabo la combinación, seleccione la flecha desplegable situada junto al botón **Combinar**. Seleccione **Anular requisitos de aprobación**. 1. En **Motivo de anulación**, proporcione detalles sobre por qué está combinando esta solicitud de extracción sin cumplir las normas de aprobación ni los requisitos de revisores requeridos. Este paso es opcional, pero muy recomendable. 1. Puede elegir una estrategia de combinación o aceptar la predeterminada. También puede decidirse por actualizar el mensaje de confirmación generado automáticamente con más detalles. 1. Seleccione o deseleccione la opción para eliminar la ramificación de origen al realizar la combinación. Recomendamos que mantenga la ramificación de origen a la hora de anular los requisitos para combinar una solicitud de extracción hasta que haya tenido la oportunidad de revisar la decisión con otros miembros del equipo. 1. Seleccione **Combinar**. ## Combinación de una solicitud de extracción (Git) Git admite muchas opciones para combinar y administrar ramificaciones. Los siguientes comandos son algunas de las opciones que puede utilizar. Para obtener más información, consulte la documentación disponible en el [sitio web de Git](https://git-scm.com/doc). Una vez que haya combinado y enviado los cambios, cierre manualmente la solicitud de extracción. Para obtener más información, consulte [Cierre de una solicitud de extracción](pull-requests-close.md). **Comandos comunes de Git para combinar ramificaciones** | | | | --- |--- | | Combina los cambios de la ramificación de origen en el repositorio local con la ramificación de destino en el repositorio local. | `git checkout destination-branch-name` `git merge source-branch-name` | | Combina la ramificación de origen con la de destino, especificando una combinación de avance rápido. Esto combina las ramificaciones y traslada el puntero de la ramificación de destino al extremo de la ramificación de origen. | `git checkout destination-branch-name` `git merge --ff-only source-branch-name` | | Combina la ramificación de origen con la de destino, especificando una combinación de compactar. Esto combina todas las confirmaciones de la ramificación de origen en una sola confirmación de combinación en la ramificación de destino. | `git checkout destination-branch-name` `git merge --squash source-branch-name` | | Combina la ramificación de origen con la de destino, especificando una combinación de tres vías. Esto crea una confirmación de combinación y agrega las confirmaciones individuales de la ramificación de origen a la ramificación de destino. | `git checkout destination-branch-name` `git merge --no-ff source-branch-name` | | Elimina la ramificación de origen del repositorio local. Esto resulta útil para limpiar un repositorio local después de combinarlo con la ramificación de destino y enviar los cambios al repositorio de código fuente. | `git branch -d source-branch-name` | | Elimina la rama de origen del repositorio remoto (en el repositorio de origen CodeCatalyst) utilizando el apodo especificado por el repositorio local para el repositorio remoto. (Observe el uso de los dos puntos (`:`)). También puede especificar `--delete` como parte del comando. | `git push remote-name :source-branch-name` `git push remote-name --delete source-branch-name` | # Cierre de una solicitud de extracción Puede marcar una solicitud de extracción como **Cerrada**. Esto no combina la solicitud de extracción, pero puede ayudarle a determinar qué solicitudes de extracción requieren una acción y qué solicitudes de extracción ya no son relevantes. Le recomendamos cerrar una solicitud de extracción si ya no tiene previsto combinar esos cambios o si los ha combinado con otra solicitud de extracción. Al cerrar una solicitud de extracción, se enviará automáticamente un correo electrónico al creador de la solicitud de extracción, así como a los revisores necesarios u opcionales. No se cambiará automáticamente el estado de ningún problema relacionado con la solicitud de extracción. **nota** No puede volver a abrir una solicitud de extracción después de haberla cerrado. **Cierre de una solicitud de extracción** 1. Vaya al proyecto en el que quiera cerrar una solicitud de extracción. 1. En la página del proyecto, se muestran las solicitudes de extracción abiertas. Elija la solicitud de extracción que quiera cerrar. 1. Seleccione **Cerrar**. 1. Revise la información y seleccione **Cerrar la solicitud de extracción**.