ci / test (pull_request) Successful in 55s
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.
133 lines
5.4 KiB
Go
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))
|
|
}
|