Uso de etiquetas de Git

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

Visual Studio 2019 | Visual Studio 2022

Azure DevOps admite etiquetas anotadas y ligeras. Las etiquetas ligeras son un puntero a una confirmación específica, mientras que las etiquetas anotadas contienen más información, como el etiquetador, el mensaje y la fecha. Puede crear etiquetas anotadas mediante el portal web. Puede crear etiquetas ligeras y anotadas desde Visual Studio. Para obtener más información sobre las etiquetas de Git, consulte 2.6 Git Basics - Tagging (2.6 Conceptos básicos de Git: etiquetado) del libro Pro Git.

En este artículo se proporciona información general sobre cómo trabajar con etiquetas de Git en Azure DevOps y Visual Studio.

Importante

La vista Etiquetas de Visual Studio se introdujo en Visual Studio 2017 Update 6. Si utiliza una versión anterior a esta, puede ver y crear etiquetas a partir de las vistas de detalles de historial y confirmación a partir de Visual Studio 2015, pero no podrá realizar las operaciones en la vista Etiquetas como se describe en este artículo.

Visualización y filtrado de etiquetas

Browser

Puede ver etiquetas en la vista Etiquetas y en la vista Confirmaciones en el portal web.

Nota:

Con Azure DevOps Services, el formato de la dirección URL del proyecto es dev.azure.com/{your organization}/{your project}. Pero todavía se admite el formato anterior que hace referencia al formato visualstudio.com. Para más información, vea Introducción a Azure DevOps: Cambio de las organizaciones existentes para usar la nueva dirección URL de nombre de dominio.

Visualización de etiquetas en la vista Etiquetas

1. Para ver las etiquetas del repositorio, vaya al proyecto en el portal web, elija Repositorios, Etiquetas y seleccione el repositorio que quiera.

   

   Las etiquetas anotadas se muestran con un nombre de etiqueta, un mensaje, una confirmación, un etiquetador y una fecha de creación. Las etiquetas ligeras se muestran con un nombre de etiqueta y una confirmación.

2. Para filtrar la lista de etiquetas, escriba un término de búsqueda en el cuadro Buscar nombre de etiqueta y presione Entrar.

   

Visualización de etiquetas en la vista Confirmaciones

Para ver las etiquetas de una rama específica en la vista Confirmaciones, vaya al repositorio en el portal web, elija Repositorios, Confirmaciones y seleccione la rama.

Visual Studio

Visualización de etiquetas en la vista Historial

Puede ver las etiquetas en la vista Historial.

1. En el menú Git de la barra de menús, seleccione Administrar ramas.

2. Seleccione una rama para ver el historial.

   

   Las formas rojas son ramas y las formas verdes son etiquetas.

Visualización de etiquetas en la vista Etiquetas

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para más información, vea Comparación en paralelo de Git y Team Explorer.

1. Para ver todas las etiquetas de un repositorio, seleccione Etiquetas en la vista Inicio.

   

2. Las etiquetas se muestran en el nombre del repositorio conectado actualmente.

   

   Las etiquetas anotadas muestran información que contiene el nombre de la etiqueta, el etiquetador, la fecha de la etiqueta y el mensaje. Las etiquetas ligeras solo poseen el nombre de la etiqueta en la información.

   

   Para obtener más información sobre la confirmación etiquetada, haga clic con el botón derecho en la etiqueta y seleccione Ver detalles de confirmación.

   

3. Para filtrar la lista de etiquetas, escriba un término de búsqueda en el cuadro Escriba aquí para filtrar la lista.

   

Para recuperar la lista actual de etiquetas del repositorio de origen, realice una operación de recuperación de cambios.

Creación de una etiqueta

Para crear una etiqueta, debe tener el permiso Crear etiqueta, que se incluye de forma predeterminada en el grupo de Colaboradores y en otros de nivel superior.

Nota:

Los nombres de etiqueta no pueden contener caracteres de control ASCII, como espacios, tildes y dos puntos. Es habitual usar caracteres en minúsculas y separar palabras con un guión. La longitud del nombre de etiqueta no debe superar los 250 caracteres ASCII. Para evitar ambigüedad entre los nombres de etiqueta y los hashes de confirmación, no use nombres de etiqueta que constan de 40 caracteres hexadecimales. Para obtener más información sobre la nomenclatura de etiquetas, consulte git-check-ref-format.

Browser

Puede crear etiquetas anotadas mediante el portal web desde la vista Etiquetas y la vista Confirmaciones.

Importante

Solo puede crear etiquetas anotadas en el portal web o en Visual Studio. Para crear una etiqueta ligera, puede usar la línea de comandos de Git.

Creación de etiquetas en la vista Etiquetas

1. Seleccione Crear etiqueta en la vista Etiquetas del portal web para crear una nueva etiqueta anotada.

   

2. Especifique un Nombre, seleccione la rama desde la que se va a etiquetar, escriba una Descripción (necesaria, ya que está creando una etiqueta anotada) y seleccione Crear.

   

3. La nueva etiqueta se muestra en la lista de etiquetas.

   

Creación de etiquetas en la vista Confirmaciones

Para crear una etiqueta directamente desde la vista confirmaciones, haga clic con el botón derecho en la etiqueta que quiera y elija Crear etiqueta.

Visual Studio

Puede crear etiquetas anotadas y ligeras en Visual Studio desde la vista Historial y la vista Etiquetas. Para crear una etiqueta anotada, proporcione un nombre y un mensaje al crear la etiqueta. Para crear una etiqueta ligera, omita el mensaje y proporcione solo un nombre.

