Impulso del desarrollo de Git desde un elemento de trabajo en Azure Boards

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

Una de las formas de que el equipo impulse su desarrollo y permanezca sincronizado es vincular los elementos de trabajo a los objetos creados durante el desarrollo, como ramas, confirmaciones, solicitudes de incorporación de cambios y compilaciones. Puede comenzar esa vinculación mediante la creación de una rama a partir de uno o varios elementos de trabajo. Más adelante, puede crear solicitudes de incorporación de cambios, abrir rápidamente confirmaciones y mantener un registro de las operaciones de desarrollo realizadas para completar un trabajo específico.

En este artículo, descubrirá cómo realizar las tareas siguientes:

  • Creación de una rama o solicitud de incorporación de cambios desde un elemento de trabajo
  • Finalización de la solicitud de incorporación de cambios
  • Realización de una fusión mediante combinación con "squash"
  • Creación de una rama para varios elementos de trabajo
  • Vinculación de un elemento de trabajo a objetos de desarrollo y compilación existentes

En este artículo se tratan la creación de nuevas ramas, la incorporación de vínculos a confirmaciones y la incorporación de solicitudes de incorporación de cambios a un repositorio de Git hospedado en Azure DevOps. Para vincular a confirmaciones y solicitudes de incorporación de cambios de GitHub, consulte Vinculación de confirmaciones de GitHub y solicitudes de incorporación de cambios a elementos de trabajo.

Sugerencia

Puede configurar la vinculación automática y otros valores de configuración que vinculan elementos de trabajo a commits de Git, solicitudes de incorporación de cambios, compilaciones, etc. Para obtener más información, consulte los siguientes recursos:

Control de desarrollo

El control Desarrollo registra todos los procesos de desarrollo de Git que admiten la finalización del elemento de trabajo. Este control puede mostrar la información del equipo necesaria para realizar el siguiente paso de desarrollo y minimizar los pasos de navegación para las tareas comunes de desarrollo. También admite la rastreabilidad, lo que proporciona visibilidad sobre todas las ramas, confirmaciones, solicitudes de incorporación de cambios y compilaciones relacionadas con el elemento de trabajo.

Captura de pantalla del formulario de elemento de trabajo, control Desarrollo.

Captura de pantalla del formulario de elemento de trabajo, control Implementación, Azure DevOps Server 2019.

Desde él, puede acceder rápidamente a las ramas, las solicitudes de incorporación de cambios y las confirmaciones vinculadas al elemento de trabajo. Además, puede iniciar una solicitud de incorporación de cambios para una rama que haya creado o vinculado desde el elemento de trabajo.

Tenga en cuenta que el control Desarrollo solo aparece en el formulario del elemento de trabajo del portal web. La experiencia de seguimiento de elementos de trabajo y los formularios de Visual Studio u otros clientes compatibles no muestran varias de las características que están disponibles en el portal web.

Requisitos previos

  • Conéctese a un proyecto. Si todavía no tiene un proyecto, cree uno.
  • Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradores o Administradores de proyectos. Para conseguir que lo agreguen, consulte Agregar usuarios a un proyecto o equipo.
  • Para ver o modificar los elementos de trabajo, debe tener los permisos de Ver los elementos de trabajo en este nodo y Editar elementos de trabajo de este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecimiento de permisos y acceso para el seguimiento del trabajo.
  • Conéctese a un proyecto. Si todavía no tiene un proyecto, cree uno.
  • Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradores o Administradores de proyectos. Para conseguir que lo agreguen, consulte Agregar usuarios a un proyecto o equipo.
  • Para ver o modificar los elementos de trabajo, debe tener los permisos de Ver los elementos de trabajo en este nodo y Editar elementos de trabajo de este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecimiento de permisos y acceso para el seguimiento del trabajo.

Proceso del flujo de trabajo

