Canales de release
Stable, rc y canary - qué es cada canal, cómo instalarlo y qué esperar de él.
vexillum se publica por tres canales. La mayoría de la gente quiere stable, que es lo que da la instalación por defecto. Los otros dos existen para que puedas probar lo que viene antes de que se publique.
| Canal | Cómo se ve la versión | Qué es | Promesa |
|---|---|---|---|
| stable | v0.1.1 | El release oficial, cortado a mano. | El que conviene usar. |
| rc | vX.Y.Z-rc.N | Un release candidate: el build que está por convertirse en un stable. | Casi final, publicado para probarlo. |
| canary | v0.1.1-canary.20261011.gad39bc6 | Un build de lo último, hecho automáticamente. | Ninguna. |
Stable es el único canal que llega a Homebrew. Los builds rc y canary se publican como pre-releases de GitHub, así que nunca reemplazan la versión que te dan brew install o la instalación por defecto.
Stable
Los releases stable se cortan a mano, cuando el trabajo está listo. Es el canal por defecto:
brew install isaias-alt/tap/vexillumEl script de instalación nunca instala un pre-release por su cuenta: sin opciones instala el último release stable. Ver Instalación.
rc
Un rc (release candidate) se publica antes de un release stable para poder probar el release en sí. Es un pre-release de GitHub y no se ofrece por Homebrew ni en la instalación por defecto. Para instalar uno en particular, nombrá su versión:
curl -fsSL https://raw.githubusercontent.com/isaias-alt/vexillum/v0.1.1/scripts/install.sh | bash -s -- --version <rc-tag>Reemplazá <rc-tag> por un tag de rc real, con la forma vX.Y.Z-rc.N. Todavía no se publicó ningún rc; las versiones disponibles están en la página de releases de GitHub.
El primer stable es v0.1.0 y los rc aparecen más adelante. Correr el script sin --version instala el último stable, por Homebrew cuando brew está presente, y nunca el rc. Para probar un rc, pasá --version <rc-tag>: es una descarga directa que saltea Homebrew.
Canary
Un canary es un build de lo último que se trabajó. Se hace uno cada noche, y solo cuando hay algo nuevo desde el anterior, así que una semana tranquila no produce builds. Un canary nunca se convierte en un release stable por sí solo, y nunca llega a Homebrew.
La ejecución nocturna es opt-in. Solo corre cuando la variable de repositorio CANARY_NIGHTLY vale true (Settings, Secrets and variables, Actions, Variables). Si la variable no existe, o tiene cualquier valor distinto de true, el job nocturno se saltea. Una ejecución manual del workflow Canary siempre funciona, sin importar la variable. Esto importa si hacés un fork del repositorio: no se publica nada hasta que lo activás.
Instalá el último canary con la opción --channel:
curl -fsSL https://raw.githubusercontent.com/isaias-alt/vexillum/v0.1.1/scripts/install.sh | bash -s -- --channel canaryLa instalación de un canary es siempre una descarga directa, aunque Homebrew esté en tu PATH. El script verifica el checksum sha256 del archivo, instala vx en /usr/local/bin (o en ~/.local/bin cuando no podés escribir ahí) e imprime el build exacto que instaló:
vx --versionCanary no tiene promesa de estabilidad
Un canary puede traer trabajo sin terminar, cambiar de comportamiento de un build al siguiente o romperse. No lo uses para un trabajo que no podés permitirte interrumpir. Si algo se rompe, volvé a stable.
Cada canary es un build aparte, con su propia versión: el siguiente patch después del último stable, la fecha del build y el commit del que salió, como en v0.1.1-canary.20261011.gad39bc6. Se documenta solo en GitHub: abrí el release de su versión para ver qué cambió en ese build, y leé el proyecto tal como estaba en esa versión. Los builds canary viejos se limpian pasado un tiempo, así que fijá un canary solo mientras lo estás probando.
Volver a stable
Borrá el vx del canary del directorio que imprimió el mensaje de la instalación (por ejemplo /usr/local/bin) e instalá stable de nuevo:
rm /usr/local/bin/vx
curl -fsSL https://raw.githubusercontent.com/isaias-alt/vexillum/v0.1.1/scripts/install.sh | bashSi antes instalaste con Homebrew, asegurate de que el vx que corre sea el que querés: vx doctor avisa cuando otro vx anterior en tu PATH tapa al que acabás de instalar.
Opciones de instalación
Estas opciones van después de bash -s -- cuando le pasás el script por pipe:
| Opción | Efecto |
|---|---|
--channel stable | El valor por defecto. Instala el último release stable, con Homebrew cuando está disponible. Nunca instala un pre-release. |
--channel canary | Instala el último build canary por descarga directa. |
--version <tag> | Instala exactamente ese release por descarga directa, por ejemplo v0.1.0 o vX.Y.Z-rc.N para un rc. La v inicial es opcional. |
--channel y --version no se pueden combinar: una versión ya nombra el release exacto. --help imprime la misma lista.