Crear solicitudes de incorporación de cambios

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Cree solicitudes de incorporación de cambios (PR) para cambiar, revisar y combinar código en un repositorio de Git. Puede crear solicitudes de incorporación de cambios a partir de ramas en el repositorio ascendente o desde ramas de la bifurcación del repositorio. El equipo puede revisar las solicitudes de incorporación de cambios y enviar comentarios sobre los cambios. Los revisores pueden examinar los cambios propuestos, dejar comentarios y votar para aprobar o rechazar las solicitudes de incorporación de cambios. Según las directivas de rama y otros requisitos, es posible que la PR deba cumplir varios criterios para poder completar la PR y fusionar los cambios mediante combinación en la rama de destino.

Para obtener instrucciones y consideraciones de administración de las solicitudes de incorporación de cambios, consulte Acerca de las solicitudes de incorporación de cambios.

Requisitos previos

  • Repos debe estar habilitado en el proyecto. Si el centro de Repos y las páginas asociadas no se muestran, vea Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.

  • Para ver o revisar solicitudes de incorporación de cambios, debe ser miembro de un proyecto de Azure DevOps con acceso Básico o superior.

  • Para contribuir a una PR, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes.

  • Para crear y completar una PR, debe ser miembro del grupo de seguridad Colaboradores o tener los permisos correspondientes.

    Nota:

    En el caso de los proyectos públicos, los usuarios con acceso de parte interesada tienen acceso total a Azure Repos.

  • Repos debe estar habilitado en el proyecto. Si el centro de Repos y las páginas asociadas no se muestran, vea Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.
  • Para ver o revisar solicitudes de incorporación de cambios, debe ser miembro del proyecto de Azure DevOps con acceso Básico o superior. Si no es miembro del proyecto, agréguese.
  • Para crear y completar una PR, debe ser miembro del grupo de seguridad Colaboradores o tener los permisos correspondientes, en el proyecto que quiera cambiar.
  • Para contribuir a una PR, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes.

Creación de una solicitud de incorporación de cambios

Puede crear una PR desde el sitio web del proyecto de Azure DevOps, desde Visual Studio o desde la CLI de Azure DevOps.

En el sitio web del proyecto de Azure DevOps, puede crear una PR desde lo siguiente:

Creación de una PR desde la página Solicitudes de incorporación de cambios

Puede crear PR para cualquier rama desde la página Solicitudes de incorporación de cambios del proyecto en la Web.

  1. En la página Repos>Solicitudes de incorporación de cambios, seleccione Nueva solicitud de incorporación de cambios en la esquina superior derecha.

    Captura de pantalla del botón Nueva solicitud de incorporación de cambios.

  2. Seleccione la rama con los cambios y la rama en la que quiere fusionar los cambios mediante combinación, como la rama principal.

    Captura de pantalla de las ramas de origen y destino de una PR en Azure Repos.

  3. Escriba los detalles de su PR y créela.

Creación de una PR desde una rama insertada

Después de insertar o actualizar una rama de características, Azure Repos muestra un mensaje para crear una PR.

  • En la página Solicitudes de incorporación de cambios:

    Captura de pantalla que muestra el mensaje para crear una PR en la pestaña Solicitudes de incorporación de cambios en Azure Repos.

  • En la página Archivos:

    Captura de pantalla que muestra el mensaje para crear una PR en la pestaña Archivos en Azure Repos.

Seleccione Crear una solicitud de incorporación de cambios para ir a una página donde puede introducir los detalles de su PR y crearla.

Creación de una PR a partir de un elemento de trabajo vinculado

Puede crear una PR directamente desde un elemento de trabajo de Azure Boards vinculado a la rama.

  1. En Azure Boards, desde Trabajos pendientes o Consultas en la vista Trabajo, abra un elemento de trabajo vinculado a la rama.

  2. En el área Desarrollo del elemento de trabajo, seleccione Crear una solicitud de incorporación de cambios.

    Captura de pantalla de la creación de una solicitud de incorporación de cambios desde el área Desarrollo de un elemento de trabajo con una rama vinculada.

El vínculo le lleva a una página donde puede introducir los detalles de su PR y crearla.

Incorporación de actualizaciones mediante la selección exclusiva

Puede copiar confirmaciones de una rama a otra mediante la selección exclusiva. A diferencia de una fusión mediante combinación o una fusión mediante cambio de base, la selección exclusiva solo aporta los cambios de las confirmaciones que selecciona, en lugar de todos los cambios de una rama.

