fix: add musl linux installer assets

Author: robinbraemer

.goreleaser.yml

@@ -3,16 +3,40 @@ before:
   hooks:
     - go mod download
 builds:
-  - env: [ CGO_ENABLED=0 ]
+  - id: gate
+    env: [ CGO_ENABLED=0 ]
     ldflags:
       - "-s -w"
       - "-X 'go.minekube.com/gate/pkg/version.Version={{.Version}}'"
     goos:
       - linux
       - windows
       - darwin
+  - id: gate-musl
+    env: [ CGO_ENABLED=0 ]
+    tags:
+      - musl
+    ldflags:
+      - "-s -w"
+      - "-X 'go.minekube.com/gate/pkg/version.Version={{.Version}}'"
+    goos:
+      - linux
+    goarch:
+      - amd64
+      - arm64
+      - '386'
 archives:
-  - format: binary
+  - id: gate
+    ids:
+      - gate
+    formats:
+      - binary
+  - id: gate-musl
+    ids:
+      - gate-musl
+    formats:
+      - binary
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}{{ with .Arm }}v{{ . }}{{ end }}{{ with .Mips }}_{{ . }}{{ end }}{{ if not (eq .Amd64 \"v1\") }}{{ .Amd64 }}{{ end }}_musl"
 checksum:
   name_template: 'checksums.txt'
 changelog:

.web/docs/guide/install/binaries.md

@@ -94,7 +94,13 @@ If you encounter any issues:
    - Try running the installation again
    - If it persists, please report it on our GitHub issues
 
-3. **Permission Denied**:
+3. **Linux binary does not run**:
+
+   - The installer selects `gate_*_linux_*_musl` automatically on Alpine/musl systems
+   - The musl binary is statically linked, but excludes native GeyserLite managed mode and Honeycomb OpenTelemetry auto-configuration
+   - For managed Bedrock on musl, set `bedrock.managed.engine: java`; for native GeyserLite or full OTEL support, use a glibc-based distribution/image such as Debian, Ubuntu, or Fedora, or run the official Docker image
+
+4. **Permission Denied**:
    - Our scripts install to user space and shouldn't require elevated privileges
    - If you see permission errors, ensure you have write access to the installation directory
 

.web/docs/public/build_tags_test.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+set -eu
+
+deps=$(go list -tags musl -deps ./cmd/gate)
+
+if printf '%s\n' "$deps" | grep -Eq '^(github.com/ebitengine/purego|go.minekube.com/geyserlite|github.com/honeycombio/otel-config-go/otelconfig)$'; then
+    echo "musl build still depends on geyserlite, purego, or Honeycomb OTEL auto-config" >&2
+    exit 1
+fi
+
+go test -tags musl ./cmd/gate ./pkg/internal/otelutil ./pkg/edition/bedrock/geyser