Compartir a través de


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. En función de las políticas de la rama y otros requisitos, es posible que tu PR tenga que cumplir varios criterios para poder completar el PR y fusionar los cambios 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.

Prerrequisitos

  • Acceso:
    • Acceso Básico: Para ver o revisar los PRs, sea miembro de un proyecto de Azure DevOps con al menos Acceso Básico.
    • acceso a las partes interesadas: Para proyectos públicos, los usuarios con acceso a las partes interesadas tienen acceso total a Azure Repos.
  • Permisos:
    • Repos habilitado: Repos debe estar habilitado en el proyecto. Si el Repos hub y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a habilitar Repos.
    • Membresía en el proyecto:
    • Grupo de seguridad Lectores Para contribuir en una solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes.
    • Grupo de seguridad Colaboradores: Para crear y completar una solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Colaboradores o tener los permisos correspondientes.
  • Herramientas:
  • Acceso:
    • Acceso básico: Para ver o revisar solicitudes de incorporación de cambios, debe ser miembro de un proyecto de Azure DevOps con al menos Acceso básico. Si no es miembro del proyecto, agréguese.
  • Permisos:
    • Repos habilitado: Repos debe estar habilitado en el proyecto. Si no aparecen el centro de Repos ni las páginas asociadas, consulte Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.
    • Grupo de seguridad Lectores Para contribuir en una solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes.
    • Grupo de seguridad Colaboradores: Para crear y completar una solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Colaboradores o tener los permisos correspondientes.

Para obtener más información sobre los permisos y el acceso, consulte Permisos predeterminados de repositorios y ramas de Git y Acerca de los niveles de acceso.

Crear una solicitud de incorporación de cambios

Puede crear un nuevo 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 desea combinar los cambios, 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. Buenas descripciones de PR informan a los revisores de PR sobre qué esperar y pueden ayudar a realizar un seguimiento de tareas como agregar pruebas unitarias y actualizar la documentación. Tu equipo puede crear una plantilla de PR predeterminada que agregue texto a todas las nuevas descripciones de PR del repositorio. Además, puede seleccionar entre plantillas específicas de 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, al crearse, todas las pull requests (PRs) del repositorio tendrán el texto de descripción de la plantilla predeterminada. Para agregar otras plantillas, seleccione Agregar una plantilla y elija una plantilla en la lista desplegable. Puede editar el texto de la plantilla en la descripción, quitarlo o agregar otro texto.

captura de pantalla que muestra cómo agregar una plantilla al crear un P R.

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

Si tu PR no está listo para revisión, puedes crear un borrador de PR para indicar el trabajo en curso. 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 mientras está en modo borrador.

  • Los revisores necesarios 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 P R en la lista de P R.

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 NO 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 de Captura de pantalla que muestra la opción Publicar para una PR. P R.

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 un nuevo P R

Agregar detalles a un nuevo P R.

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 seleccione el icono Deshacer para descartar los cambios.

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 P R y seleccionar el botón Editar 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 sean necesarios o cambiar los revisores necesarios a opcionales o quitarlos, a menos que la directiva los requiera.

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 puede quitar a los revisores requeridos por la política de la 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. Al escribir un nombre o una dirección de correo electrónico, una lista desplegable muestra una lista de usuarios y grupos coincidentes. Seleccione los nombres de la lista para agregar como revisores opcionales.
  3. Para agregar revisores necesarios, seleccione Agregar revisores necesariosy, a continuación, seleccione Buscar para agregar revisores necesarios para buscar y seleccionar los nombres.

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

Para agregar revisores a un 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. Al escribir un nombre o una dirección de correo electrónico, aparece una lista de usuarios o grupos coincidentes. Seleccione los nombres que se van a agregar como revisores.

    Agregar revisor de P R.

Para cambiar un revisor entre obligatorio y opcional, o quitar un revisor, 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. Empiece a escribir un identificador o título de elemento de trabajo y seleccione el elemento de trabajo que se va a 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, y solo se muestran los elementos que fueron creados o actualizados en los últimos 30 días. Además, deben haber sido creados por, asignados a, o autorizados como 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 de 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 de la lista que aparece.

Para quitar un vínculo de elemento de trabajo, seleccione el icono x situado junto al elemento de trabajo. Al eliminar un vínculo solo se elimina el vínculo entre el elemento de trabajo y el 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 de elementos de vínculo.

  2. Seleccione el botón Añadir en el área Elementos de trabajo. Agregar icono en PRs

  3. Escriba el identificador del elemento de trabajo o busque elementos de trabajo con títulos que coincidan con el texto. Seleccione el elemento de trabajo de la lista que aparece. Buscar por título devuelve elementos de trabajo filtrados por estado; se excluyen todos los elementos de trabajo cuyos estados tienen categorías Completado y Eliminados. Estos elementos de trabajo también se filtran por fecha y usuario, y solo se muestran los elementos creados o actualizados en los últimos 30 días. Además, deben ser creados por, asignados a, o autorizados por el usuario actual.

Quite los vínculos del elemento 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

Utilice etiquetas para mostrar detalles importantes y ayudar a organizar las PRs. 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 en la que se muestran las P R 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 P R 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 la asociación de archivos a la descripción de P R durante la creación.

Cambio de la rama de destino de una PR activa

Para la mayoría de los equipos, casi todos los PRs 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, a continuación, seleccione Cambiar.

Enviar notificaciones de solicitud de incorporación de cambios por correo electrónico a las partes interesadas

Puede compartir una solicitud de incorporación de cambios 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, a continuación, 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 el correo electrónico 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 que le indica que uno o varios destinatarios de su correo electrónico no tienen permisos para leer la solicitud de incorporación de cambios enviada.

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

Pasos siguientes