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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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.

Screenshot of work item form, Development control.

Screenshot of work item form, Development control, Azure DevOps Server 2019.

Screenshot of work item form, Development control, TFS 2018.

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...

    Screenshot of Development control, Create branch link.

    User story work item form, Development section, create new branch

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

    User story work item form, Action menu, add new branch.

    Asigne un nombre a la rama y seleccione el repositorio.

    Create a branch dialog box

    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.

    Commit and push changes

    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.

    Screenshot of Development control, Create pull request link.

  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.

    Code view, Pull Request page.

    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.

    Pull Request page, Create pull request.

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

    Complete pull request dialog box, check squash-merge

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

    Pull request, completed notification

  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.

    Screenshot of Work item form, Development section, links added.

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.

Screenshot of select multiple items from backlog, Create branch link.

Y, especificamos el nombre de la rama.

Create new branch dialog

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.

Links tab, development links

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

Select Add links icon and then choose the link type.

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

Development section, delete a link

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.

Linked work items listed under Associated work items in the build summary page.

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.

Artifact-to-artifact link types

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, Solicitud de incorporación de cambios y Elemento con versión.

Artifact-to-artifact link types

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.