Considere la posibilidad de crear una rama cuando no haya artefactos de código vinculados. Si existe una rama, pero no solicitudes de incorporación de cambios, considere la posibilidad de crear una. Esta es una secuencia de flujo de trabajo típica al trabajar con un repositorio de Git.

  1. Comience a trabajar en el elemento de trabajo creando una rama. Puede agregar una nueva rama de Git desde la sección Desarrollo...

    Captura de pantalla del control Desarrollo, Crear vínculo de rama.

    ... o bien, en el menú Acciones del formulario.

    Formulario del elemento de trabajo Caso de usuario, menú Acción, agregar nueva rama.

    Asigne un nombre a la rama y seleccione el repositorio.

    Cuadro de diálogo Crear una rama

    Al crear ramas, se vinculan automáticamente al elemento de trabajo.

    Nota:

    Solo puede crear una rama una vez que haya agregado archivos a la rama principal, que se recomienda etiquetar con main u otra etiqueta distintiva. El sistema agrega automáticamente un archivo LÉAME al repositorio inicial creado con cada nuevo proyecto.

  2. El sistema se abre en el repositorio y la rama que ha creado.

    Los archivos se editan en el portal web.

    O bien, si tiene ediciones de archivos extensas o necesita agregar archivos, trabaje desde Visual Studio u otro entorno de desarrollo integrado compatible. Agregue una nueva rama local desde la rama que creó. Para más información, consulte Actualización de código con fetch y pull, Descarga de cambios con fetch. (Aunque cualquier proceso de edición y confirmación de código funcione, trabajamos mejor con una edición de Visual Studio).

  3. Agregue o modifique archivos en la rama que ha creado.

    Desde Visual Studio u otro entorno de desarrollo integrado compatible, confirme e inserte los cambios de la rama local en el repositorio.

    Confirmación y envío de cambios

    Si es la primera vez que inserta cambios desde una nueva rama, publique la rama antes de insertar los cambios. Para más información, consulte Uso compartido de código con push.

  4. Cree una solicitud de incorporación de cambios desde el formulario del elemento de trabajo.

    Puede crear una solicitud de incorporación de cambios para combinar los cambios realizados en una rama principal y obtener los cambios revisados por otros miembros del equipo.

    Captura de pantalla del control Desarrollo, Crear vínculo de solicitud de incorporación de cambios.

  5. La vista cambia a página Código, Solicitudes de incorporación de cambios. Complete la creación de la solicitud de incorporación de cambios como se muestra.

    Vista Código, página Solicitud de incorporación de cambios.

    Nota:

    Una vez creada una solicitud de incorporación de cambios, no podrá crear una nueva para la misma rama hasta que complete la anterior.

    Página Solicitud de incorporación de cambios, Crear solicitud de incorporación de cambios.

    Active la casilla de Fusión mediante combinación con "squash" y complete la combinación.

    Cuadro de diálogo Completar solicitud de incorporación de cambios, active Fusión mediante combinación con

  6. Tras la finalización, debería ver una pantalla similar a la siguiente.

    Solicitud de incorporación de cambios, notificación completada.

  7. Abra el formulario del elemento de trabajo o actualice el formulario, expanda la sección Desarrollo (elija Maximizar desarrollo) y verá los vínculos que se han agregado para admitir las operaciones completadas.

    Captura de pantalla del formulario de elemento de trabajo, sección Desarrollo, vínculos agregados.

Creación de una rama para varios elementos de trabajo

También puede agregar una nueva rama desde el elemento de trabajo que aparece en el trabajo pendiente o en el panel Kanban sin tener que abrir el elemento de trabajo. Con la selección múltiple, puede seleccionar varios elementos de trabajo y crear una nueva rama en la que estén vinculados a la rama.

Por ejemplo, aquí seleccionamos los cinco primeros elementos para vincularlos a una nueva rama.

Captura de pantalla de la selección de varios elementos del trabajo pendiente, vínculo Crear rama.

Y, especificamos el nombre de la rama.

Cuadro de diálogo Crear rama

Todos los elementos que aparecen en la sección Desarrollo también aparecen en la pestaña Vínculos. Todas las acciones de desarrollo iniciadas desde la sección Desarrollo también se registran en la pestaña Historial.

Pestaña Vínculos, vínculos de desarrollo

Para vincular un elemento de trabajo a un objeto existente, elija el icono Agregar vínculo Agregar vínculos y elija el tipo de vínculo.

Seleccione el icono Agregar vínculos y elija el tipo de vínculo.

Si desea quitar un vínculo, puede hacerlo en la sección Desarrollo; primero resáltelo y, después, elija Quitar vínculo.

Sección Desarrollo, eliminar un vínculo.

O bien, puede seleccionarlo en la pestaña Vínculos, elegir Acciones para el vínculo y, a continuación, elegir la opción Quitar vínculo.

Elementos de trabajo asociados en la compilación

Con las confirmaciones de Git, los elementos de trabajo que se han vinculado a una confirmación se enumeran en los elementos de trabajo asociados en la página de resumen de la compilación.

Elementos de trabajo vinculados que aparecen en Elementos de trabajo asociados en la página de resumen de la compilación.

Los vínculos que se muestran en esta sección aparecen por estas acciones:

  • Creación de una rama, confirmación o solicitud de incorporación de cambios desde el elemento de trabajo
  • Especificación del identificador de elemento de trabajo durante una confirmación, una solicitud de incorporación de cambios u otra operación de Git o TFVC compatible
  • Vinculación específica del elemento de trabajo desde la sección Desarrollo o la pestaña Vínculos a una rama de código fuente, compilación u otra operación de Git o TFVC compatible.

Al mantener el puntero sobre cualquier entrada que aparezca en la sección Desarrollo, se activa el hipervínculo al objeto asociado.

Los tipos de vínculo que se pueden agregar dentro de la sección de desarrollo son Rama, Compilación, Conjunto de cambios, Confirmación, Encontrado en compilación, Integrado en la compilación, Solicitud de incorporación de cambios y Elemento con versión.

Tipos de vínculo de artefacto a artefacto

Para más información sobre el control de vínculos o para personalizar el control Vínculos de desarrollo, consulte Elementos LinksControlOptions, control Vínculos de desarrollo.