Crear solicitudes de incorporación de cambios

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Cree solicitudes de incorporación de cambios (RP) 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 recorrer 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 solicitud de incorporación de cambios deba cumplir varios criterios antes de poder completar la solicitud de incorporación de cambios y combinar los cambios en la rama de destino.

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

Requisitos previos

  • Los repositorios deben estar habilitados en el proyecto. Si el centro de repositorios y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a habilitar repositorios.

  • Para ver o revisar las 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 solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes .

  • Para crear y completar una solicitud de incorporación de cambios, 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 a las partes interesadas tienen acceso total a Azure Repos.

  • Los repositorios deben estar habilitados en el proyecto. Si el centro de repositorios y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a habilitar repositorios.
  • Para ver o revisar las 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, agregue .
  • Para crear y completar una solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Colaboradores o tener los permisos correspondientes en el proyecto que desea cambiar.
  • Para contribuir a una solicitud de incorporación de cambios, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes .
  • 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 ver o revisar las solicitudes de incorporación de cambios, debe ser miembro de un proyecto de Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, agregue .
  • Para contribuir a una solicitud de incorporación de cambios, 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 nueva solicitud de incorporación de cambios desde el sitio web del proyecto de Azure DevOps, desde Visual Studio o desde la CLI de Azure DevOps.

