Les releases de Barrel
Barrel est publié sous forme de bundle : un instantané daté de tout le dépôt, produit chaque fois que des applications changent de version et sont publiées, où chaque application est à la version qu’elle porte à ce commit. Lisez cette page quand vous voulez savoir quelles versions d’applications vont ensemble, déployer barrel_server depuis une release, ou épingler une dépendance sur un état connu.
Ce qu’est un bundle
Une fusion dans main qui passe la CI et change la version d’au moins une
application est un bundle nommé YYYY.MM.N : l’année et le mois de la fusion,
et N qui compte les bundles du mois à partir de 0 (2026.11.0, 2026.11.1,
...). Plusieurs bundles peuvent sortir le même jour. Une fusion qui ne change
la version d’aucune application ne publie rien.
Chaque bundle a un tag git vYYYY.MM.N et une release GitHub qui contient :
- la version de chaque application à ce commit, et la section du CHANGELOG de chaque application dont la version a changé depuis le bundle précédent ;
- des archives tar de
barrel_serverpour Linux x64, Linux arm64 et macOS arm64 ; - l’image
barrel-server,ghcr.io/barrel-db/barrel-server:YYYY.MM.N.
Les applications ne sont pas taguées séparément. Chaque application est publiée sur Hex sous sa propre version, que les notes du bundle enregistrent.
Trouver les versions des applications d’un bundle
gh release view v2026.11.8 --repo barrel-db/barrel
Ou depuis un clone :
git show v2026.11.8:apps/barrel_docdb/src/barrel_docdb.app.src | grep vsn
Lancer le barrel_server d’un bundle
L’archive tar contient son propre runtime Erlang :
gh release download v2026.11.9 --repo barrel-db/barrel -p 'barrel_server-2026.11.9-linux-x64.tar.gz'
mkdir barrel && tar xzf barrel_server-2026.11.9-linux-x64.tar.gz -C barrel
barrel/bin/barrel_server foreground
Ou l’image :
docker run -p 8080:8080 -e BARREL_AUTH_TOKENS=secret ghcr.io/barrel-db/barrel-server:2026.11.9
barrel/bin/barrel_server versions et le label
org.opencontainers.image.version de l’image donnent le bundle.
Épingler un bundle
Pour les bibliothèques, dépendez des versions Hex. Pour construire contre un état exact du dépôt, utilisez le tag du bundle :
{deps, [
{barrel, {git, "https://github.com/barrel-db/barrel.git", {tag, "v2026.11.8"}}}
]}.
Notes
:latestsuit le bundle le plus récent ; épinglez un tag de bundle en production.- Triez les bundles avec un tri qui comprend les versions (
sort -V,git tag --sort=v:refname) : au-delà de dix bundles dans un mois,2026.11.10se classe avant2026.11.9par ordre alphabétique. - Les bundles antérieurs au workflow de release ont été créés après coup aux commits qui changeaient la version d’une application vers une version publiée sur Hex ; ils ont des notes, mais ni archive tar ni image.
- Les tags
v0.2.0àv1.1.0sont antérieurs aux bundles et restent tels quels.