Files
inbuxa-installer/internal/release/release.go
T
jcoffey-dev b6f11f0d6c
ci / test (pull_request) Successful in 55s
Add pin-check: catch release pins that have fallen behind upstream
A fresh install ships whatever internal/release/release.go names, so a
pin left behind is a fresh install shipped stale -- and, when the release
it skipped fixed a vulnerability, shipped vulnerable. The server, console
and webmail pins have each gone stale before.

pin-check reads each component's releases from the Gitea API and reports
when the pinned version is behind the newest release in its channel. The
channel follows the pin: a candidate pin (27.1-rc.15) tracks newer 27.1
candidates and the 27.1 final, and the check stays in the pin's own
major.minor series -- a later flagship (27.2) or the parallel
calendar-versioned maintenance line (2026.x) the suite ships alongside
is a deliberate move to a new installer line, not a pin bump.

It only reads; it never edits release.go. The move stays a reviewed
change with the new checksums taken from each release's signed
SHA256SUMS. The tool exits 10 when anything is stale, so the weekly
.gitea/workflows/pin-check.yml run turns a stale pin into a red run and,
with --issue, a self-updating tracking issue.

The version/compare/channel logic is a pure, unit-tested package; the
command's API reads and exit codes are covered with an httptest server.
Stdlib only.
2026-11-12 11:03:20 -07:00

133 lines
5.4 KiB
Go

// SPDX-FileCopyrightText: 2026 Coffey Labs LLC
// SPDX-License-Identifier: AGPL-3.0-or-later
// Package release is which version of the mail server this installer puts on
// a machine, as an image or as a binary, and what that binary must hash to.
//
// One version for both shapes, so a server moved from a container to the host
// is the same program, and the plan, the image tag and the download cannot
// name three different releases.
//
// A release candidate of the installer (v27.1-rc.1) pins the suite's release
// candidates; a final release pins final releases only. Downloading an RC
// installer is the opt-in: it is published as a pre-release, so
// releases/latest, and so a plain install, never reaches one.
//
// A pin left behind is a fresh install shipped stale. The pin-check command
// (cmd/pin-check, run weekly by .gitea/workflows/pin-check.yml) reads each
// component's releases and reports when the version here is behind the newest
// in its channel, so the move is noticed and made before it ships.
package release
import (
"fmt"
"strings"
)
// ServerVersion is the inbuxa-server release this installer installs.
const ServerVersion = "27.1-rc.15"
// ServerImage is that release as a container image.
const ServerImage = "registry.coffeylabs.org/inbuxa/inbuxa-server:" + ServerVersion
// ServerSHA256 is the SHA-256 of each architecture's release tarball, copied
// from the release's SHA256SUMS when the version was moved and checked here
// rather than fetched beside the download: a checksum that arrives with the
// file only proves the file arrived.
var ServerSHA256 = map[string]string{
"amd64": "8d3ea5c7753d344b7222eeb70a902bd069c8c1868c6d3db4e467b77fce39fdc8",
"arm64": "ba6943074a8cc4636dbd88bac7802826c4a1bb1a329fb2e5cd52ff18c11a3413",
}
// ServerTarball is where the release's tarball for an architecture is.
func ServerTarball(arch string) string {
return fmt.Sprintf("https://git.coffeylabs.org/inbuxa/inbuxa-server/releases/download/v%s/inbuxa-linux-%s.tar.gz",
ServerVersion, arch)
}
// The console and the webmail as files, for host installs. Their releases
// attach these since inbuxa-admin #106 and inbuxa-webmail #68; a version
// with an empty checksum has none to install, and the host shape is
// unavailable until one does. INBUXA_CONSOLE_TARBALL and
// INBUXA_WEBMAIL_TARBALL name a local file instead, for testing.
const (
ConsoleVersion = "27.1-rc.10"
ConsoleSHA256 = "92e3ced41e92d6564a6e3b593d1903fd6777734d337978d6d2cc669f4d848ffe"
WebmailVersion = "27.1-rc.3" // its tag is inbuxa-v<this>
)
// WebmailSHA256 is the SHA-256 of each architecture's webmail tarball.
var WebmailSHA256 = map[string]string{
"amd64": "055fcdaaf322ea743a71df4dc0fd8b7ea12b15c07cc6008276d30c5e2508525f",
"arm64": "efc6b65e3377125b178c9d740733f396124a007d80809d48b33e6b5bca8ef3c5",
}
// ConsoleTarball is where the console's release tarball is.
func ConsoleTarball() string {
return fmt.Sprintf("https://git.coffeylabs.org/inbuxa/inbuxa-admin/releases/download/v%s/inbuxa-admin.tar.gz", ConsoleVersion)
}
// WebmailTarball is where the webmail's release tarball for an
// architecture is. Its tags are inbuxa-v<version>.
func WebmailTarball(arch string) string {
return fmt.Sprintf("https://git.coffeylabs.org/inbuxa/inbuxa-webmail/releases/download/inbuxa-v%s/inbuxa-webmail-linux-%s.tar.gz",
WebmailVersion, arch)
}
// inbuxa Relay, for a machine of its own in front of the server: the
// static inbuxa-relay binary each server release attaches since
// inbuxa-server #271, with a .sig file beside it signed by an inbuxa release
// key. Its release is the server's, so a relay this installer puts in place
// runs the version the server it joins does. A version with an empty
// checksum has no relay to install. INBUXA_RELAY_BINARY names a local file
// instead, for testing.
//
// RelaySHA256 is the SHA-256 of each architecture's relay binary.
var RelaySHA256 = map[string]string{
"amd64": "6e3540c2caec049a7451d268f46f06de1f515b0834ccb480add2faa736291868",
"arm64": "aea34f49c8de3fb1c0bd3b9579fc70f7bad8efe1a832369cff78217141158a76",
}
// RelayKeys are the inbuxa release keys that sign a relay binary, as
// crates/relay-proto/src/release.rs holds them: the CI key, then the one
// kept offline. Base64url, no padding.
var RelayKeys = []string{
"J0kY_vzXTC8T8gxErBMYI6cVk4Bwki65HlJGoDp15uw",
"vGsTE95CJ3vbGKVtfQctFEp0fOZ4wQ9QWTOFe0KF7_8",
}
// RelayVersion is the server's release as the relay names itself, in its
// --version and its .sig file: the Cargo version, 27.1.0-rc.4 for 27.1-rc.4.
func RelayVersion() string { return CargoVersion(ServerVersion) }
// CargoVersion is a release version with the patch number SemVer wants:
// 27.1 is 27.1.0, and 27.1-rc.4 is 27.1.0-rc.4.
func CargoVersion(v string) string {
core, pre, hasPre := strings.Cut(v, "-")
if strings.Count(core, ".") == 1 {
core += ".0"
}
if hasPre {
return core + "-" + pre
}
return core
}
// RelayTarget is what a relay binary's .sig file names an architecture.
func RelayTarget(arch string) string {
switch arch {
case "amd64":
return "x86_64-linux-musl"
case "arm64":
return "aarch64-linux-musl"
}
return arch + "-linux-musl"
}
// RelayBinary is where the release's relay binary for an architecture is;
// its .sig file is beside it, with ".sig" added.
func RelayBinary(arch string) string {
return fmt.Sprintf("https://git.coffeylabs.org/inbuxa/inbuxa-server/releases/download/v%s/inbuxa-relay-%s",
ServerVersion, RelayTarget(arch))
}