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.
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
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
nota
Desarrollado por 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).
Creación de una solicitud de extracción
-
Vaya a su proyecto.
-
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.
-
-
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.
-
En Ramificación de destino, elija la ramificación en la que quiera combinar el código después de revisarlo.
-
En Ramificación de origen, elija la ramificación que contenga el código confirmado.
-
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é.
-
(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.
-
(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.
-
(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.
-
(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.
-
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.
-
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
-
Vaya al proyecto en el que quiera crear una solicitud de extracción.
-
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.
-
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.
-
Seleccione Más y haga clic en Crear solicitud de extracción.
-
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.
-
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.
-
(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.
-
(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.
-
(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.
-
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.
