Completar, abandonar o revertir solicitudes de extracción

Para ver todas las directivas de rama que están en vigor para una pr, use az repos pr policy list con el parámetro requerido.

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Parámetros

Ejemplo

Por ejemplo, para ver las directivas en vigor en la SOLICITUD n.º 28, ejecute el siguiente comando:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

1. Seleccione Completar en la esquina superior derecha para completar la pr. O bien, seleccione la flecha desplegable situada junto al botón Completar y seleccione una de las opciones.

   

   • Complete: complete la pr ahora y combine los cambios en la rama de destino.
   • Establecer autocompletar:configure la pr. para que se complete y combine una vez que cumpla todas las directivas de rama necesarias.
   • Marcar como borrador:devuelve la pr. al estado de borrador y quita todos los votos.
   • Abandonar:cierre la pr. sin combinar los cambios.

2. En el panel Completar solicitud de extracción, en Tipo de mezcla,seleccione una de las opciones de combinación.

   

   • Combinar (sin avance rápido):combine con un historial no lineal que conserve todas las confirmaciones.
   • Confirmación de squash:combine con un historial lineal que combine todas las confirmaciones de origen en una sola confirmación en el destino, o bien combine la pr.
   • Rebase y avance rápido:vuelva a base la confirmación de origen en el destino y avance rápido.
   • Combinación semi lineal:el origen de rebase se confirma en el destino y crea una combinación de dos elementos primarios.

   Nota

   Se aplican las directivas existentes. Por ejemplo, si la rama tiene actualmente una directiva de "solo combinación de squash", tendrá que cambiar esa directiva si desea usar otro tipo de combinación.

3. Seleccione cualquiera de las siguientes opciones posteriores a la finalización. Algunas opciones no están disponibles para algunos tipos de combinación.

   • Completar los elementos de trabajo asociados después de combinar:complete los elementos de trabajo vinculados.
   • Eliminar nombre de rama después > de combinar:elimine la rama de origen de la PR después de la combinación.
   • Personalizar mensaje de confirmación de combinación:agregue un mensaje de confirmación de combinación personalizado. Si selecciona esta opción, actualice el mensaje de confirmación de combinación.
   • Invalide las directivas de rama y habilite la combinación. Fuerce la combinación incluso si la pr. no satisface todas las directivas de rama. Esta opción solo está disponible si tiene el permiso Exento del cumplimiento de directivas.

4. Seleccione Completar combinación.

1. Seleccione Completar en la esquina superior derecha para completar la PR. O bien, seleccione la flecha desplegable situada junto al botón Completar y seleccione una de las siguientes opciones:

   

   • Complete: complete la pr. ahora y combine los cambios en la rama de destino.
   • Establecer autocompletar:si tiene directivas de rama, configure la PR para que se complete y combine una vez que cumpla todas las directivas de rama necesarias.
   • Abandonar:cierre la pr. sin combinar los cambios.

2. En la pantalla Completar solicitud de extracción, escriba el mensaje para la confirmación de combinación y actualice la descripción de la solicitud de cambio.

   

3. Seleccione cualquiera de las siguientes opciones:

   • Complete los elementos de trabajo vinculados después de combinarlos para completar los elementos de trabajo vinculados.

   • Elimine después de combinar para eliminar la rama de origen de la pr.

   • La squash cambia al combinar para combinar la PR.

   • Invalide las directivas de rama y habilite la combinación para forzar la combinación de una rama, incluso si no satisface todas las directivas de rama. Esta opción solo está disponible si tiene permisos exentos de cumplimiento de directivas.

     Nota

     Las directivas existentes se siguen aplicando. Por ejemplo, si la rama tiene actualmente una directiva de "solo combinación de squash" en su lugar, tendrá que editar esa directiva para usar los otros tipos de combinación.

4. Seleccione Completar combinación.

Al completar la combinación, los elementos de trabajo vinculados se actualizan automáticamente para mostrar la finalización de la pr.

