git tag

Para crear una nueva etiqueta, ejecuta el siguiente comando:

Sustituye < tagname > con un identificador semántico del estado del repositorio en el momento en el que se crea la etiqueta. Un patrón habitual es utilizar números de versión como git tag v1.4. Git admite dos tipos diferentes de etiquetas: etiquetas anotadas y ligeras. En el ejemplo anterior, se ha creado una etiqueta ligera. Las etiquetas ligeras y las anotadas difieren en la cantidad de metadatos adjuntos que almacenan. Una práctica recomendada es considerar las etiquetas anotadas como públicas y las etiquetas ligeras como privadas. Las etiquetas anotadas almacenan metadatos adicionales como los siguientes: el nombre de la persona que etiqueta, su correo electrónico y la fecha. Son datos importantes para una publicación pública. Las etiquetas ligeras son básicamente “marcadores” de una confirmación; son solo un nombre y un puntero a una confirmación, útiles para crear enlaces rápidos a las confirmaciones relevantes.

Al ejecutar este comando, se crea una etiqueta ligera identificada como v1.4-lw. Las etiquetas ligeras se crean con la ausencia de las opciones -a, -s o -m. Las etiquetas ligeras crean una nueva suma de verificación de etiquetas y la almacenan en el directorio .git/ del repositorio del proyecto.

Para elaborar una lista de las etiquetas almacenadas en un repositorio, ejecuta lo siguiente:

El resultado será una lista de etiquetas:

Para perfeccionar la lista de etiquetas, se puede usar la opción -l con una expresión comodín:

En este ejemplo anterior, se utiliza la opción -l y una expresión comodín de -rc que devuelve una lista de todas las etiquetas marcadas con un prefijo -rc, tradicionalmente utilizado para identificar candidatos de publicación.

Los ejemplos de etiquetado anteriores han demostrado operaciones en las confirmaciones implícitas. De manera predeterminada, git tag creará una etiqueta en la confirmación a la que HEAD hace referencia. Otra alternativa es que git tag puede usarse como una referencia a una confirmación específica. Esta acción etiquetará la confirmación usada en vez de establecer como predeterminado HEAD. Para recopilar una lista de confirmaciones más antiguas, ejecuta el comando git log.

Al ejecutar git log, aparecerá una lista de confirmaciones. En este ejemplo, escogeremos la primera confirmación, Merge branch 'feature', para la nueva etiqueta. Tendremos que hacer referencia al hash SHA de la confirmación para usarla en Git:

Al ejecutar la invocación de git tag anterior, se creará una nueva confirmación anotada identificada como v1.2 para la confirmación que hemos seleccionado en el ejemplo de git log anterior.

Si intentas crear una etiqueta con el mismo identificador que una etiqueta existente, Git lanzará un error como el siguiente:

Asimismo, si intentas etiquetar una confirmación más antigua con un identificador de etiqueta existente, Git lanzará el mismo error.

En el caso de que tengas que actualizar una etiqueta existente, debe utilizarse la opción -f (--force).

Al ejecutar el comando anterior, se asignará la confirmación 15027957951b64cf874c3557a0f3547bd83b3ff6 al identificador de etiquetas v1.4. Esto sobrescribirá cualquier contenido existente de la etiqueta v1.4.

Compartir etiquetas es similar a enviar ramas. De manera predeterminada, git push no enviará etiquetas. Las etiquetas se tienen que usar explícitamente en git push.

Para enviar varias etiquetas al mismo tiempo, usa la opción --tags en el comando git push. Cuando otro usuario clone un repositorio o incorpore cambios en él, recibirá las nuevas etiquetas.

Puedes ver el estado de un repositorio en una etiqueta mediante el comando git checkout.

El comando anterior extraerá la etiqueta v1.4. Esta acción dejará el repositorio en un estado de HEAD desasociado, lo que significa que ningún cambio que se haga actualizará la etiqueta, sino que creará una nueva confirmación desasociada. Esta nueva confirmación desasociada no formará parte de ninguna rama y solo se podrá acceder a ella directamente mediante el hash SHA de la confirmación. Por lo tanto, es recomendable crear una nueva rama cada vez que hagas cambios en un estado de HEAD desasociado.

La eliminación de etiquetas es una operación sencilla. Al usar la opción -d y un identificador de etiqueta de git tag, se eliminará la etiqueta identificada.

En este ejemplo, se ejecuta git tag para visualizar una lista de etiquetas que muestra v1, v2 y v3. A continuación, se ejecuta git tag -d v1, lo que elimina la etiqueta v1.

En resumen, el etiquetado es un mecanismo adicional que sirve para crear una instantánea de un repositorio de Git. Tradicionalmente, se utiliza el etiquetado para crear etiquetas identificativas con números de versión semánticos que se corresponden con ciclos de publicación de software. El comando git tag es el impulsor principal de una etiqueta: creación, modificación y eliminación. Hay dos tipos de etiquetas: anotadas y ligeras. Por lo general, las etiquetas anotadas son la práctica recomendada, ya que almacenan metadatos valiosos adicionales sobre la etiqueta. En este documento, también se ha hablado de los comandos de Git siguientes: git push y git checkout. Visita sus páginas correspondientes para descubrir su uso más exhaustivo.