Semantic versioning

Domina Semantic versioning con Git y GitLab profesional

Módulo 8 ⏱️ 1 horas 🛠️ Git CLI 🦊 GitLab 🤖 ChatGPT-4 🚀 Batch Mode 🎨 Visual Cards

1. INTRODUCCIÓN TÉCNICA

Semantic Versioning, o SemVer, es un sistema de versión que se utiliza para especificar las versiones de un software. Se utiliza principalmente en las bibliotecas de software y tiene el objetivo de evitar problemas de compatibilidad y dependencias. Se basa en tres números: MAJOR.MINOR.PATCH, cada uno de ellos tiene un propósito específico. MAJOR se incrementa cuando hay cambios incompatibles, MINOR se incrementa cuando se añaden funcionalidades de manera compatible, y PATCH se incrementa cuando se realizan correcciones de errores compatibles.

La versión semántica es crítica en el desarrollo profesional moderno porque permite a los equipos de desarrollo comunicarse eficazmente sobre las características y cambios en su software. También facilita el control de versiones y la gestión de dependencias, que son aspectos esenciales en cualquier proyecto de software.

En el contexto de Git/GitLab, la versión semántica se puede utilizar para etiquetar las versiones de los repositorios de código. Esto permite un control de versiones más detallado y la posibilidad de revertir a versiones específicas si es necesario.

2. COMANDOS Y EJEMPLOS PRÁCTICOS AVANZADOS

Comando para etiquetar una versión:

Comandos Bash Copiar
git tag -a v1.0.0 -m "Versión 1.0.0"

Comando para ver las etiquetas:

Comandos Bash Copiar
git tag

Comando para subir las etiquetas al repositorio remoto:

Comandos Bash Copiar
git push origin --tags

Comando para borrar una etiqueta:

Comandos Bash Copiar
git tag -d v1.0.0

Configuraciones avanzadas en GitLab: Puedes crear una pipeline en GitLab CI/CD que se dispare cuando se añada una nueva etiqueta. Esto se puede hacer en el archivo `.gitlab-ci.yml` añadiendo una regla en el trabajo que quieras disparar:

Comandos Yaml Copiar
deploy:
  script: ./deploy.sh
  rules:
    - if: '$CI_COMMIT_TAG'

Ejercicios Prácticos Visuales

1

Crear una nueva etiqueta

Básico 8-13 min
Ejercicio 1: Crear una nueva etiqueta
  • Objetivo: Aprender a crear una etiqueta de versión semántica.
  • Dificultad: Fácil
  • Tiempo estimado: 10 minutos
  • Instrucciones: Crea una nueva etiqueta con la versión semántica v1.0.
0. Para hacer esto, utiliza el comando `git tag -a v1.0.0 -m "Versión 1.0.0"`. - Criterios de éxito: La etiqueta v1.0.0 aparece cuando ejecutas `git tag`.

Ejercicio 2: Subir las etiquetas al repositorio remoto - Objetivo: Aprender a subir las etiquetas al repositorio remoto. - Dificultad: Media - Tiempo estimado: 15 minutos - Instrucciones: Sube la etiqueta que has creado al repositorio remoto utilizando el comando `git push origin --tags`. - Criterios de éxito: La etiqueta v1.0.0 aparece en el repositorio remoto.

4. PROBLEMAS COMUNES Y SOLUCIONES AVANZADAS

Problema 1: Error al subir las etiquetas al repositorio remoto - Diagnóstico: Este problema puede ocurrir si no tienes permisos para subir etiquetas al repositorio remoto. - Solución: Comprueba tus permisos en el repositorio remoto. Si no tienes permisos, pídele a alguien que los tenga que suba las etiquetas.

5. MEJORES PRÁCTICAS EMPRESARIALES

  • Utiliza la versión semántica para etiquetar las versiones de tu software.
  • Utiliza las etiquetas de Git para marcar las versiones semánticas en tu repositorio.
  • Sube las etiquetas al repositorio remoto para que todo el equipo tenga acceso a ellas.
  • Utiliza GitLab CI/CD para automatizar el despliegue de nuevas versiones cuando se añada una nueva etiqueta.
  • No borres las etiquetas una vez creadas, ya que representan un punto en la historia de tu proyecto.