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¶

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:

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¶

• Changelog - Kompakte Änderungsübersicht
• Spezifikationen - Technische Spezifikationen