Releases

Wat er in een release zit

Een release bestaat uit images en de command line tool bl, met hetzelfde versienummer.

Images, in ghcr.io/buildinglinks, voor linux/amd64 en linux/arm64, openbaar te downloaden:

Image	Voor wie
connector	elke deelnemer: control plane, data plane en de beheeromgeving
building	deelnemers die de gebouwservice willen (optioneel)
authority	de beheerder van een dataspace: de Trust Authority
sim	alleen de simulatie: gesimuleerde systemen en apps, een gesimuleerde vertrouwensdienst
dss	de controle van gekwalificeerde handtekeningen bij de Trust Authority, met een eigen versie

De command line tool bl, voor Linux, macOS (Intel en Apple Silicon) en Windows, staat bij de releases van github.com/buildinglinks/cli, met een installatiescript. Op Linux en macOS:

curl -fsSL https://github.com/buildinglinks/cli/releases/latest/download/bl-installer.sh | sh
bl --version

Het script zet bl in ~/.local/bin. De broncode is niet openbaar; de openbare repository bevat de handleiding van bl en de releases.

Wat een versienummer betekent

Een versie heeft drie cijfers, zoals 0.2.0. De tag van een release (v0.2.0) en de versie in de code moeten gelijk zijn, anders worden er geen images gebouwd. Elk image krijgt de tag van zijn versie, en latest wijst naar de laatst gebouwde release.

• Voor 1.0 kan een nieuw tweede cijfer dingen breken: het protocol tussen connectors, het contract met je backend en het schema van de database. Van 0.1 naar 0.2 gebeurde dat allemaal; zie upgraden.
• Een vastgelegd beleid voor wat een derde cijfer mag veranderen, hoe lang een versie ondersteuning krijgt en welke versies met elkaar samenwerken, is er nog niet.

Gebruik in productie daarom altijd een vaste versie, nooit latest, en werk bij zoals bij upgraden staat.

Wat er draait

Elk onderdeel noemt zijn versie met de commit waaruit het is gebouwd, bijvoorbeeld 0.2.0+4ecb134:

• in /healthz van control plane, data plane, gebouwservice en Trust Authority;
• in de heartbeat naar de Trust Authority, die zo ziet welke versies er in de dataspace draaien;
• in de uitvoer van bl --version, als 0.2.0 (4ecb134).

bl en de images horen bij elkaar: bl sim start start standaard de images met de versie van bl zelf.

TechnischEen image controleren

De images hebben het label org.opencontainers.image.revision met de commit, en org.opencontainers.image.source met de repository waaruit ze komen. Of een image er voor beide architecturen is, zie je met:

docker manifest inspect ghcr.io/buildinglinks/connector:0.2.0 | grep architecture