Trabajo con solicitudes de extracción en repositorios de AWS CodeCommit

Una solicitud de extracción es la forma principal de que usted y otros usuarios de un repositorio puedan revisar, realizar comentarios y combinar los cambios en el código de una ramificación a otra. 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. A continuación se describe un posible flujo de trabajo para una solicitud de extracción:

Li Juan es una desarrolladora que trabaja en un repositorio denominado MyDemoRepo, y desea trabajar en una nueva característica para la próxima versión de un producto. Para separar su trabajo del código listo para producción, crea una ramificación distinta de la ramificación predeterminada y le asigna el nombre feature-randomizationfeature. Escribe el código, realiza confirmaciones y envía el código de las nuevas características a esta ramificación. Quiere que otros usuarios del repositorio revisen la calidad del código antes de combinar sus cambios en la ramificación predeterminada. Para ello, crea una solicitud de extracción. La solicitud de extracción contiene la comparación entre la ramificación de trabajo y la ramificación del código donde desea combinar sus cambios (en este caso, la ramificación predeterminada). También puede crear una regla de aprobación que requiera un número específico de usuarios para aprobar su solicitud de extracción. Incluso puede especificar un grupo de usuarios de aprobación. Otros usuarios revisan el código y los cambios, y añaden comentarios y sugerencias. Podría actualizar la ramificación de trabajo varias veces con cambios en el código en respuesta a los comentarios realizados. Sus cambios se incorporan en la solicitud de extracción cada vez que los envía a dicha ramificación en CodeCommit. También podría incorporar los cambios realizados en la ramificación de destino prevista mientras esté abierta la solicitud de extracción para que los usuarios puedan estar seguros de que están revisando todos los cambios propuestos en el contexto adecuado. Cuando ella y sus revisores están satisfechos, y las condiciones para las reglas de aprobación (si las hay) se han cumplido, ella o uno de sus revisores combinan su código y cierra la solicitud de extracción.

Las solicitudes de extracción requieren dos ramificaciones: 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. La elección de estrategia de combinación afecta a los detalles de cómo se combinan las confirmaciones entre las ramificaciones de origen y de destino en la consola de CodeCommit. Para obtener más información acerca de las estrategias de combinación en CodeCommit, consulte Combinación de una solicitud de extracción (consola).

La solicitud de extracción muestra las diferencias que existen entre el extremo de la ramificación de origen y la última confirmación de la ramificación de destino cuando se va a crear la solicitud de extracción, lo que permite a los usuarios ver y realizar comentarios sobre los cambios. Puede actualizar la solicitud de extracción en respuesta a los comentarios realizados, mediante la confirmación y el envío de estos cambios a la ramificación de origen.

Cuando se haya revisado el código y se hayan cumplido los requisitos de la regla de aprobación (si los hay), puede cerrar la solicitud de extracción de una de las siguientes maneras:

Antes de crear una solicitud de extracción:

Las solicitudes de extracción son más efectivas cuando se han configurado usuarios de IAM para los usuarios del repositorio en la cuenta de Amazon Web Services. Es más fácil identificar qué usuario ha hecho cada comentario. La otra ventaja es que los usuarios de IAM pueden usar las credenciales de Git para acceder al repositorio. Para obtener más información, consulte Paso 1: Configuración inicial para CodeCommit. Puede utilizar las solicitudes de extracción con otros tipos de usuario, incluidos los usuarios con acceso federado.

Para obtener información acerca de cómo trabajar con otros aspectos del repositorio en CodeCommit, consulte Trabajar con repositorios, Trabajar con plantillas de reglas de aprobación, Trabajar con archivos, Uso de confirmaciones, Uso de las ramificaciones y Trabajo con las preferencias del usuario.