Para aplicar la selección exclusiva a los cambios de una PR completada, seleccione Selección exclusiva en la página Información general de la PR. Para copiar los cambios de una PR activa, seleccione Selección exclusiva en el menú Más opciones de la PR. Esta acción crea una nueva rama con los cambios copiados. Después puede crear una PR desde la nueva rama. Para obtener instrucciones detalladas, consulte Copia de cambios con selección exclusiva.

Cambio de las ramas de origen y destino de la PR

Antes de guardar una PR por primera vez, puede cambiar sus ramas de origen y destino; para ello, seleccione el icono Cambiar ramas de origen y destino junto a los nombres de rama. Una vez está activa la PR, este icono desaparece, pero todavía puede cambiar la rama de destino de la PR.

Captura de pantalla del icono Cambiar ramas de origen y destino.

Uso de plantillas de PR

Una plantilla de PR es un archivo que contiene texto de Markdown que rellena la descripción de una PR al crearla. Una buena descripción de PR indica a los revisores de la PR qué pueden esperar y ayudar a realizar un seguimiento de las tareas, como agregar pruebas unitarias y actualizar documentación. El equipo puede crear una plantilla de PR predeterminada que agregue texto a todas las descripciones de las nuevas PR del repositorio. Además, puede seleccionar plantillas específicas de la rama u otras plantillas que el equipo defina. Para obtener más información sobre cómo crear y usar plantillas de PR, vea Mejora de las descripciones de las solicitudes de incorporación de cambios mediante plantillas.

Si el repositorio tiene una plantilla predeterminada, todas las nuevas solicitudes de incorporación de cambios de ese repositorio incluyen la descripción de la plantilla predeterminada. Para agregar otras plantillas, seleccione Agregar una plantilla y elija una plantilla de la lista desplegable. Puede editar el texto de descripción de la plantilla, quitarlo o agregar otro texto.

Captura de pantalla que muestra la opción Agregar una plantilla al crear una PR.

Creación de borradores de solicitudes de incorporación de cambios

Si la PR no está lista para su revisión, puede crear un borrador de la PR para indicar que se está trabajando en ella. Cuando la PR esté lista para su revisión, puede publicarla y comenzar o reanudar el proceso de revisión completa.

Los borradores de solicitudes de incorporación de cambios se diferencian de las solicitudes de incorporación de cambios publicadas en lo siguiente:

  • Las directivas de validación de compilación no se ejecutan automáticamente. Puede poner en cola validaciones de compilación manualmente seleccionando el menú Más opciones en la PR.

  • La votación está deshabilitada en el modo borrador.

  • Los revisores obligatorios no se agregan automáticamente. Las notificaciones solo se envían a los revisores que agrega explícitamente al borrador de la PR.

  • Los borradores de solicitudes de incorporación de cambios se muestran en la lista de solicitudes de incorporación de cambios con el distintivo Borrador.

    Captura de pantalla que muestra un borrador de PR en la lista de PR.

Nota:

La creación de borradores de solicitudes de incorporación de cambios requiere la versión 2019.1 de Azure DevOps Server o una versión posterior.

Para crear un borrador de PR, seleccione la flecha situada junto a Crear y después Crear como borrador al crear la PR. No es necesario usar prefijos de título como WIP o DO NOT MERGE.

Captura de pantalla que muestra la opción Crear como borrador para una PR.

Cuando esté listo para revisar y completar la PR, seleccione Publicar en la esquina superior derecha de la PR. La publicación de una PR asigna los revisores obligatorios, evalúa las directivas e inicia la votación.

Captura de pantalla que muestra la opción Publicar para una PR.

Para cambiar una PR publicada existente a un borrador, elija Marcar como borrador. Al marcar una PR como borrador, se quitan todos los votos existentes.

Captura de pantalla que muestra la opción Marcar como borrador.

Incorporación o edición del título y la descripción de una PR

En la página Nueva solicitud de incorporación de cambios, escriba un título y una descripción detallada de los cambios para que otros usuarios puedan ver qué problemas solucionan. En las solicitudes de incorporación de cambios nuevas y existentes, puede ver los archivos y las confirmaciones de la PR en pestañas independientes. Puede agregar revisores, vincular elementos de trabajo y agregar etiquetas a la PR.

