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
- 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.
- Acceso de parte interesada: En el caso de los proyectos públicos, los usuarios con Acceso de parte interesada tienen acceso total a Azure Repos.
- 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.
- Miembros del proyecto:
- Si no tiene un proyecto, cree uno o regístrese de forma gratuita.
- Si no es miembro del proyecto, agréguese.
- 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:
- CLI de Azure DevOps: Puede crear y administrar solicitudes de incorporación de cambios en la interfaz de la línea de comandos (CLI) de Azure con la extensión
azure-devops
. Para más información, consulte Introducción a la CLI de Azure DevOps.- Los comandos de la CLI de Azure Repos para las solicitudes de incorporación de cambios usan
az repos pr
.
- Los comandos de la CLI de Azure Repos para las solicitudes de incorporación de cambios usan
- CLI de Azure DevOps: Puede crear y administrar solicitudes de incorporación de cambios en la interfaz de la línea de comandos (CLI) de Azure con la extensión
- 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.
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:
- La página Solicitudes de incorporación de cambios.
- Una rama de características insertada en el repositorio.
- Una PR existente, mediante la selección exclusiva.
- El control Desarrollo de un elemento de trabajo vinculado de Azure Boards.
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.
En la página Repos>Solicitudes de incorporación de cambios, seleccione Nueva solicitud de incorporación de cambios en la esquina superior derecha.
Seleccione la rama con los cambios y la rama en la que quiere fusionar los cambios mediante combinación, como la rama principal.
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:
En la página Archivos:
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.
En Azure Boards, desde Trabajos pendientes o Consultas en la vista Trabajo, abra un elemento de trabajo vinculado a la rama.
En el área Desarrollo del elemento de trabajo, seleccione Crear una solicitud de incorporación de cambios.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
- En la página Nueva solicitud de incorporación de cambios, en Revisores, seleccione Buscar usuarios y grupos para agregar como revisores.
- 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.
- Para agregar revisores obligatorios, seleccione Agregar revisores necesarios y, después, elija Buscar para agregar revisores obligatorios para buscar y seleccionar los nombres.
Para agregar revisores a una PR existente:
En la sección Revisores de la página Información general, seleccione Agregar y, después, Revisor obligatorio o Revisor opcional.
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.
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.
Vinculación de elementos de trabajo a una PR
Para vincular elementos de trabajo a una nueva PR:
- 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.
- 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:
En la pestaña Información general de la PR, en el área Elementos de trabajo, seleccione +.
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:
Seleccione la pestaña Información general en la PR.
Seleccione el botón para agregar en el área Elementos de trabajo.
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. 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.
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.
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.
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:
- 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.
- 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:
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.
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.
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.