Polycrate 0.29.0

Polycrate 0.29.0

Veröffentlicht am: 2026-01-06

Highlights

Polycrate 0.29.0 bringt wesentliche Verbesserungen für den Kubernetes Operator und die CLI-Tools:

  • Operator Auto Workspace Resolution: Der Operator leitet workspace_id und organization_id automatisch vom Agent Token ab - keine manuelle UUID-Konfiguration mehr erforderlich.
  • Tools Overhaul: Kritische Panic-Fixes und verbesserte Flag-Handhabung.
  • Verbesserte Tool-Dokumentation: Alle 11 Tools mit umfassender englischer --help-Dokumentation.

Artefakte

Docker Images

# Multi-arch Image (linux/amd64, linux/arm64)
docker pull cargo.ayedo.cloud/library/polycrate:0.29.0
docker pull cargo.ayedo.cloud/library/polycrate:latest

CLI Downloads

Plattform Architektur Download
Linux amd64 Download
Linux arm64 Download
macOS amd64 Download
macOS arm64 Download

Installation & Update

# Bestehende Installation aktualisieren
polycrate update 0.29.0

# Neuinstallation
curl -sSL https://hub.polycrate.io/get/polycrate/0.29.0/$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/')/polycrate_0.29.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/').tar.gz | sudo tar -xz -C /usr/local/bin/

→ Installationsanleitung | Update-Anleitung

Neue Features

Operator Auto Workspace Resolution

Der Polycrate Operator erkennt jetzt automatisch den zugehörigen Workspace und die Organization anhand des Agent Tokens. Manuelle UUID-Konfiguration in der OperatorConfig ist nicht mehr erforderlich.

Vorher (< 0.29.0):

spec:
  api_sync:
    enabled: true
    api_url: "https://api.polycrate.io"
    credentials_ref:
      secret_name: polycrate-api-creds
      token_key: token
    workspace_id: "550e8400-e29b-41d4-a716-446655440000"  # Manuell!
    organization_id: "6ba7b810-9dad-11d1-80b4-00c04fd430c8"  # Manuell!

Nachher (0.29.0+):

spec:
  api_sync:
    enabled: true
    api_url: "https://api.polycrate.io"
    credentials_ref:
      secret_name: polycrate-api-creds
      token_key: token
    # workspace_id und organization_id werden automatisch abgeleitet!

Wie funktioniert es:

  1. Der Operator sendet einen Health-Report mit dem Agent Token
  2. Die API erkennt den zugehörigen Workspace anhand des Tokens
  3. workspace_id, workspace_name, organization_id, organization_name werden im Status gespeichert

Status-Abfrage:

kubectl get operatorconfig default -o yaml

status:
  api_sync:
    workspace_id: "550e8400-e29b-41d4-a716-446655440000"
    workspace_name: "production"
    organization_id: "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
    organization_name: "acme-corp"
    resolved_at: "2026-01-06T14:30:00Z"

→ Operator-Dokumentation

Bugfixes

Tools Command Overhaul

Das polycrate tools-Command wurde stabilisiert und mehrere kritische Panics behoben:

Behobene Fehler:

  1. Panic bei polycrate tools ohne Argumente

Der interaktive Tool-Selector führte zum Crash, wenn ein Tool mit erforderlichen Argumenten ausgewählt wurde (z.B. dns ohne Hostname). Der Selector nutzt jetzt Cobras Execute-Chain für korrekte Argument-Validierung.

  1. Flag-Konflikt bei polycrate tools pwgen

Der Shorthand -N für --numbers kollidierte mit dem globalen --docker-native Flag. Der Shorthand wurde zu -d (digits) geändert.

  1. polycrate tools diff ohne Farben

Der --color Flag hatte einen falschen Default-Wert. Farben sind jetzt standardmäßig aktiviert.

→ CLI-Referenz: Tools

Verbesserungen

Verbesserte Help-Dokumentation für alle Tools

Alle 11 Tools haben jetzt umfassende englische --help-Dokumentation mit:

  • Strukturierte Sektionen: EXAMPLES, FLAGS, USE CASES
  • Praxisnahe Beispiele für häufige Anwendungsfälle
  • Vollständige Flag-Beschreibungen

Betroffene Tools:

Tool Verbesserungen
base64 Encoding-Varianten, URL-safe Erklärung
cert Remote/File Modi, Chain-Validierung
check Protokolle (TCP/HTTP), Output-Metriken
cidr Subcommands (contains, split), IPv6-Support
diff Diff-Typen (+/-/~), semantische Erklärung
dns Record-Typen, Resolver-Optionen
hash Algorithmen mit Sicherheitshinweisen
jwt Claims-Erklärung, Sicherheitswarnung
pwgen Character-Sets, Algorithmen
timestamp Input-Formate, Go-Format-Referenz
wait Protokolle, Exit-Codes, Strict-Mode

Beispiel:

polycrate tools check --help

→ CLI-Referenz: Tools

Migration

Operator: workspace_id und organization_id entfernen

Falls in älteren Versionen workspace_id und organization_id im OperatorConfig Spec konfiguriert waren:

  1. Upgrade auf 0.29.0
  2. Entferne die Felder aus dem Spec (optional, sie werden einfach ignoriert)
  3. Überprüfe den Status - die Werte werden automatisch aufgelöst
# Überprüfen ob Werte aufgelöst wurden
kubectl get operatorconfig default -o jsonpath='{.status.api_sync}'

Tools: -N Flag bei pwgen

Der -N Shorthand für --numbers wurde zu -d geändert:

# Vorher (funktioniert nicht mehr)
polycrate tools pwgen -N

# Nachher
polycrate tools pwgen -d
polycrate tools pwgen --numbers

Technische Details

Abhängigkeiten

  • Polycrate API: Version 0.11.0+ erforderlich für Auto Workspace Resolution
  • Go: 1.23+
  • Kubernetes: 1.25+ für Operator

Weitere Informationen