Crear solicitudes de incorporación de cambios

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

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

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

Requisitos previos

  • Repos debe estar habilitado en el proyecto. Si el Repos y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a Repos.

  • Para ver o revisar las PR, 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 a los que se concede acceso de las partes interesadas tienen acceso total a Azure Repos.

  • Repos debe estar habilitado en el proyecto. Si el Repos y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a Repos.
  • Para ver o revisar las PR, debe ser miembro del proyecto Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, obtenga agregado.
  • Para crear y completar una PR, debe ser miembro del grupo de seguridad Colaboradores o tener los permisos correspondientes en el proyecto que desea cambiar.
  • 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.
  • Para ver o revisar las PR, debe ser miembro de un proyecto de Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, obtenga agregado.
  • Para contribuir a una pr, debe ser miembro del grupo de seguridad Lectores o tener los permisos correspondientes.
  • Puede crear y administrar LAS desde la interfaz de la línea de comandos (CLI) de Azure con la extensión . Para obtener información sobre cómo trabajar con la CLI Azure DevOps Services, consulte Introducción a Azure DevOps CLI. Azure Repos comandos de la CLI para pr usan az repos pr.

Crear una solicitud de incorporación de cambios

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

Desde el Azure DevOps del proyecto, puede crear una nueva pr. desde:

Creación de una solicitud de solicitud de cambio desde la página Solicitudes de extracción

Puede crear solicitudes de solicitud para cualquier rama desde la página Solicitudes de extracción del proyecto en la web.

  1. En la Repossolicitudes de extracción, seleccione Nueva solicitud de extracción en la esquina superior derecha.

    Captura de pantalla del botón Nueva solicitud de extracción.

  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 PR y cree la pr.

Creación de una pr a partir de una rama inserda

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

  • En la página Solicitudes de extracción:

    Captura de pantalla que muestra el símbolo del sistema para crear un P R en la pestaña Solicitudes de extracción Azure Repos.

  • En la página Archivos:

    Captura de pantalla que muestra el símbolo del sistema para crear un archivo P R en la pestaña Archivos Azure Repos.

Seleccione Crear una solicitud de extracción para ir a una página en la que puede escribir los detalles de la solicitud de cambio y crear la solicitud de solicitud de cambio.

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

Captura de pantalla que muestra el símbolo del sistema para crear un P R en la pestaña Solicitudes de extracción Azure Repos.

Captura de pantalla que muestra el símbolo del sistema para crear un archivo P R en la pestaña Archivos Azure Repos.

Seleccione Crear una solicitud de extracción para ir a una página en la que puede escribir los detalles de la solicitud de cambio y crear la solicitud de solicitud de cambio.

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

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

  1. En Azure Boards, en 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 extracción.

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

El vínculo le lleva a una página en la que puede escribir los detalles de la pr y crear la pr.

Adición de actualizaciones con la selección de guiso

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

Para elegir mejor los cambios de una solicitud de solicitud de cambios completada, seleccione Pick-pick en la página Información general de la solicitud de cambio. Para copiar los cambios de una PR activa, seleccione Pick-pick (Seleccionar guión) en el menú Más opciones de la pr. Esta acción crea una nueva rama con los cambios copiados. A continuación, puede crear una nueva pr desde la nueva rama. Para obtener instrucciones detalladas, vea Copiar cambios con la selección de guiso.

Cambiar las ramas de origen y destino de la solicitud de extracción

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

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

Uso de plantillas de solicitud de extracción

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

Si el repositorio tiene una plantilla predeterminada, todas las OPCIONES del repositorio tienen el texto de descripción de la plantilla predeterminada en la creación. 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 que muestra Agregar una plantilla al crear una P R.

Creación de borradores de PR

Si la pr. no está lista para revisión, puede crear un borrador de pr. para indicar el trabajo en curso. Cuando la solicitud de revisión esté lista para revisión, puede publicarla y comenzar o reanudar el proceso de revisión completo.

Los borradores de PR tienen las siguientes diferencias con respecto a los PR publicados:

  • 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 en la solicitud de solicitud de acceso.

  • 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 se agregan explícitamente a la pr. de borrador.

  • Los borradores de pr se muestran en la lista de pr con un distintivo de borrador.

    Captura de pantalla que muestra un borrador de P R en la lista de P R.

Nota

La creación de borradores de PR Azure DevOps Server actualización 2019.1 o una versión posterior.

Para crear una pr. de borrador, seleccione la flecha situada junto a Crear y seleccione 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 Crear como borrador de P R.

Cuando esté listo para que la solicitud de solicitud de acceso se revise y se complete, seleccione Publicar en la esquina superior derecha de la solicitud de solicitud de acceso. Al publicar una pr, se asignan los revisores necesarios, se evalúan las directivas y se inicia la votación.

Captura de pantalla que muestra Publicar para una 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 Marcar como borrador.

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

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