Creación de etiquetas desde la vista Historial

Puede ver las etiquetas en la vista Historial.

1. En el menú Git de la barra de menús, seleccione Administrar ramas.

2. Seleccione una rama para ver el historial, haga clic con el botón derecho en una confirmación y seleccione Nueva etiqueta.

   

3. En el cuadro de diálogo Crear una etiqueta nueva, escriba un Nombre de etiqueta solo para una etiqueta ligera o un Nombre de etiqueta y un Mensaje de etiqueta para una etiqueta anotada. Seleccione Crear.

Creación de etiquetas en la vista Etiquetas

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para más información, vea Comparación en paralelo de Git y Team Explorer.

1. Seleccione Nueva etiqueta en la vista Etiquetas para crear una nueva etiqueta.

   

2. Para crear una etiqueta en la punta de la rama actual, especifique un nombre en el cuadro Escriba un nombre de etiqueta, proporcione opcionalmente un mensaje de etiqueta y seleccione Crear etiqueta.

   

   Para seleccionar la rama a partir de la que crear la etiqueta, desactive la casilla Crear etiqueta en la punta de la rama actual y seleccione una rama en la lista desplegable Seleccionar una rama.

   

3. La nueva etiqueta se crea localmente. Haga clic con el botón derecho en la nueva etiqueta y elija Insertar para insertarla en el repositorio remoto. Seleccione Insertar todo para insertar todas las etiquetas locales nuevas en el repositorio remoto.

   

Eliminar etiqueta

Importante

Tenga cuidado al eliminar etiquetas del repositorio. Si otro usuario ha extraído, bifurcado o clonado el repositorio, la etiqueta seguirá existiendo en su copia del repositorio. Solo debe eliminar etiquetas locales, o si está seguro de que el repositorio no se ha extraído, clonado o bifurcado desde que creó la etiqueta.

Para eliminar una etiqueta, debe tener el permiso Forzar inserción en el nivel Repositorio o en el nivel Todas las etiquetas (que hereda sus permisos del nivel de repositorio si no se establece explícitamente). El creador de la etiqueta también hereda automáticamente los permisos de forzar inserción para una etiqueta.

Browser

Eliminación de una etiqueta en el repositorio remoto

Los pasos de este procedimiento muestran cómo eliminar una etiqueta en el repositorio remoto mediante el portal web de Azure DevOps Services.

1. Para eliminar una etiqueta, seleccione los puntos suspensivos situados a la derecha del nombre de etiqueta y elija Eliminar etiqueta.

   

2. Seleccione Eliminar para confirmar.

   

3. La etiqueta se elimina y no se mostrará la próxima vez que vaya a la vista Etiquetas.

   

Visual Studio

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para más información, vea Comparación en paralelo de Git y Team Explorer.

Los pasos de este procedimiento muestran cómo eliminar una etiqueta en el repositorio local mediante Team Explorer de Visual Studio 2019.

Haga clic con el botón derecho en la etiqueta que se va a eliminar y elija Eliminar localmente

Importante

Si la etiqueta ya se ha insertado en el repositorio remoto, no debe eliminarla. Si otro usuario ha extraído, bifurcado o clonado el repositorio, la etiqueta seguirá existiendo en su copia del repositorio. Solo debe eliminar etiquetas locales.

Creación de una rama a partir de una etiqueta

Browser

1. Para crear una rama a partir de una etiqueta, seleccione los puntos suspensivos situados a la derecha del nombre de etiqueta y elija Nueva rama.

   

2. Especifique un Nombre, seleccione opcionalmente los elementos de trabajo que quiera vincular y elija Crear rama.

   

3. La rama se crea y se le lleva a la nueva rama en el portal web.

   

Visual Studio

Los pasos de este procedimiento muestran cómo crear una rama a partir de una etiqueta con Team Explorer de Visual Studio 2019. Para Visual Studio 2019 con el menú Git o Visual Studio 2022, use el explorador.

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para más información, vea Comparación en paralelo de Git y Team Explorer.

1. Para crear una rama a partir de una etiqueta, haga clic con el botón derecho en la etiqueta y elija Nueva rama local desde. También puede elegir Crear rama a partir de etiqueta.

   

2. Especifique un nombre de rama, compruebe la etiqueta deseada y elija Crear rama. Para extraer del repositorio la nueva rama después de crearla, elija Restaurar rama del repositorio.

   

3. Para ver la rama recién creada, seleccione Ramas en la vista Inicio.

   

4. Tenga en cuenta que la nueva rama se crea localmente. Para insertar la rama, haga clic con el botón derecho en ella y elija Insertar rama.

   

Visualización del historial de etiquetas

Browser

1. Para ver el historial de una etiqueta, seleccione los puntos suspensivos situados a la derecha del nombre de etiqueta y elija Ver historial.

   

2. Se le lleva a la vista de confirmaciones de la etiqueta.

   

Visual Studio

Los pasos de este procedimiento muestran cómo ver el historial de etiquetas con Team Explorer de Visual Studio 2019. Para Visual Studio 2019 con el menú Git o Visual Studio 2022, use el explorador.

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para más información, vea Comparación en paralelo de Git y Team Explorer.

1. Para ver el historial de una etiqueta, haga clic con el botón derecho en la etiqueta y elija Ver historial.

   

2. El historial se muestra en la vista Historial.