1. Seleccione Completar en la esquina superior derecha de la vista de pr. para completar la solicitud de cambio después de que los revisores aprueben los cambios.

   

   • Complete: complete la pr. ahora y combine los cambios en la rama de destino.
   • Establecer autocompletar:si tiene directivas de rama, puede elegir Establecer autocompletar para configurar la PR para cerrarla una vez que cumpla todas las directivas de rama.
   • Abandonar:cierre la pr. sin combinar los cambios.

2. En Completar solicitud de extracción,escriba el mensaje para la confirmación de combinación y actualice la descripción de la solicitud de cambio.

   

3. Seleccione cualquiera de las siguientes opciones posteriores a la finalización:

   • Complete los elementos de trabajo vinculados después de combinarlos para completar los elementos de trabajo vinculados.
   • Elimine después de combinar para eliminar la rama de origen de la pr.
   • La squash cambia al combinar para combinar la PR.
   • Invalide las directivas de rama y habilite la combinación para forzar la combinación de una rama, incluso si no satisface todas las directivas de rama. Esta opción solo está disponible si tiene permisos exentos de cumplimiento de directivas.

4. Seleccione Completar combinación.

Los elementos de trabajo vinculados también se actualizan mostrando la finalización de la pr.

Para completar una PR y combinar los cambios, use az repos pr update para actualizar la pr a completed .

Por ejemplo, para completar la PR 21, use:

az repos pr update --id 21 --status completed

Establecer opciones de finalización

Puede establecer opciones de finalización de pr al crear una pr con o actualizar las opciones de creación en las PR existentes con az repos pr update .

Las opciones de finalización de la PR incluyen:

• bypass-policy {false, true}: si se omiten las directivas necesarias y se completa la solicitud de extracción una vez que se puede combinar.
• bypass-policy-reason: motivo para omitir las directivas necesarias.
• delete-source-branch {false, true}: si desea eliminar la rama de origen una vez completada y combinada la solicitud de extracción.
• merge-commit-message: personalice el mensaje de confirmación de combinación.
• squash {false, true}: si se deben convertir las confirmaciones de origen en una confirmación de destino única para la combinación.
• transition-work-items {false, true}: si se resuelven los elementos de trabajo vinculados cuando se combina la pr.

Para establecer las opciones de finalización y completar una pr. existente, use az repos pr update con el parámetro id requerido.

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parámetros

Ejemplo

En el ejemplo siguiente se completa la pr. 21, se elimina su rama de origen, se resuelven sus elementos de trabajo vinculados y se agrega un mensaje de confirmación de combinación:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Seleccione Establecer autocompletar en la lista desplegable Completar para completar y combinar los cambios de la pr. en cuanto las condiciones cumplan todas las directivas de rama. Una vez completada la solicitud de inserción, recibirá una notificación por correo electrónico. Si un conflicto o error impide la finalización de la solicitud de registro, el correo electrónico le notifica el problema.

De forma predeterminada, una pr. establecida en autocompletar espera solo en las directivas necesarias. En el panel Habilitar finalización automática, también puede esperar a directivas opcionales.

A partir de TFS 2018 Update 2, la página Información general de la pr muestra la lista de criterios de directiva pendientes que está esperando la pr. Si establece una directiva para que sea necesaria en el panel Habilitar finalización automática, puede volver a establecerla en opcional en la página Información general.

Seleccione Cancelar autocompletar para desactivar la función autocompletar.

Establezca autocompletar para completar automáticamente una solicitud de inserción de solicitudes cuando pase todas las aprobaciones y directivas de rama necesarias. Puede establecer autocompletar en la creación de la pr o actualizar una PR existente.

• Para establecer autocompletar en la creación de la PR, use az repos pr create --auto-complete true .
• Para actualizar una PR existente para que se autocompletar, use az repos pr update --id <PR Id> --auto-complete true .

Para abandonar una pr sin combinar los cambios, use az repos pr update --id <PR Id> –-status abandoned . Puede reactivar la PR estableciendo el estado en active .