Cuando esté a punto para revisar los cambios, seleccione Crear para crear la PR.

Captura de pantalla que muestra la creación de una nueva PR.

Incorporación de detalles a una nueva PR.

No se preocupe si no tiene todos los elementos de trabajo, revisores o detalles listos al crear la PR. Puede agregar o actualizar estos elementos después de crearla.

Edición del título y la descripción de la PR

Mantenga actualizado el título y la descripción de la PR para que los revisores puedan comprender los cambios realizados en ella.

Para actualizar el título de una PR existente, seleccione el título actual y cambie el texto. Seleccione el icono Guardar para guardar los cambios o el icono Deshacer para descartarlos.

Para editar la descripción de la PR, seleccione el icono Editar en la sección Descripción.

Captura de pantalla que muestra cómo editar el título de la PR y seleccionar el botón Editar de la descripción.

Incorporación de revisores a una PR

Puede agregar revisores en la sección Revisores de una PR nueva o existente. También puede hacer que los revisores opcionales existentes pasen a ser obligatorios, o bien cambiar los revisores obligatorios a opcionales o quitarlos, a menos que los requiera la directiva.

Las directivas de rama pueden requerir un número mínimo de revisores o incluir automáticamente determinados revisores opcionales u obligatorios en las solicitudes de incorporación de cambios. No se pueden quitar los revisores requeridos por la directiva de rama. Pero sí puede cambiar los revisores opcionales de la directiva de rama para que sean obligatorios o quitarlos.

Para ver la directiva de rama que ha agregado automáticamente a un revisor, en la sección Revisores de la página Información general de la PR, haga clic con el botón secundario en Más opciones junto al revisor.

Captura de pantalla que muestra la opción Ver directiva en un revisor que ha incluido automáticamente la directiva de rama.

Si el usuario o grupo que quiere que revise la PR no son miembros del proyecto, debe agregarlos al proyecto para poder asignarlos como revisores.

Para agregar revisores a una nueva PR:

  1. En la página Nueva solicitud de incorporación de cambios, en Revisores, seleccione Buscar usuarios y grupos para agregar como revisores.
  2. A medida que escriba un nombre o una dirección de correo electrónico, una lista desplegable mostrará los usuarios y grupos coincidentes. Seleccione los nombres de la lista para agregarlos como revisores opcionales.
  3. Para agregar revisores obligatorios, seleccione Agregar revisores necesarios y, después, elija Buscar para agregar revisores obligatorios para buscar y seleccionar los nombres.

Captura de pantalla de la incorporación de un revisor a una nueva PR.

Para agregar revisores a una PR existente:

  1. En la sección Revisores de la página Información general, seleccione Agregar y, después, Revisor obligatorio o Revisor opcional.

    información general de la PR

  2. A medida que escriba un nombre o una dirección de correo electrónico, se mostrará una lista de usuarios y grupos coincidentes. Seleccione los nombres que quiere agregar como revisores.

    Incorporación de revisores a la PR.

Para cambiar un revisor de obligatorio a opcional (y viceversa) o quitarlo, seleccione Más opciones a la derecha del nombre del revisor. Para ver la pertenencia de un grupo o equipo designado como revisor, seleccione el icono del grupo.

Para vincular elementos de trabajo a una nueva PR:

  1. En la página Nueva solicitud de incorporación de cambios, en Elementos de trabajo para vincular, seleccione Buscar elementos de trabajo por id. o título.
  2. Comience a escribir un título o un id. de elemento de trabajo y seleccione el elemento de trabajo que quiera vincular en la lista desplegable que aparece. Si busca por título, se devolverán elementos de trabajo filtrados por estado; se excluyen todos los elementos de trabajo con estados que tengan asociadas las categorías de estado Completado y Eliminado. Estos elementos de trabajo también se filtran por fecha y usuario, con solo los elementos creados o modificados en los últimos 30 días indicados, y los debe crear, asignar o autorizar el usuario actual.

Para vincular elementos de trabajo a una PR existente:

  1. En la pestaña Información general de la PR, en el área Elementos de trabajo, seleccione +.

    Captura de pantalla que muestra la selección de la pestaña Información general y la sección Elementos de trabajo.

  2. Escriba el identificador del elemento de trabajo o busque el título del elemento de trabajo. Seleccione el elemento de trabajo deseado en la lista que aparece.

