Orbit
Versiones de Orbit
The Releases tab turns your git tags into a version history you can read: every tagged deployment, in order, with its commit, its author, its status and a link straight to the tag in your repository.
La pestaña Releases convierte tus etiquetas git en un historial de versiones que puedes leer: cada despliegue etiquetado, en orden, con su commit, su autor, su estado y un enlace directo a la etiqueta en tu repositorio.
Dónde vive Releases
Abre Orbit, haz clic en el proyecto y elige Releases bajo el grupo Deployments en la franja de pestañas del proyecto. La página se titula Releases y se describe a sí misma como despliegues basados en etiquetas: se crea un release cuando una etiqueta git coincide con tu patrón de etiquetas.
La pestaña Deployments vecina lista cada construcción, etiquetada o no. Releases es la vista filtrada: solo las que marcaste como una versión.
Configurar el patrón de etiquetas
Los releases comienzan con un patrón. Abre Settings, encuentra la tarjeta Git tag deploys e introduce un glob como v* o release-*. Si lo dejas vacío, se desactivan completamente los despliegues por etiqueta, por eso el texto de marcador de posición del campo dice v* (disabled).
Con un patrón establecido, al enviar una etiqueta coincidente se despliega a producción y se registra el resultado como un release. Sin uno, la pestaña Releases muestra un estado vacío pidiéndote que envíes una etiqueta y establezcas un patrón en Settings.
Un patrón de etiqueta te da una segunda ruta explícita a producción junto a los envíos a la rama de producción. Los equipos que quieren que los despliegues sean un acto deliberado en lugar de un efecto secundario de la fusión a menudo desactivan el auto-despliegue de rama e impulsan la producción solo desde etiquetas.
Cortar un Release
El flujo completo desde tu lado son dos comandos git:
git tag -a v1.4.0 -m "Checkout flow rebuild"
git push origin v1.4.0
Orbit recibe la etiqueta, la compara con tu patrón, despliega el commit etiquetado a producción y registra un release. Aparece en esta pestaña con una insignia Building y cambia a Deployed cuando se completa, o Failed si la construcción generó un error.
Usa etiquetas anotadas en lugar de las ligeras. Una etiqueta anotada lleva un mensaje, un autor y una fecha, todo lo cual termina en el release.
Etiquetar un despliegue existente
No tienes que enviar una etiqueta git para obtener un release. Cualquier despliegue se puede etiquetar desde su página de detalles, y una etiqueta que se parece a un número de versión se recoge aquí.
Una etiqueta con forma de versión es una como 1.4, 1.4.0, v1.4.0 o v2.0.0-rc1. Cualquier otra cosa se mantiene como una etiqueta de despliegue normal y no crea una entrada de release.
Esta es la válvula de escape para el caso en el que un release se publicó antes de configurar el patrón, o donde un hotfix se desplegó manualmente y quieres que esté en el historial de versiones de todas formas.
Leer un Release
Cada fila de release muestra:
- La etiqueta, como el título del release.
- El commit y su mensaje.
- El autor, mostrado como by nombre.
- El entorno al que se envió, codificado por color según el tipo.
- Una insignia de estado: Deployed, Building o Failed.
- Un enlace View on a la etiqueta en tu repositorio.
- Un enlace al despliegue subyacente.
El enlace View on apunta al lugar correcto según el proveedor: la página de releases en GitHub, la página de etiqueta en GitLab, o la fuente en esa etiqueta en Bitbucket.
Notas de release
Si publicas un release en tu repositorio para una etiqueta, las notas se extraen y se adjuntan al despliegue, por lo que la pestaña Releases lleva el mismo texto que escribiste en tu repositorio en lugar de obligarte a mantener dos copias.
Eso convierte al repositorio en el único lugar para escribir notas de release. Escríbelas una vez, donde tus colaboradores ya están, y aparecerán aquí.
Un Release por etiqueta
La lista se desduplica por etiqueta: si una etiqueta se ha desplegado más de una vez, por ejemplo porque la primera construcción falló y reintentas, solo se muestra el despliegue más reciente para esa etiqueta.
El contador en la parte superior da el total, y la lista cubre una ventana generosa de despliegues etiquetados recientes en lugar de todo el historial del proyecto.
Usar Releases bien
Etiquetar en la fusión, no en la rama. Etiqueta el commit que está realmente en tu rama de producción. Etiquetar un commit de rama de características que no ha sido fusionado produce un release que no corresponde a nada en main.
Usa versiones semánticas. Se ordenan correctamente, se reconocen como versiones con forma, y todos ya saben cómo leerlas.
Nunca muevas una etiqueta. Redirigir una etiqueta existente a un nuevo commit significa que el release en esta lista y la etiqueta en tu repositorio ahora están en desacuerdo sobre qué se envió. Corta una nueva versión de parche en su lugar.
Un envío de etiqueta se despliega directamente a producción si coincide con tu patrón. Eso no evita nada más: los bloqueos de despliegue, los requisitos de aprobación y las ventanas de congelación se aplican según se configure. Pero significa que una etiqueta enviada por error es un despliegue a producción, no un borrador. Consulta Deploying Your Project para las puertas disponibles.
Revertir un Release
Los releases son despliegues, por lo que revertir uno es el flujo de reversión ordinario: abre el despliegue y restaura el anterior exitoso. Consulta Rolling Back a Deployment.
Después, corta una nueva etiqueta para la corrección en lugar de eliminar la mala. El release fallido permaneciendo visible en el historial es información útil, no desorden.
Solución de problemas
Se envió una etiqueta pero no apareció ningún release. Verifica el patrón en Settings, luego verifica que la etiqueta realmente llegó al remoto. git push origin v1.4.0 envía una etiqueta; git push solo no envía ninguna.
El release muestra Failed. La construcción falló, exactamente como lo haría para un envío de rama. Abre el despliegue y lee el registro: Reading Build Logs.
Falta el enlace View on. El proyecto no tiene un repositorio conectado, por lo que no hay nada a lo que vincularse. Conecta uno: consulta Connecting a GitHub Repository.
Un despliegue etiquetado manualmente no está listado. La etiqueta no tiene forma de versión. Renómbrala a algo como v1.4.0.
Las notas de release están vacías. Las notas se extraen de un release publicado en tu repositorio. Una etiqueta desnuda sin un objeto de release no tiene notas para extraer.
Dónde ir a continuación
- Deploying Your Project para el ciclo de despliegue completo y sus puertas.
- Rolling Back a Deployment cuando un release sale mal.
- Orbit Timeline Annotations para registrar qué cambió un release.