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.
Versionamiento Semántico con GitHub Actions (Windows)
Cutberto Hernández
Created on March 24, 2025
Start designing with a free template
Discover more than 1500 professional designs like these:
View
Essential Course
View
Practical Course
View
Basic Interactive Course
View
Course 3D Style
View
Minimal Course
View
Neodigital CPD Course
View
Laws and Regulations Course
Explore all templates
Transcript
Versionamiento Semántico con GitHub Actions (Windows)
Empezar
¿Que es el versionamiento semántico?
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.