Cuando esté listo para que se revisen los cambios, seleccione Crear para crear la pr.

Captura de pantalla que muestra la creación de una nueva 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 pr. Puede agregar o actualizar estos elementos después de crear la pr.

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

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

Puede actualizar el título de una pr. existente seleccionando el título actual y actualizando 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 pr. 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 de descripción.

Agregar revisores a una solicitud de extracción

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 ciertos revisores opcionales o necesarios en las PR. No se pueden quitar los revisores requeridos por la directiva de rama. Puede cambiar los revisores opcionales de la directiva de rama para que sean necesarios o eliminarlos.

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 la PR, haga clic con el botón derecho en Más opciones junto al revisor.

Captura de pantalla que muestra View policy on a reviewer that's automatically included by branch policy (Ver directiva en un revisor que se incluye automáticamente por la directiva de rama).

Si el usuario o grupo que quiere revisar la pr. no es miembro del proyecto, debe agregarlo al proyecto para poder agregarlos como revisores.

Para agregar revisores a una nueva pr:

  1. En la página Nueva solicitud de extracción, en Revisores,seleccione Buscar usuarios y grupos para agregar como revisores.
  2. A medida que escribe un nombre o una dirección de correo electrónico, una lista desplegable muestra una lista de usuarios y grupos que coinciden. Seleccione los nombres de la lista para agregarlos como revisores opcionales.
  3. Para agregar los revisores necesarios, seleccione Agregar revisores necesarios y,a continuación, seleccione Buscar para agregar los revisores necesarios para buscar y seleccionar los nombres.

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

Para agregar revisores a una PR existente:

  1. En la sección Revisores de la página Información general, seleccione Agregary, a continuación, seleccione Revisor requerido u Revisor opcional.

    Introducción a la solicitud de extracción

  2. A medida que escribe un nombre o una dirección de correo electrónico, aparece una lista de usuarios o grupos que coinciden. Seleccione los nombres que se agregarán 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 pr.

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

    Introducción a la PR

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

  3. Escriba el nombre del usuario o grupo que se agregará a la lista de revisores de la pr. 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 que coinciden. Seleccione el usuario o grupo de la lista para agregarlo como revisor.

    Agregar revisor de PR

Para vincular elementos de trabajo a una nueva PR:

  1. En la página Nueva solicitud de extracción, en Elementos de trabajo para vincular,seleccione Buscar elementos de trabajo por identificador o título.
  2. Comience a escribir un identificador o un título de elemento de trabajo y seleccione el elemento de trabajo que desea vincular en la lista desplegable que aparece.

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 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 de elementos de vínculo.

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

  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 en la lista que aparece.

Para quitar vínculos de elementos de trabajo, seleccione 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 un elemento de trabajo y una 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 Información general en la pr.

    Seleccione Información general en la pr.

  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 en la lista que aparece.

Para quitar vínculos de elementos de trabajo, seleccione 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 pr. Los vínculos creados en la rama o a partir de confirmaciones permanecen en el elemento de trabajo.

Agregar etiquetas a una solicitud de extracción

Use etiquetas para mostrar detalles importantes y ayudar a organizar las PR. Las etiquetas pueden comunicar información adicional a los revisores, como que la solicitud de cambios sigue siendo un trabajo en curso o es una revisión para una próxima versión.

Captura de pantalla que muestra 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 etiquetas en la sección Etiquetas.

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

Agregar etiquetas a una solicitud de extracción

Puede comunicar información adicional sobre una PR a los revisores mediante etiquetas. Es posible que la solicitud de cambios todavía sea un trabajo en curso o que sea una revisión para una próxima versión. Use etiquetas para comunicar detalles importantes y ayudar a organizar las PR.

Nota

El uso de etiquetas de PR requiere TFS 2018.2 o una versión posterior.

Captura de pantalla que muestra P Rs con etiquetas.

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

Agregar etiqueta de P R

Agregar datos adjuntos a las solicitudes de extracción

Puede adjuntar archivos, incluidas las imágenes, a la PR durante o después de la creación. Seleccione el icono de clip de papel debajo del campo Descripción o 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 solicitud de extracción activa

Para la mayoría de los equipos, casi todos los clientes tienen como destino una rama predeterminada, como main o develop . Si a veces necesita tener como destino otra rama, es fácil olvidarse de 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 en la página Información general de la PR y, a continuación, 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.

Notificaciones de solicitud de extracción por correo electrónico a las partes interesadas

Puede compartir una solicitud de extracción 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 pr. y, a continuación, seleccione Compartir solicitud de extracción.

    Captura de pantalla que muestra la selección de Compartir solicitud de extracción en la página Información general de una solicitud de extracción de P R.

  2. En la pantalla Compartir solicitud de extracción, 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 solicitando su atención y vinculando a la solicitud de cambio.

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 equipos 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 extracción 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