Polycrate

ayedo Werkzeug- und Modellkette fuer Workspaces, Blocks, Specs und Releases.

48 von 278 Einträgen

Platform-Nameserver

Feste ayedo-Nameserver (ns1/ns2/ns3.ayedo.cloud) für Delegation beim externen Registrar oder in einer fremden Elternzone.

Polycrate Essentials Workshop

Hands-on Polycrate Workshop: Infrastructure-as-Code Grundlagen, GitOps Workflows und kollaborative DevOps Teams. Lernen Sie Polycrate in einem Tag. Made in Germany.

Polycrate Platform Building Workshop

Individueller Beratungs- und Hands-on Workshop: Infrastruktur-Planung, Software Development Lifecycle und Aufbau interner Entwicklungskapazitäten. Für MSPs und IT Teams. Made in Germany.

S3 Storage

S3-kompatibler Object Storage auf CEPH – betrieben von ayedo auf EU-Infrastruktur. Für Backups, Application Data und Static Files mit planbaren Kosten ab 0,05€/GB/Monat.

Loadbalancer

EU-weites Anycast-TCP-Loadbalancing (Layer 4) – betrieben von ayedo auf eigener Infrastruktur. Eigenes AS, BYOIP und integriertes Endpoint Monitoring. Made in Germany.

Software an Enterprise-Kunden ausliefern

On-Premises- und Air-Gap-Auslieferung Ihrer Software: wiederverwendbare Workspace-Vorlagen, Runbooks und Update-Prozesse – oder Betrieb durch ayedo. Set-and-Forget für komplexe Zielsysteme.

Endpoint Monitoring

Proaktive Verfügbarkeitsüberwachung für cloud-native Software – betrieben von ayedo mit Security Assessments nach OWASP Top 10. Teil des zertifizierten Software Delivery Lifecycle. Made in Germany.

Workspace-Verschlüsselung

Eingebaute Verschlüsselung für sensible Workspace-Daten auf Basis von age: secrets.poly und Dateien unter artifacts/secrets/ werden als .age-Dateien sicher in Git gespeichert. Beschreibt Schlüsselverwaltung, Polycrate-API-Integration und Do's and Don'ts.

Spec-Driven Development

Spec-Driven Development mit Polycrate: Specs planen, implementieren, dokumentieren und versionieren. Kanonischer Flow für Workspace- und Block-Releases, exakte Gate-Tabelle, Agent-Integration.

Warum Polycrate?

Gründe für Polycrate: einfache Actions statt Tool-Chaos, Toolchain im Container, eine zentrale workspace.poly, Teamfähigkeit, Weiternutzung bestehenden Codes, Ansible-Integration, OCI-Registry für Blocks und Git.

Troubleshooting

Leitfaden zur Lösung häufiger Probleme mit Polycrate: Docker, Workspace, Blocks, Actions, Workflows, SSH und Performance mit Problembeschreibung und Lösungsschritten.

Workspaces

Ein Workspace ist der Ordner, in dem Polycrate Konfiguration, Credentials und Lifecycle-Artefakte zusammenführt. Beschreibt Directory-Layout, Initialisieren, Klonen über die Polycrate API, Organisation und Naming, Auflisten sowie hybride Workspaces.

Workflows

Workflows orchestrieren mehrere Block-Actions in definierter Reihenfolge in der workspace.poly, mit sequenziellen Steps, Bestätigungs-Prompts und allow_failure. Beschreibt Definition und Ausführung mit polycrate run.

Vererbung

Block-Vererbung erlaubt, dass ein in der workspace.poly instanziierter Block per from: von einem Template-Block erbt: Konfiguration per Deep-Merge, überschreibbare Actions und Working Directory. Vererbung ist auf ein Level beschränkt.

Snapshot

Bei jeder Action erstellt Polycrate einen Snapshot des Workspace-Zustands für Reproduzierbarkeit, Template-Injection und Debugging. Die Seite beschreibt Mechanismus, Inhalt und Inspektion mit --snapshot.

Updates

Aktualisierung der Polycrate CLI über den Auto-Updater mit polycrate update oder gezielt auf eine bestimmte Version aus dem Polycrate Hub.

SSH

Native SSH-Integration der Polycrate CLI für Hosts aus dem Ansible-Inventory: Hosts anzeigen, Verbindung per Hostname oder interaktiver Auswahl, Ad-hoc-Befehle, Port-Forwarding-Tunnel, Dateien kopieren und Shell-Autocompletion.

Operator-Deployment

Die Polycrate API zeigt, welche Cluster den Polycrate-Operator in welcher Version installiert haben und steuert den Rollout neuer Versionen über K8sCluster, K8sApp, Agent-Heartbeats, SystemConfig und Block-Rollout.

Organisationen & Workspaces

Hierarchisches Ressourcenmodell der Polycrate API: Organisationen mit Kontakten und Einstellungen, automatisch registrierte Workspaces mit PoP, Credential-Hierarchie und -Typen sowie Multi-Tenancy mit Isolation, Berechtigungen und SSO.

Vulnerability Management (Polycrate API)

Ab Polycrate API 0.32.0 verwaltet die Plattform einen Security-Bereich für App-bezogene Schwachstellen: CVE-Katalog, Vulnerability Products an Catalogue Apps, Findings und optionale Verknüpfung mit Incidents.

Pricing & Business Layer

Die Polycrate API verwaltet Produkte, Preisregeln und Verkaufshistorie nativ. Der Business Layer mit Product, OrganizationProduct und Support-Auto-Assignment ist Grundlage für Abrechnung und Ressourcen-Kosten.

