Zum Inhalt springen
Dokumentation
Entwickler-Leitfaden
Source Build

Source Build

Baue aus dem Quellcode, wenn du benutzerdefinierte Patches, Entwicklungs-Binärdateien oder Paketierungsarbeiten benötigst.

Voraussetzungen

  • Go, wie in mise.toml und go.mod deklariert.
  • Git, für Versionierung und Repository-Operationen.

Verwende mise, um die Projekt-Toolchain zu installieren:

mise install

Bauen mit dem Skript

Das Build-Skript schreibt die Ausgabe nach dist/<os>_<arch>/ und generiert Prüfsummen, wenn sha256sum verfügbar ist:

sh scripts/build/binaries.sh

Unter Linux baut es:

  • composia
  • composia-controller
  • composia-agent

Unter macOS und Windows baut es nur die CLI.

Build-Variablen

VariableStandardZweck
VERSIONgit describe --tags --always --dirtyIn Binärdateien eingebettete Version.
OUTPUT_DIRdistAusgabeverzeichnis.
GOOSHost-BetriebssystemZiel-Betriebssystem.
GOARCHHost-ArchitekturZiel-Architektur.
GOARMLeerARM-Variante, z.B. 7.
CGO_ENABLED0Statische Cross-Builds.

Beispiele:

GOOS=linux GOARCH=arm64 sh scripts/build/binaries.sh
GOOS=linux GOARCH=arm GOARM=7 sh scripts/build/binaries.sh

Manueller Go-Build 

LDFLAGS="-s -w -X forgejo.alexma.top/alexma233/composia/internal/version.Value=$(git describe --tags --always --dirty)"

CGO_ENABLED=0 go build -trimpath -ldflags "$LDFLAGS" -o composia ./cmd/composia
CGO_ENABLED=0 go build -trimpath -ldflags "$LDFLAGS" -o composia-controller ./cmd/composia-controller
CGO_ENABLED=0 go build -trimpath -ldflags "$LDFLAGS" -o composia-agent ./cmd/composia-agent

Container-Images bauen

Das Dockerfile im Wurzelverzeichnis hat Ziele für jede Laufzeitumgebung:

docker build --target cli -t composia-cli:local .
docker build --target controller -t composia-controller:local .
docker build --target agent -t composia-agent:local .
docker build --target dev -t composia-dev:local .

Das dev-Image enthält Go, Air, Docker CLI, Docker Buildx, Docker Compose und Git.

Zuletzt aktualisiert am • Renovate Bot
Controller-Referenz