Acerca de las solicitudes de incorporación de cambios

Para más información, consulte:

• Introducción a las directivas de rama
• Configuración de directivas de rama
• Permisos de rama
• Usar Azure Functions para crear directivas de rama personalizadas

Definición de comprobaciones de estado para mejorar la calidad del código

Las solicitudes de extracción y las directivas de rama permiten a los equipos aplicar procedimientos recomendados para revisar el código y ejecutar compilaciones automatizadas. Muchos equipos tienen más requisitos y validaciones que hacer en el código. Para cubrir estas necesidades, puede integrar las comprobaciones de estado de la PR en el flujo de trabajo de la pr. Con las comprobaciones de estado de la PR, los servicios externos pueden cerrar la sesión de los cambios de código mediante programación asociando información correcta o de error a la PR.

Para más información, consulte los siguientes artículos.

• Personalización y ampliación de flujos de trabajo de solicitud de extracción con estado de solicitud de extracción
• Creación de un servidor de estado de PR con Node.js
• Configuración de una directiva de rama para un servicio externo

Problema de base de mezcla múltiple

En algunos casos, una pr. tiene más de una base de mezcla verdadera y esta situación puede causar problemas de seguridad. Si los archivos de la pr tienen versiones diferentes entre las bases de mezcla, se produce una advertencia de base de mezcla múltiple. Para obtener más información y corrección, vea Base de combinación múltiple.

Pasos siguientes

• Mejora de la calidad del código con directivas de ramas
• Personalización y ampliación de flujos de trabajo de solicitud de extracción con estado de solicitud de extracción
• Notificaciones de actualización de solicitudes de extracción
• Cambiar la rama predeterminada
• Copia de cambios con selección exclusiva
• Combinación de estrategias y combinación de squash
• Varias bases de combinación

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

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Las solicitudes de extracción (PR) son una manera de cambiar, revisar y combinar código en un repositorio de Git en Azure Repos. Las PR pueden proceden de ramas dentro del mismo repositorio o de ramas en bifurcaciones del repositorio. Teams las PR para revisar el código y enviar comentarios sobre los cambios antes de combinar el código en la rama principal. Los revisores pueden pasar por los cambios propuestos, dejar comentarios y votar para aprobar o rechazar el código.

En el vídeo siguiente se muestra el proceso general de solicitud de extracción. Es posible que algunos elementos de la interfaz de usuario y terminología no se apliquen a Azure DevOps versión.

En este artículo se describen las directrices de solicitud de extracción y las consideraciones de administración. Para obtener instrucciones sobre cómo crear, ver, revisar y completar solicitudes de extracción, consulte los artículos siguientes:

• Crear solicitudes de incorporación de cambios
• Ver y abrir solicitudes de incorporación de cambios
• Revisar solicitudes de incorporación de cambios
• Completar solicitudes de incorporación de cambios

Permisos y requisitos previos

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

Comentarios de calidad para las solicitudes de extracción

Las revisiones de alta calidad comienzan con comentarios de alta calidad. Estas son algunas de las claves de los excelentes comentarios de la PR:

• El propietario de la PR debe hacer que las personas correctas revisen la PR y asegurarse de que los revisores saben lo que hace el código.
• Los revisores deben proporcionar comentarios acciónbles y agradables.
• Los propietarios y revisores deben comentar y responder rápidamente.

Los propietarios de pr deben:

• Asegúrese de seleccionar los revisores adecuados para asignar a una pr.
• Incluya revisores que sepan cómo funciona el código.
• Pida a los desarrolladores que trabajan en otras áreas que compartan sus ideas.
• Proporcionar una descripción clara de los cambios.
• Proporcione instrucciones para revisores con plantillas de solicitud de extracción.
• Proporcione una compilación del código con la corrección o característica que se ejecuta en él.
• Responda a comentarios, acepte la sugerencia o explique por qué el cambio sugerido no es ideal.
• Para obtener sugerencias buenas fuera del ámbito de la PR, cree nuevos elementos de trabajo, ramas y PR para realizar esos cambios.

Los revisores deben:

• Proporcione comentarios sobre los cambios con los que no están de acuerdo.
• Identifique los problemas y dé sugerencias específicas sobre qué hacer de manera diferente.
• Asegúrese de que los comentarios tienen una intención clara y que es fácil de entender.
• Deje comentarios.
• Vote por los cambios.

Obtenga más información sobre cómo obtener comentarios con las solicitudes de extracción de Git.

Directivas de rama y solicitudes de extracción

El equipo puede confiar en ramas críticas del repositorio, como la rama, para estar main siempre en buen estado. Puede establecer directivas de rama para requerir las PR para los cambios en estas ramas protegidas y rechazar los cambios que se insertan directamente en las ramas.

Puede agregar más directivas a las PR para aplicar una mejor calidad del código en las ramas clave. Requisitos adicionales, como una compilación limpia del código propuesto o la aprobación de varios revisores, pueden ayudar a proteger las ramas clave.

Puede establecer el número de aprobaciones necesarias para una solicitud de cambio en una directiva de rama. También puede establecer determinados revisores para que sean obligatorios u opcionales en todos o determinados PR. Una solicitud de inserción de cambios se puede establecer en autocompletar con el número necesario de aprobaciones, incluso si otros revisores rechazan los cambios. Sin embargo, los revisores necesarios deben aprobar las PR antes de que se puedan combinar. Es un procedimiento recomendado que al menos dos revisores revisen y aprueben los cambios en una solicitud de solicitud de cambios significativa.

Para restablecer los votos cada vez que un autor de una PR inserta nuevos cambios, seleccione Restablecer los votos del revisor de código cuando haya nuevos cambios en la directiva de rama Requerir un número mínimo de revisores.

En la tabla siguiente se resumen las directivas que puede definir para personalizar una rama. Para obtener información general sobre todas las directivas y configuraciones de repositorio y rama, consulte Configuración y directivas del repositorio de Git.