Impulsar el desarrollo de Git desde un elemento de trabajo en Azure Boards

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2017

Una de las formas en que el equipo puede impulsar su desarrollo y mantenerse sincronizado es vincular los elementos de trabajo a los objetos creados durante el desarrollo, como ramas, confirmaciones, solicitudes de extracción 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 extracción, abrir rápidamente confirmaciones y mantener un registro de las operaciones de desarrollo realizadas para completar un trabajo específico.

Revise este artículo para obtener información:

  • Creación de una nueva rama o solicitud de extracción desde un elemento de trabajo
  • Completar la solicitud de extracción
  • Realizar una combinación de 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 trata la creación de nuevas ramas, la adición de vínculos a confirmaciones y la adición de solicitudes de incorporación de cambios a un repositorio git hospedado en Azure DevOps. Para vincular a GitHub y solicitudes de extracción, vea Vincular GitHub y solicitudes de extracción a elementos de trabajo.

Sugerencia

Puede configurar la vinculación automática y otras opciones que vinculen elementos de trabajo a confirmaciones de Git, solicitudes de extracción, compilaciones, etc. Para obtener información sobre cómo hacerlo, 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 realizar tareas de desarrollo comunes. También admite la rastreabilidad, lo que proporciona visibilidad de todas las ramas, confirmaciones, solicitudes de extracción y compilaciones relacionadas con el elemento de trabajo.

Captura de pantalla del formulario de elemento de trabajo, Control de desarrollo.

Formulario de elemento de trabajo, sección Desarrollo

Nota

El control Desarrollo dentro del formulario de elemento de trabajo no se admite en TFS 2015 y versiones anteriores. Considere la posibilidad de actualizar a una versión Azure DevOps Server posterior.

Desde él, puede acceder rápidamente a ramas, solicitudes de extracción y confirmaciones que están vinculadas al elemento de trabajo. Además, puede iniciar una solicitud de extracción 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 de elemento de trabajo del portal web. La experiencia de seguimiento de elementos de trabajo y los formularios que aparecen en Visual Studio u otros clientes admitidos no muestran varias de las características disponibles en el portal web.

Requisitos previos

  • Conectar a un proyecto. Si aún no tiene un proyecto, cree uno.
  • Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradoreso Project administradores. Para agregarlo, agregue usuarios a un proyecto o equipo.
  • Para ver o modificar elementos de trabajo, debe tener los permisos Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecer permisos y acceso para el seguimiento del trabajo.
  • Conectar a un proyecto. Si aún no tiene un proyecto, cree uno.
  • Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradoreso Project administradores. Para agregarlo, agregue usuarios a un proyecto o equipo.
  • Para ver o modificar elementos de trabajo, debe tener los permisos Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecer permisos y acceso para el seguimiento del trabajo.

Proceso de flujo de trabajo

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

  1. Inicie el trabajo en el elemento de trabajo mediante la creación de una rama. Puede agregar una nueva rama de Git desde la sección Desarrollo...

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

    Formulario de elemento de trabajo de caso de usuario, sección Desarrollo, creación de una rama

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

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

    Asigne un nombre a la rama y seleccione el repositorio en el que se basa.

    Cuadro de diálogo Crear una rama

    Las ramas que cree 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 u main otra etiqueta distintiva. El sistema agrega automáticamente un archivo LÉAME al repositorio inicial creado con cada proyecto nuevo.

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

    Puede editar un archivo en el portal web.

    O bien, si tiene grandes ediciones de archivos o necesita agregar archivos, deberá trabajar desde Visual Studio ide compatible. Querrá agregar una nueva rama local desde la rama que creó. Para más información, consulte Actualización de código con captura y extracción, Descarga de cambios con fetch. (Aunque cualquier proceso de edición y confirmación de código funcionará, trabajamos mejor con una edición de Visual Studio).

  3. Agregue o modifique archivos en la rama que creó.

    Desde Visual Studio u otro IDE compatible, confirme e inste los cambios de la rama local al repositorio.

    Confirmación y envío de cambios

    Si es la primera vez que se insertarán cambios desde una nueva rama, deberá publicar la rama antes de insertar los cambios. Para obtener más información, vea Compartir código con inserción.

  4. Cree una desde el formulario de elemento de trabajo.

    Cree una solicitud de extracción para combinar los cambios realizados en una rama principal y que otros miembros del equipo revisen los cambios.

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

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

    Vista de código, página Solicitud de extracción.

    Nota

    Una vez que haya creado una solicitud de extracción, no podrá crear una nueva solicitud de extracción para la misma rama hasta que complete la solicitud de extracción anterior.

    Página Solicitud de extracción, Crear solicitud de extracción.

    Active la casilla Cambios de squash al combinar y, a continuación, complete la combinación.

    Cuadro de diálogo Complete pull request (Completar solicitud de extracción), active squash-merge

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

    Solicitud de extracción, notificación completada

  7. Abra el formulario de 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 que ha completado.

    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 todos están vinculados a la rama.

Por ejemplo, aquí se seleccionan los cinco primeros elementos que se vinculan a una nueva rama.

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

Además, especificamos el nombre de la rama.

Cuadro de diálogo Crear nueva rama

Todos los elementos enumerados 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, a continuación, elija el tipo de vínculo.

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

Vinculación, rastreabilidad y administración de dependencias.

Si desea quitar un vínculo, puede hacerlo desde la sección Desarrollo resalte primero y, a continuación, elija Quitar vínculo.

Sección de 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 muestran en elementos de trabajo asociados en la página de resumen de compilación.

Elementos de trabajo vinculados enumerados en Elementos de trabajo asociados en la página de resumen de 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 debido a estas acciones:

  • Creación de una rama, confirmación o solicitud de extracción desde el elemento de trabajo
  • Especificar el identificador del elemento de trabajo durante una confirmación, una solicitud de extracción u otra operación de Git o TFVC compatible
  • Vincule específicamente el 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 aparece en la sección Desarrollo, se activa el hipervínculo al objeto asociado.

Los tipos de vínculo que puede agregar dentro de la sección de desarrollo son Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request y Versioned Item.

Tipos de vínculo de artefacto a artefacto

Los tipos de vínculo que puede agregar dentro de la sección de desarrollo son Branch, Build, Changeset, Commit, Pull Request y Versioned Item.

Tipos de vínculo de artefacto a artefacto

Para obtener más información sobre el control de vínculos o para personalizar el control Vínculos de desarrollo, vea VínculosControlOpciones, Control de vínculos de desarrollo.