Operations-Dashboard

Das Operations-Dashboard fasst den Betriebszustand der Plattform zusammen: überfällige Backups, abgelaufene Zertifikate, firing Alerts, Wartungen und weitere Sektionen mit Summary-Strip, basierend auf Conditions und Metriken.

Workspace Composer

Der Workspace Composer erlaubt das direkte Bearbeiten von workspace.poly und secrets.poly in der Web-UI ohne Git-Checkout für Workspaces ohne Git-Sync, mit Validierung, CatalogueApp-Sidebar und Monaco-Editor.

Metriken der Polycrate API

Die Polycrate API stellt Metriken in drei Schichten über ein gemeinsames Contract-Pattern bereit: Prometheus-Export unter /api/v1/metrics, System-Metriken und Objekt-Metriken, alle gegen VictoriaMetrics abgefragt.

Provider Accounts

Ein Provider Account ist die benannte Verbindung zu einer Provider-API wie Hetzner Cloud, OpenStack/OTC, OVH, IONOS, Proxmox oder OpenAI-kompatiblen Endpunkten. Secrets liegen in einem Credential, der Account trägt api_kind und Scope.

Wartungsfenster

Ein Wartungsfenster (MaintenanceWindow) ist eine wiederkehrende Policy-Vorlage für erlaubte Wartungsslots, etwa jeden Sonntag 02:00 bis 04:00. Beschreibt Kernfelder, Vorlaufzeiten und die Abgrenzung zur konkreten Wartung.

User Management, RBAC & Keycloak

Die Polycrate API ist seit 0.15.0 ein User-basiertes System mit Keycloak-Anbindung und rollenbasiertem Berechtigungssystem (RBAC). Beschreibt Admin- und Benutzerrollen, Organisationszugehörigkeit und API-Konventionen.

PoPs & Provider

Provider und Points of Presence (PoPs) bilden die Infrastruktur-Landkarte in Polycrate ab: Provider beantworten, wer eine Ressource betreibt, PoPs, wo sie läuft. Beide werden plattformweit gepflegt.

S3 Buckets & Object Storage

Die Polycrate API verwaltet S3-Cluster (MinIO, Ceph RadosGW) und S3-Buckets mit vollständigem Lifecycle. Buckets lassen sich über Web-UI, API oder deklarativ über Kubernetes Custom Resources anlegen.

Wartungen

Eine Wartung (Maintenance) ist ein konkretes, geplantes Event mit Start- und Endzeitpunkt, das Benutzer proaktiv informiert und in Activity- und Downtime-Timeline erscheint. Abgrenzung zum Wartungsfenster als Policy-Vorlage.

Projekte

Ein Project ist ein eigenständiges ManagedObject für Kundenprojekte, Onboardings oder interne Workstreams. Projekte aggregieren Aktivität, haben ein Embedded-Notes-Feld und sind Ziel für Zeiterfassung über Comment-Notes.

Regionen

Eine Region ist die generische Plattform-Service-Schicht für standortgebundene Infrastruktur wie Storage, Loadbalancing und Controlplanes. Sie löst die früheren Modelle S3Cluster und LoadbalancerRegion per Soft-Migration ab.

Production-Beispiel: Software Delivery Platform

Beispiel für eine Production-Ready Software Delivery Platform mit Polycrate auf Bare-Metal: HA-Kubernetes mit Floating IP, Hardening, Cilium, Longhorn, VictoriaMetrics, VictoriaLogs und cert-manager als Blocks in einem Workspace.

HTTP-SDKs

Typisierte HTTP-Clients für die Polycrate API in Go, Python und JavaScript/TypeScript aus einem GitHub-Repo auf Basis derselben OpenAPI-Beschreibung. Beschreibt Authentifizierung, Installation per Tag und Beispiele pro Sprache.

Registry

Polycrate-Blöcke werden wie Docker-Images in OCI-kompatible Registries gepusht und von dort gepullt, standardmäßig cargo.ayedo.cloud. Beschreibt Architektur, Authentifizierung über Docker Credential Helper, Konfiguration und Exclude-Patterns beim Push.

Recipes - Häufige Workflows

Praktische Beispiele für häufige Polycrate-Workflows: die kanonische Dev-and-Deploy-Kette mit Specs, Workspace- und Block-Release, Push, Pull und install sowie optionale Git- und CI-Integration.

PolyHub

hub.polycrate.io ist die zentrale Plattform des Polycrate-Ökosystems: Block Marketplace und Showroom, CLI-Download-Plattform und Update-Check-Server für polycrate update. Beschreibt Funktionen und die Nutzung als DataSource in der Polycrate API.

Loopback Integration

Die Polycrate API kann Cluster der externen Plattform Loopback typisieren und Metadaten wie Kubernetes-Version, Status und Zertifikatsrotation spiegeln. Abgrenzung zur ayedo Kubernetes Distro und Hinweise zur Kubeconfig-Synchronisation.

Management Commands

Ausgewählte Django-Management-Commands der Polycrate API für Betrieb, Wartung und Datenbereinigung, etwa für Alerts, Artefakte, Activities und Metriken, mit Zweck und typischen Optionen.

Endpoint-Monitoring

Das Endpoint-Monitoring prüft kontinuierlich die Erreichbarkeit interner und externer Dienste und leitet daraus den State von ManagedObjects, Downtimes und Notifications ab. Trennt Endpoint (was geprüft wird) von Agent (wer prüft).