Desde el sitio web del proyecto de Azure DevOps, puede crear una solicitud de incorporación de cambios desde:

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

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

  1. En la página ReposPull requests (Solicitudes de incorporación de cambios de repositorios>), seleccione New pull request (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 P R en Azure Repos.

  3. Escriba los detalles de la solicitud de incorporación de cambios y cree la solicitud de incorporación de cambios.

Creación de una solicitud de incorporación de cambios desde una rama insertada

Después de insertar o actualizar una rama de características, Azure Repos muestra un mensaje para crear una solicitud de incorporación de cambios.

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

    Captura de pantalla que muestra el mensaje para crear una P R 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 P R en la pestaña Archivos de Azure Repos.

Seleccione Crear una solicitud de incorporación de cambios para ir a una página donde puede escribir los detalles de la solicitud de incorporación de cambios y crear la solicitud de incorporación de cambios.

Después de insertar o actualizar una rama de características, Azure Repos le pide que cree una solicitud de incorporación de cambios en la vista Código de la Web. Este mensaje se muestra en solicitudes de incorporación de cambios y archivos.

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

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

Seleccione Crear una solicitud de incorporación de cambios para ir a una página donde puede escribir los detalles de la solicitud de incorporación de cambios y crear la solicitud de incorporación de cambios.

Creación de una solicitud de incorporación de cambios a partir de un elemento de trabajo vinculado

Puede crear una solicitud de incorporación de cambios 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 de desarrollo de un elemento de trabajo con una rama vinculada.

El vínculo le lleva a una página donde puede escribir los detalles de la solicitud de incorporación de cambios y crear la solicitud de incorporación de cambios.

Agregar actualizaciones con cherry-pick

Puede copiar confirmaciones de una rama a otra mediante cherry-pick. A diferencia de una combinación o rebase, la selección de cereza solo aporta los cambios de las confirmaciones que seleccione, en lugar de todos los cambios de una rama.

Para seleccionar los cambios de una solicitud de incorporación de cambios completada, seleccione Cherry-pick en la página Información general de la solicitud de incorporación de cambios. Para copiar los cambios de una solicitud de incorporación de cambios activa, seleccione Cherry-pick en el menú Más opciones de la solicitud de incorporación de cambios. Esta acción crea una nueva rama con los cambios copiados. A continuación, puede crear una nueva solicitud de incorporación de cambios desde la nueva rama. Para obtener instrucciones detalladas, consulte Copia de cambios con cherry-pick.

Cambio de las ramas de origen y destino de la solicitud de incorporación de cambios

Antes de la primera vez que guarde una solicitud de incorporación de cambios, puede cambiar las ramas de origen y destino de la solicitud de incorporación de cambios seleccionando el icono Cambiar ramas de origen y de destino junto a los nombres de rama. Una vez que la solicitud de incorporación de cambios está activa, este icono desaparece, pero todavía puede cambiar la rama de destino de la solicitud de incorporación de cambios.

Captura de pantalla del icono de bifurcación de origen y destino del conmutador.

Uso de plantillas de solicitud de incorporación de cambios

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

Si el repositorio tiene una plantilla predeterminada, todas las solicitudes de incorporación de cambios del repositorio tienen el texto de descripción de la plantilla predeterminado al crearse. Para agregar otras plantillas, seleccione Agregar una plantilla y, a continuación, 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 en la que se muestra cómo agregar una plantilla al crear una instancia de P R.

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

Si la solicitud de incorporación de cambios no está lista para su revisión, puede crear un borrador de solicitud de incorporación de cambios para indicar el trabajo en curso. Cuando la solicitud de incorporación de cambios 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 tienen las siguientes diferencias con respecto a las solicitudes de incorporación de cambios publicadas:

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

  • 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 agregue explícitamente al borrador de solicitud de incorporación de cambios.

  • Se muestran borradores de solicitudes de incorporación de cambios en la lista de pr con un 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 Azure DevOps Server actualización 2019.1 o una versión posterior.

Para crear una solicitud de incorporación de cambios de borrador, seleccione la flecha situada junto a Crear y seleccione Crear como borrador al crear la solicitud de incorporación de cambios. No es necesario usar prefijos de título como WIP o NO MERGE.

Captura de pantalla que muestra Crear como borrador P R.

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

Captura de pantalla que muestra Publicar para una P R.

Para cambiar una solicitud de incorporación de cambios publicada existente a un borrador, elija Marcar como borrador. Al marcar una solicitud de incorporación de cambios como borrador, se quitan todos los votos existentes.

Captura de pantalla que muestra Mark como borrador.

Nota

Esta característica requiere Azure DevOps Server actualización 2019.1 o una versión posterior.

Agregar o editar el título y la descripción de la solicitud de incorporación de cambios

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 los cambios. En una nueva solicitud de incorporación de cambios como en las solicitudes de incorporación de cambios existentes, puede ver los archivos y confirmaciones en la solicitud de incorporación de cambios en pestañas independientes. Puede agregar revisores, vincular elementos de trabajo y agregar etiquetas a la solicitud de incorporación de cambios.

Cuando esté listo para revisar los cambios, seleccione Crear para crear la solicitud de incorporación de cambios.

Captura de pantalla que muestra la creación de una nueva instancia de P R.

Agregar detalles a una nueva P R.

No se preocupe si no tiene todos los elementos de trabajo, revisores o detalles listos al crear la solicitud de incorporación de cambios. Puede agregar o actualizar estos elementos después de crear la solicitud de incorporación de cambios.

Edición del título y la descripción de la solicitud de incorporación de cambios

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

Para actualizar el título de una solicitud de incorporación de cambios existente, seleccione el título actual y actualice el texto. Seleccione el icono Guardar para guardar los cambios o seleccione el icono Deshacer para descartar los cambios.

Edite la descripción de la solicitud de incorporación de cambios seleccionando el icono Editar en la sección Descripción .

Captura de pantalla que muestra la edición del título de P R y la selección del botón Editar descripción.

Adición de revisores a una solicitud de incorporación de cambios

Puede agregar revisores en la sección Revisores de una solicitud de incorporación de cambios nueva o existente. También puede hacer que los revisores opcionales existentes necesiten o cambien los revisores necesarios a opcionales o quitarlos, a menos que sean necesarios para la directiva.

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

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

Captura de pantalla que muestra Ver directiva en un revisor que se incluye automáticamente mediante la directiva de rama.

Si el usuario o grupo que desea revisar la solicitud de incorporación de cambios no es miembro del proyecto, debe agregarlos al proyecto para poder agregarlos como revisores.

Para agregar revisores a una nueva solicitud de incorporación de cambios:

  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 agregarlos como revisores opcionales.
  3. Para agregar revisores necesarios, seleccione Agregar revisores necesarios y, a continuación, seleccione Buscar para agregar revisores necesarios para buscar y seleccionar los nombres.

Captura de pantalla de cómo agregar un revisor a una nueva instancia de P R.

Para agregar revisores a una solicitud de incorporación de cambios existente:

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

    Introducción a la solicitud de incorporación de cambios

  2. A medida que escribe 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.

    Agregue el 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 agregar revisores a la solicitud de incorporación de cambios:

  1. Seleccione la pestaña Información general en la solicitud de incorporación de cambios.

    Introducción a la solicitud de incorporación de cambios

  2. Seleccione el botón Agregar en el área Revisores .

  3. Escriba el nombre del usuario o grupo que se va a agregar a la lista de revisores de la solicitud de incorporación de cambios. Si el usuario no es miembro del proyecto, deberá agregarlo.

  4. A medida que escribe un nombre o una dirección de correo electrónico, aparece una lista de usuarios o grupos coincidentes. Seleccione el usuario o grupo de la lista para agregarlos como revisor.

    Agregar revisor de pr

Para vincular elementos de trabajo a una nueva solicitud de incorporación de cambios:

  1. En la página Nueva solicitud de incorporación de cambios , en Elementos de trabajo para vincular, seleccione Buscar elementos de trabajo por identificador o título.
  2. Comience 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.

Para vincular elementos de trabajo a una solicitud de incorporación de cambios existente:

  1. En la pestaña Información general de la solicitud de incorporación de cambios, 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 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 quitar un vínculo solo se quita el vínculo entre el elemento de trabajo y la solicitud de incorporación de cambios. 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 solicitud de incorporación de cambios:

  1. Seleccione la pestaña Información general en la solicitud de incorporación de cambios.

    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 Agregar en el área Elementos de trabajo . Icono agregar en solicitudes de incorporación de cambios

  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.

Quite los vínculos de elementos de trabajo seleccionando el botón Quitar que aparece al mantener el puntero sobre el elemento de trabajo. quitar botón Al quitar un vínculo solo se quita el vínculo entre un elemento de trabajo a una solicitud de incorporación de cambios. 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 solicitud de incorporación de cambios:

  1. Seleccione Información general en la solicitud de incorporación de cambios.

    Seleccione Información general en la solicitud de incorporación de cambios.

  2. Seleccione el botón Agregar en el área Elementos de trabajo .

  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.

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

Adición de etiquetas a una solicitud de incorporación de cambios

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 solicitud de incorporación de cambios sigue funcionando o es una revisión para una próxima versión.

Captura de pantalla que muestra P Rs con etiquetas.

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

Captura de pantalla que muestra la sección Etiquetas de P R resaltada.

Adición de etiquetas a una solicitud de incorporación de cambios

Puede comunicar información adicional sobre una solicitud de incorporación de cambios a los revisores mediante etiquetas. Es posible que la solicitud de incorporación de cambios siga funcionando o que se trata de una revisión para una próxima versión. Use etiquetas para comunicar detalles importantes y ayudar a organizar las solicitudes de incorporación de cambios.

Nota:

El uso de etiquetas de solicitud de incorporación de cambios requiere TFS 2018.2 o una versión posterior.

Captura de pantalla en la que se muestran las P R con etiquetas.

Para agregar una etiqueta al crear una solicitud de incorporación de cambios, elija Agregar etiqueta. Después de crear una solicitud de incorporación de cambios, puede administrar sus etiquetas en la sección Etiquetas .

Adición de una etiqueta de P R

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

Puede adjuntar archivos, incluidas las imágenes, a la solicitud de incorporación de cambios durante o después de la creación. Seleccione el icono de recorte de papel debajo del campo Descripción , o arrastre y coloque los archivos directamente en el campo Descripción de la solicitud de incorporación de cambios.

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 solicitud de incorporación de cambios activa

Para la mayoría de los equipos, casi todos los 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 solicitud de incorporación de cambios. Si esto sucede, puede cambiar la rama de destino de una solicitud de incorporación de cambios activa:

  1. Seleccione Más acciones en la esquina superior derecha de la página Información general de la solicitud de incorporación de cambios 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, seleccione la nueva rama y, a continuación, seleccione Cambiar.

Email notificaciones de solicitud de incorporación de cambios 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 solicitud de incorporación de cambios:

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

    Captura de pantalla que muestra la selección de Share pull request (Compartir solicitud de incorporación de cambios) en la página De información general de P R.

  2. En la pantalla Share pull request (Compartir solicitud de incorporación de cambios), agregue destinatarios escribiendo sus nombres en el campo Para: y seleccionando 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 vinculan a la solicitud de incorporación de cambios.

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 adición de un grupo de equipo o un grupo de seguridad a la línea Para: . Si agrega una cuenta de correo electrónico que el sistema no reconoce, recibirá un mensaje que indica que uno o varios destinatarios del correo electrónico no tienen permisos para leer la solicitud de incorporación de cambios por correo.

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

Pasos siguientes