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, puedes crear una solicitud de extracción que compare el contenido de la rama de origen con el contenido de la rama 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 rama específica, se proporciona automáticamente el nombre del repositorio y la rama de origen en la página de creación de la solicitud de extracción. Cuando crees una solicitud de extracción, recibirás automáticamente correos electrónicos sobre cualquier actualización de la solicitud de extracción, así como cuando la solicitud de extracción se fusione o cierre.
nota
Al crear una solicitud de extracción, la diferencia que se muestra es la diferencia entre la punta de la rama de origen y la punta de la sucursal de destino. Una vez creada la solicitud de extracción, la diferencia que se mostrará será entre la revisión de la solicitud de extracción que hayas elegido y la confirmación que estaba en la punta de la sucursal de destino cuando creaste 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
Puedes usar la función Escribe una descripción para mí 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 rama de origen que contiene los cambios de código y la rama de destino en la que desea 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 del oeste de EE. UU. (Oregón) para las CodeCatalyst solicitudes de cambios. La función Escribe una descripción para mí no está disponible para las solicitudes de extracción en los repositorios enlazados.
nota
nota
Desarrollado por Amazon Bedrock: AWS implementa la detección automática de abusos. Como las funciones Escribir una descripción, Crear un resumen de contenido, Recomendar tareas, Utilizar Amazon Q para crear o añadir funciones a un proyecto y Asignar problemas a Amazon Q con Amazon Q Developer Agent para las funciones de desarrollo de software 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).
Para crear una solicitud de extracción
-
Vaya a su proyecto.
-
Realice una de las siguientes acciones siguientes:
-
En el panel de navegación, selecciona Código, selecciona Solicitudes de extracción y, a continuación, selecciona Crear solicitud de extracción.
-
En la página de inicio del repositorio, selecciona Más y, a continuación, selecciona Crear solicitud de extracción.
-
En la página del proyecto, selecciona Crear solicitud de extracción.
-
-
En el repositorio de fuentes, asegúrate de que el repositorio de fuentes especificado es el que contiene el código confirmado. Esta opción solo aparece si no creaste la solicitud de extracción desde la página principal del repositorio.
-
En la rama de destino, elige la rama en la que deseas combinar el código después de revisarlo.
-
En la rama Fuente, elige la rama que contiene el código confirmado.
-
En el título de la solicitud de extracción, introduce un título que ayude a otros usuarios a entender qué es lo que hay que revisar y por qué.
-
(Opcional) En la descripción de la solicitud de retirada, proporciona información como un enlace a los problemas o una descripción de tus 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. Puedes 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 funciones de IA generativa estén habilitadas en el espacio y no estén disponibles para las solicitudes de extracción en los repositorios enlazados. Para obtener más información, consulta Administrar las funciones de IA generativa.
-
(Opcional) En Problemas, selecciona Vincular problemas y, a continuación, elige un problema de la lista o introduce su ID. Para desvincular una incidencia, selecciona el icono de desvinculación.
-
(Opcional) En Revisores obligatorios, selecciona Agregar revisores obligatorios. Elija de la lista de miembros del proyecto para añadirlos. Los revisores necesarios deben aprobar los cambios antes de poder fusionar la solicitud de extracción en la sucursal de destino.
nota
No puedes añadir un revisor como revisor obligatorio y como revisor opcional. No puedes añadirte a ti mismo como revisor.
-
(Opcional) En Revisores opcionales, selecciona Añadir revisores opcionales. Elija de la lista de miembros del proyecto para añadirlos. Los revisores opcionales no tienen que aprobar los cambios como requisito para poder fusionar la solicitud de extracción en la sucursal de destino.
-
Revisa las diferencias entre las sucursales. La diferencia que se muestra en una solicitud de extracción son los cambios entre la revisión en la rama de origen y la base de fusión, que es la confirmación principal de la rama 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 ramas sean idénticas o que hayas elegido la misma rama tanto para el origen como para el destino.
-
Cuando estés seguro de que la solicitud de extracción contiene el código y los cambios que deseas revisar, selecciona Crear.
nota
Después de crear la solicitud de extracción, puedes 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. Puedes añadir enlaces a recursos, como archivos, utilizando el signo @ seguido del nombre del archivo.
Para crear una solicitud de extracción desde una sucursal
-
Navega hasta el proyecto en el que deseas crear una solicitud de extracción.
-
En el panel de navegación, selecciona Repositorios de origen y, a continuación, elige el repositorio que contiene la rama en la que deseas revisar los cambios de código.
-
Seleccione la flecha desplegable situada junto al nombre de la rama predeterminada y, a continuación, elija la rama que desee de la lista. Para ver todas las ramas de un repositorio, selecciona Ver todas.
-
Selecciona Más y, a continuación, selecciona Crear solicitud de extracción.
-
El repositorio y la rama de origen se preseleccionan automáticamente. En la rama de destino, elige la rama en la que combinarás el código una vez que se haya revisado. En el título de la solicitud de extracción, introduce un título que ayude a otros usuarios del proyecto a entender qué es lo que hay que revisar y por qué. Si lo deseas, puedes incluir más información en la descripción de la solicitud de extracción, por ejemplo CodeCatalyst, pegando un enlace a temas relacionados o añadiendo una descripción de los cambios que has realizado.
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 rama de destino de la solicitud de extracción coincide con una de las ramas especificadas en el flujo de trabajo.
-
Revisa las diferencias entre las sucursales. Si no se muestran cambios, es posible que las sucursales sean idénticas o que haya elegido la misma sucursal tanto para el origen como para el destino.
-
(Opcional) En Problemas, selecciona Vincular problemas y, a continuación, selecciona un problema de la lista o introduce su ID. Para desvincular una incidencia, selecciona el icono de desvinculación.
-
(Opcional) En Revisores obligatorios, selecciona Agregar revisores obligatorios. Elija de la lista de miembros del proyecto para añadirlos. Los revisores necesarios deben aprobar los cambios antes de poder fusionar la solicitud de extracción en la sucursal de destino.
nota
No puedes añadir un revisor, ya que es obligatorio y opcional. No puedes añadirte a ti mismo como revisor.
-
(Opcional) En Revisores opcionales, selecciona Añadir revisores opcionales. Elija de la lista de miembros del proyecto para añadirlos. Los revisores opcionales no tienen que aprobar los cambios antes de poder fusionar la solicitud de extracción en la sucursal de destino.
-
Cuando estés seguro de que la solicitud de extracción contiene los cambios que deseas revisar e incluye a los revisores necesarios, selecciona Crear.
Si tienes algún flujo de trabajo configurado para que la sucursal coincida con la sucursal de destino en la solicitud de extracción, verás información sobre esas ejecuciones de flujo de trabajo en la descripció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 Añadir activadores a los flujos de trabajo.