Para quitar un vínculo de elemento de trabajo, seleccione el icono x situado junto al elemento de trabajo. Al quitar un vínculo, solo se quita el vínculo entre el elemento de trabajo y la PR. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

Para vincular elementos de trabajo a la PR:

  1. Seleccione la pestaña Información general en la PR.

    Captura de pantalla que muestra la selección de la pestaña Información general y el botón para vincular elementos de trabajo.

  2. Seleccione el botón para agregar en el área Elementos de trabajo. Icono para agregar en las solicitudes de incorporación de cambios

  3. Escriba el identificador del elemento de trabajo o busque elementos de trabajo cuyos títulos coincidan con su texto de búsqueda. Seleccione el elemento de trabajo deseado en la lista que aparece. Si busca por título, se devolverán elementos de trabajo filtrados por estado; se excluyen todos los elementos de trabajo con estados que tengan asociadas las categorías de estado Completado y Eliminado. Estos elementos de trabajo también se filtran por fecha y usuario, con solo los elementos creados o modificados en los últimos 30 días indicados, y los debe crear, asignar o autorizar el usuario actual.

Quite los vínculos de elementos de trabajo seleccionando el botón Quitar que aparece al mantener el puntero sobre el elemento de trabajo. Botón Quitar Al quitar un vínculo, solo se quita el vínculo entre el elemento de trabajo y la PR. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

Incorporación de etiquetas a una PR

Use etiquetas para mostrar detalles importantes y ayudar a organizar las solicitudes de incorporación de cambios. Las etiquetas pueden comunicar información adicional a los revisores, como que la PR es un trabajo en curso o es una corrección para una versión futura.

Captura de pantalla que muestra PR con etiquetas.

Para agregar una etiqueta al crear una PR, escriba un nombre de etiqueta en la sección Etiquetas. Después de crear la PR, puede administrar las etiquetas en la sección Etiquetas.

Captura de pantalla que muestra la sección Etiquetas de una PR resaltada.

Incorporación de datos adjuntos a solicitudes de incorporación de cambios

Puede adjuntar archivos, incluidas imágenes, a una PR durante o después de su creación. Seleccione el icono de clip de papel debajo del campo Descripción, o bien arrastre y coloque los archivos directamente en el campo Descripción de la PR.

Captura de pantalla que muestra cómo adjuntar archivos a la descripción de una PR durante su creación.

Cambio de la rama de destino de una PR activa

Para la mayoría de los equipos, casi todas las PR tienen como destino una rama predeterminada, como main o develop. Si a veces necesita tener como destino una rama diferente, es fácil olvidar cambiar la rama de destino al crear la PR. Si esto sucede, puede cambiar la rama de destino de una PR activa:

  1. Seleccione Más acciones en la esquina superior derecha de la página Información general de la PR y, después, seleccione Cambiar rama de destino en el menú desplegable.
  2. En el panel Cambiar rama de destino, seleccione Elegir una rama de destino, elija la nueva rama y, después, seleccione Cambiar.

Envío de notificaciones de PR por correo electrónico a las partes interesadas

Puede compartir una PR por correo electrónico para notificar a los revisores y comunicarse con los miembros del equipo. Para compartir una PR:

  1. Seleccione Más opciones en la página Información general de la PR y, después, seleccione Compartir solicitud de incorporación de cambios.

    Captura de pantalla que muestra la selección de la opción Compartir solicitud de incorporación de cambios en la página Información general de una PR.

  2. Agregue los destinatarios en la pantalla Compartir solicitud de incorporación de cambios; para ello, escriba sus nombres en el campo Para: y selecciónelos entre los nombres de usuario que aparecen. También puede quitar destinatarios.

  3. Agregue un mensaje opcional en el campo Nota (opcional) y, después, seleccione Enviar. Los destinatarios reciben un correo electrónico que solicita su atención y con un vínculo a la PR.

Nota:

Si usa la característica de correo electrónico integrada, solo puede enviar correos electrónicos a las direcciones individuales de los miembros del proyecto. No se admite la incorporación de un grupo de equipos o un grupo de seguridad en la línea Para:. Si agrega una cuenta de correo electrónico que el sistema no reconoce, recibirá un mensaje indicándole que uno o varios destinatarios del correo electrónico no tienen permisos para leer la PR enviada.

Para que la característica de correo electrónico funcione, el administrador de Azure DevOps Server debe configurar un servidor SMTP.

Pasos siguientes