fur.im / composia
A self-hosted orchestration system crafted for power users. composia.xyz
Star
Fork 0
Watch
composia site content docs developer-guide source-build.de.md
2.1 kB
Markdown
at main

title: "Source Build" date: '2026-05-26T00:00:00+08:00' weight: 20 #

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 #

Variable Standard Zweck
VERSION git describe --tags --always --dirty In Binärdateien eingebettete Version.
OUTPUT_DIR dist Ausgabeverzeichnis.
GOOS Host-Betriebssystem Ziel-Betriebssystem.
GOARCH Host-Architektur Ziel-Architektur.
GOARM Leer ARM-Variante, z.B. 7.
CGO_ENABLED 0 Statische 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.