Acerca de las solicitudes de incorporación de cambios

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Las solicitudes de incorporación de cambios son una manera de cambiar, revisar y combinar código en un repositorio Git en Azure Repos. Las solicitudes de incorporación de cambios pueden proceder de ramas pertenecientes a un mismo repositorio o de ramas en bifurcaciones del repositorio. Los equipos usan las solicitudes de incorporación de cambios para revisar código y dejar sus comentarios sobre los cambios antes de combinar el código en la rama principal. Los revisores pueden examinar los cambios propuestos, dejar comentarios y votar para aprobar o rechazar el código.

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

Nota:

Por motivos de rendimiento y estabilidad, el número de revisores que se pueden agregar a una solicitud de cambios debe ser 1000 o menos. No se crearán nuevas solicitudes de cambios al agregar más de 1000 revisores y las solicitudes de cambios existentes no le permitirán agregar más de 1000 revisores.

Permisos y requisitos previos

  • Repos debe estar habilitado en el proyecto. Si el centro de Repos y las páginas asociadas no se muestran, vea Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.

  • Para ver o revisar 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 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 con acceso de parte interesada tienen acceso total a Azure Repos.

  • Repos debe estar habilitado en el proyecto. Si el centro de Repos y las páginas asociadas no se muestran, vea Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.
  • Para ver o revisar 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, agréguese.
  • Para contribuir a una PR, 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 obtener más información sobre los permisos y el acceso, vea Permisos predeterminados de repositorios y ramas de Git y Acerca de los niveles de acceso.

Comentarios sobre la calidad de las solicitudes de incorporación de cambios

Las revisiones de alta calidad comienzan con comentarios de alta calidad. Estas son algunas claves para obtener unos comentarios estupendos sobre las solicitudes de incorporación de cambios:

  • El propietario de la solicitud de incorporación de cambios debe contar con las personas adecuadas para revisar la solicitud de incorporación de cambios y procurar que los revisores sepan lo que hace el código.
  • Los revisores deben realizar unos comentarios prácticos y constructivos.
  • Los propietarios y revisores deben comentar y responder rápidamente.

Los propietarios de solicitudes de incorporación de cambios deben encargarse de lo siguiente:

  • Asegurarse de seleccionar los revisores adecuados para asignarlos a una solicitud de incorporación de cambios
  • Contar con revisores que sepan cómo funciona el código
  • Pedir a los desarrolladores especializados en otras áreas que compartan sus ideas
  • Describir los cambios con claridad
  • Orientar a los revisores con plantillas de solicitud de incorporación de cambios
  • Proporcionar una compilación del código en la que se ejecute la corrección o la característica
  • Responder a los comentarios, aceptar la sugerencia o explicar por qué el cambio sugerido no es ideal
  • Si se realizan sugerencias adecuadas fuera del ámbito de la solicitud de incorporación de cambios, crear los elementos de trabajo, las ramas y las solicitudes de incorporación de cambios para aplicar esos cambios

Los revisores deben realizar las siguientes tareas.

  • Comentar los cambios con los que no se está de acuerdo
  • Identificar los problemas y hacer sugerencias específicas sobre qué hacer de forma diferente
  • Asegurarse de que los comentarios tienen un objetivo claro y son fáciles de entender
  • Comentar o votar los cambios

Para más información, consulte Obtención de comentarios con solicitudes de cambios de Git.

Directivas de rama y solicitudes de incorporación de cambios

Puede que su equipo dependa de ramas críticas en el repositorio (como la rama main) para mantener un buen nivel. Puede establecer directivas de rama para requerir solicitudes de incorporación de cambios en estas ramas protegidas y rechazar los cambios enviados directamente a las ramas.

Puede agregar más directivas a las solicitudes de incorporación de cambios para alcanzar obligatoriamente una mejor calidad del código en las ramas de clave. Otros requisitos extra, como realizar una compilación limpia del código propuesto o recibir 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 incorporación de cambios en una directiva de rama. También puede establecer que determinados revisores sean obligatorios u opcionales en todas las solicitudes de incorporación de cambios o solo en algunas. Una solicitud de incorporación de cambios se puede configurar para autocompletarse con el número de aprobaciones obligatorio incluso cuando otros revisores hayan rechazado los cambios, pero los revisores obligatorios deben aprobar las solicitudes de incorporación de cambios para que estas fusionarse mediante combinación. Se recomienda que al menos dos revisores revisen y aprueben los cambios en una solicitud de incorporación de cambios importante.

Para restablecer los votos cada vez que el creador de una solicitud de incorporación de cambios envíe cambios nuevos, seleccione Restablecer los votos del revisor de código cuando haya cambios nuevos en la directiva de rama Requerir un número mínimo de revisores.

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

Directiva

Valor predeterminado

Descripción

Requerir un número mínimo de revisores

Desactivado

Sirve para requerir la aprobación de un número especificado de revisores en las solicitudes de incorporación de cambios.

Buscar elementos de trabajo vinculados

Desactivado

Sirve para fomentar la rastreabilidad mediante la búsqueda de elementos de trabajo vinculados en las solicitudes de incorporación de cambios.

Comprobar resolución de comentarios

Desactivado

Sirve para comprobar si todos los comentarios de las solicitudes de incorporación de cambios se han resuelto.

Limitar tipos de fusión mediante combinación \\"merge\\"

Desactivado

Sirve para limitar los tipos de fusión mediante combinación disponibles al completarse las solicitudes de incorporación de cambios para controlar el historial de ramas.

Agregar directivas de validación de compilación

Desactivado

Sirve para agregar una o varias directivas para validar el código mediante la fusión mediante combinación previa y la creación de cambios en la solicitud de incorporación de cambios. También se puede usar para habilitar o deshabilitar directivas.

Agregar directivas de comprobación de estado

Desactivado

Sirve para agregar una o varias directivas para requerir que otros servicios publiquen un estado correcto para completar solicitudes de incorporación de cambios. También se puede usar para habilitar o deshabilitar directivas.

Incluir automáticamente los revisores

Desactivado

Sirve para agregar una o varias directivas para designar a los revisores de código que se incluirán automáticamente cuando las solicitudes de incorporación de cambios cambien determinadas áreas del código. También se puede usar para habilitar o deshabilitar directivas.

Para obtener más información, consulte:

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

Gracias a las solicitudes de incorporación de cambios y las directivas de rama, los equipos pueden aplicar procedimientos recomendados para revisar el código y ejecutar compilaciones automatizadas. Muchos equipos tienen que satisfacer más requisitos y validaciones en el código. Para cubrir estas necesidades, puede integrar comprobaciones de estado de solicitud de incorporación de cambios en el flujo de trabajo de la solicitud de incorporación de cambios. Con las comprobaciones de estado de solicitud de incorporación de cambios, los servicios externos pueden dar su visto bueno mediante programación a los cambios de código, asociando la información de estado correcto o incorrecto con la solicitud de incorporación de cambios.

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

Problema de base de combinación múltiple

En algunos casos, una solicitud de incorporación de cambios tiene más de una base de combinación verdadera, situación que puede causar problemas de seguridad. Si los archivos de la solicitud de incorporación de cambios tienen versiones diferentes entre las bases de combinación, se produce una advertencia de varias bases de combinación. Para obtener más información y una corrección, vea Varias bases de combinación.

Pasos siguientes