Ejercicio de Colaboración de Azure Repos con solicitudes de incorporación de cambios
Los problemas de código que se encuentran antes son más fáciles y más baratos de corregir. Por lo tanto, los equipos de desarrollo se esfuerzan por insertar comprobaciones de calidad del código lo más lejos posible en el proceso de desarrollo.
Como sugiere el nombre, las directivas de rama le dan un conjunto de directivas de serie que se pueden aplicar a las ramas del servidor.
Los cambios que se insertan en las ramas del servidor deben seguir estas directivas antes de que se puedan aceptar los cambios.
Las directivas son una excelente manera de aplicar los estándares de administración de cambios y la calidad del código del equipo. En este tutorial, aprenderá a configurar directivas de rama en la rama principal.
Preparación
Las directivas de rama de serie incluyen varias directivas, como la validación de compilaciones y la aplicación de una estrategia de combinación. En este tutorial solo nos centraremos en las directivas de rama necesarias para configurar un flujo de trabajo de revisión de código.
Cómo hacerlo
Abra la vista de ramas del repositorio myWebApp de Git en el portal del equipo Parts-Unlimited. Seleccione la rama principal y, en el menú contextual desplegable, elija Directivas de rama:
En la vista de directivas, presenta directivas personalizadas. Establezca el número mínimo de revisores en 1:
La opción Permitir que los solicitantes aprueben sus propios cambios permite que el emisor apruebe los cambios por sí mismo.
Aunque esto puede ser aceptable para los equipos maduros, en general, se debe evitar.
Use la directiva de revisión con la directiva de resolución de comentarios. Le permite exigir que los comentarios de revisión de código se resuelvan antes de que se acepten los cambios. El solicitante puede tomar nota de los comentarios, crear un nuevo elemento de trabajo y resolver los cambios. Al menos garantiza que los comentarios de revisión de código no se pierdan con la aceptación del código en la rama principal:
Los requisitos provocan un cambio de código en el proyecto de equipo. Si el elemento de trabajo que desencadenó el trabajo no está vinculado al cambio, resulta difícil entender por qué se hizo. Es especialmente útil al revisar el historial de cambios. Configure la directiva Buscar elementos de trabajo vinculados para bloquear los cambios que no tienen un elemento de trabajo vinculado a ellos:
Seleccione la opción para incluir revisores automáticamente cuando se genera automáticamente una solicitud de incorporación de cambios. Puede asignar qué revisores se agregan en función del área del código que se va a cambiar:
Cómo funciona
Con las directivas de rama en su lugar, la rama principal ahora está totalmente protegida.
La única manera de insertar cambios en la rama principal es primero realizar los cambios en otra rama y, después, generar una solicitud de incorporación de cambios para desencadenar el flujo de trabajo de aceptación de cambios.
Elija crear una nueva rama a partir de uno de los casos de usuario existentes en el centro de elementos de trabajo.
Al crear una nueva rama a partir de un elemento de trabajo, ese elemento de trabajo se vincula automáticamente a la rama.
Opcionalmente, puede incluir más de un elemento de trabajo con una rama como parte del flujo de trabajo de creación:
Agregue un prefijo en el nombre al crear la rama para crear una carpeta que contenga la rama.
En el ejemplo anterior, la rama pasará a la carpeta. Es una excelente manera de organizar las ramas en entornos concurridos.
Con la rama recién creada seleccionada en el portal web, edite el archivo HomeController.cs para incluir el siguiente fragmento de código y confirmar los cambios en la rama.
En la imagen siguiente, verá que puede confirmar directamente los cambios después de editar el archivo haciendo clic en el botón Confirmar.
El control de ruta de acceso de archivos en el portal del equipo admite la búsqueda.
Comience a escribir la ruta de acceso del archivo para ver todos los archivos del repositorio de Git en ese directorio, empezando por las letras que aparecen en la lista desplegable de resultados de búsqueda de la ruta de acceso de archivo.
El editor de código del portal web tiene varias características nuevas en Azure DevOps Server, como la compatibilidad con la coincidencia de corchetes y la alternación de los espacios en blanco.
Puede cargar la paleta de comandos si la presiona. Entre muchas otras opciones nuevas, ahora puede alternar el archivo mediante un minimapa de archivos, contraer y expandir, y realizar otras operaciones estándar.
Para insertar estos cambios desde la nueva rama en la rama principal, cree una solicitud de incorporación de cambios desde la vista de solicitud de incorporación de cambios.
Seleccione la nueva rama como origen y la principal como rama de destino.
El nuevo formulario de solicitud de incorporación de cambios admite Markdown, por lo que puede agregar la descripción mediante la sintaxis de Markdown.
La ventana de descripción también admite menciones @ y # para vincular elementos de trabajo:
Se crea la solicitud de incorporación de cambios. En la página de información general se resumen los cambios y el estado de las directivas.
La pestaña Archivos muestra una lista de cambios y la diferencia entre la versión anterior y la actual.
Las actualizaciones que se insertan en los archivos de código se mostrarán en la pestaña Actualizaciones, y se mostrará una lista de todas las confirmaciones en la pestaña Confirmaciones:
Abra la pestaña Archivos. Esta vista admite comentarios de código en el nivel de línea, en el nivel de archivo y en general.
Los comentarios admiten @ para menciones y # para vincular elementos de trabajo y el texto admite la sintaxis de Markdown:
Los comentarios de código se conservan en el flujo de trabajo de la solicitud de extracción; los comentarios de código admiten varias iteraciones de revisiones y funcionan bien con respuestas anidadas.
La directiva de revisor permite utilizar un flujo de trabajo de revisión de código como parte de la aceptación de cambios.
Es una excelente manera de que el equipo colabore en los cambios de código que se insertan en la rama principal.
Cuando el número necesario de revisores aprueba la solicitud de incorporación de cambios, se puede completar.
También puede marcar la solicitud de extracción para que se autocomplete después de la revisión. Se autocompletan las solicitudes de incorporación de cambios una vez que todas las directivas se han compilado correctamente.
Hay más
¿Alguna vez se ha encontrado con que se ha eliminado accidentalmente una rama? No suele ser fácil averiguar lo que ha ocurrido.
Azure DevOps Server ahora admite la búsqueda de ramas eliminadas. Le ayuda a comprender quién lo eliminó y cuándo. La interfaz también permite volver a crear la rama.
Las ramas eliminadas solo se muestran si las busca por su nombre exacto para eliminar el ruido de los resultados de la búsqueda.
Para buscar una rama eliminada, escriba el nombre completo de la rama en el cuadro de búsqueda de ramas. Se mostrarán todas las ramas existentes que coincidan con ese texto.
También verá una opción para buscar coincidencias exactas en la lista de ramas eliminadas.
Si se encuentra una coincidencia, verá quién la eliminó y cuándo. También puede restaurar la rama. Al restaurar una rama, se volverá a crear en la confirmación a la que se dirigió por última vez.
Sin embargo, no se restaurarán las directivas ni los permisos.