Versionamiento Semántico con GitHub Actions (Windows)

Versionamiento Semántico con GitHub Actions (Windows)

Empezar

¿Que es el versionamiento semántico?

• El versionamiento semántico sigue el formato MAJOR.MINOR.PATCH (ej. 1.2.3).
• Se usa para reflejar la naturaleza de los cambios en el código:
• - MAJOR: Cambios incompatibles que rompen versiones anteriores.
• - MINOR: Nuevas funcionalidades compatibles.
• - PATCH: Correcciones de errores sin cambios funcionales.

Buenas Prácticas del Versionamiento Semantico

Estructura Recomendada del Repositorio

Índice

Configuración del GH_TOKEN

YAML Versionamiento Semántico y Rollback

Escribe un subtítulo genial aquípara dar contexto

Commits convenionales

Riesgos y Soluciones

Ventajas

Conclusión

De acuerdo a las BP, se propone que:

Buenas Prácticas

- Usa etiquetas Git (`git tag`) para marcar versiones. - Utiliza commits convencionales como `feat:`, `fix:`, `BREAKING CHANGE:`. - Automatiza la generación de tags y changelogs con GitHub Actions. - Mantén ramas de versiones separadas (`release-x.y.z`).

Estructura recomendada del Repositorio

Archivos YAML para Actions

/.github/workflows/

Documentación técnica

/docs/

Ramas temporales de releases

/release-x.y.z/

Configuración de GH_TOKEN

1. Ve a GitHub → Settings → Developer Settings → Personal access tokens → Fine-grained tokens. 2. Haz clic en “Generate new token”. 3. Asigna nombre (ej: Semantic Release Token).4. Otorga acceso solo al repositorio correspondiente. 5. Permisos: Contents (read/write), Metadata (read), Actions (read/write), Administration (read/write). 6. Copia el token. 7. En el repositorio: Settings → Secrets → Actions → New repository secret. 8. Nombre: GH_TOKEN. Valor: el token copiado.

Estructura YAML's

Commits convencionales

- feat: Nueva funcionalidad (MINOR)- fix: Corrección de errores (PATCH)- feat!: Cambio incompatible (MAJOR) Ejemplo:git commit -m "feat: exportar a PDF"

Riesgos y soluciones

❌ No se generan versiones: crea el tag inicial manualmente (v0.0.0). ❌ Push fallido: revisa permisos del token. ❌ Commits no reconocidos: aplica convención de mensajes.

Ventajas

✅Automatización del flujo de versiones y ramas. ✅Rollback controlado sin pérdida de código. ✅Más claridad en cada cambio aplicado.

Conclusión

Este flujo implementa versionamiento semántico automatizado compatible con GitHub Actions en entornos Windows, incluyendo rollback y control de versiones sin intervención manual.

Riesgos y soluciones

❌ No se generan versiones: crea el tag inicial manualmente (v0.0.0). ❌ Push fallido: revisa permisos del token. ❌ Commits no reconocidos: aplica convención de mensajes.

Ventajas

✅Automatización del flujo de versiones y ramas. ✅Rollback controlado sin pérdida de código. ✅Más claridad en cada cambio aplicado.

Conclusión

Este flujo implementa versionamiento semántico automatizado compatible con GitHub Actions en entornos Windows, incluyendo rollback y control de versiones sin intervención manual.