Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
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
| Categoría | Requisitos |
|---|---|
| Niveles de acceso | - Ver o revisar Pull Requests (PRs): al menos acceso básico. Para los proyectos públicos, los usuarios con acceso de las partes interesadas tienen acceso completo a Azure Repos. |
| Permisos | - Contribuir a un PR: miembro del grupo de seguridad Lectores o de los permisos correspondientes. - Crear y completar un PR (pull request): Miembro del grupo de seguridad Colaboradores o los permisos correspondientes. |
| Servicios | Repos habilitados. |
| Herramientas | CLI de Azure DevOps. |
| Categoría | Requisitos |
|---|---|
| Niveles de acceso | - Ver o revisar Pull Requests (PRs): al menos acceso básico. |
| Permisos | - Contribuir a un PR: miembro del grupo de seguridad Lectores o de los permisos correspondientes. - Crear y completar un PR (pull request): Miembro del grupo de seguridad Colaboradores o los permisos correspondientes. |
| Servicios | Repos habilitados. |
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:
- 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 del desarrollo en 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 desea combinar los cambios, 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. 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.
.
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.
Para crear un borrador de PR, seleccione la flecha situada junto a Crear y después Crear como borrador al crear la PR. No tiene que 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 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 cambiar revisores opcionales a obligatorios, 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 o necesarios en las solicitudes de incorporación de cambios. No puede quitar revisores requeridos por la directiva de rama, pero puede cambiar revisores opcionales a obligatorios o quitarlos.
Para ver la política de rama que agregó automáticamente un revisor, seleccione más opciones junto al revisor en la sección Revisores de la página Resumen del PR.
Si el usuario o grupo que desea revisar la solicitud de incorporación de cambios no es miembro del proyecto, agréguelos al proyecto para poder agregarlos como revisores.
Para agregar revisores a una nueva PR, realice los siguientes pasos:
- En la página Nueva solicitud de incorporación de cambios, en Revisores, seleccione Buscar usuarios y grupos para agregar como revisores.
- 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.
- Para agregar revisores necesarios, seleccione Agregar revisores necesariosy, a continuación, seleccione Buscar para agregar revisores necesarios para buscar y seleccionar los nombres.
de P R
Para agregar revisores a una solicitud de incorporación de cambios existente, siga estos pasos:
En la sección Revisores de la página Información general, seleccione Agregar y, después, Revisor obligatorio o Revisor opcional.
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.
Para cambiar un revisor entre obligatorio y opcional, o para 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.
Vinculación de elementos de trabajo a una PR
Para vincular elementos de trabajo a una nueva solicitud de incorporación de cambios, siga estos pasos:
- 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.
- 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.
- Buscar por título devuelve elementos de trabajo filtrados por estado; se excluyen todos los elementos de trabajo con estados clasificados como Completados y Eliminados .
- Estos elementos de trabajo también se filtran por fecha y usuario, mostrando solo los elementos creados o actualizados en los últimos 30 días. Deben ser creados por, asignados a, o autorizados como el usuario actual.
Para vincular elementos de trabajo a una solicitud de incorporación de cambios existente, siga estos pasos:
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 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.
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.
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 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:
- 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, 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:
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, 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
Al usar la característica de correo electrónico integrada, solo puede enviar correos electrónicos a 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 dirección de correo electrónico no reconocida, recibirá un mensaje que indica que uno o varios destinatarios 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 debe configurar un servidor SMTP.
Pasos siguientes
Artículos relacionados
- Visualización de solicitudes de incorporación de cambios
- Revisión de solicitudes de incorporación de cambios
- Finalización de solicitudes de incorporación de cambios
- Cambiar la rama predeterminada
- Copia de cambios con selección exclusiva
- Más información sobre las solicitudes de incorporación de cambios y los permisos