Zum Inhalt springen

Target Versions

Deployments Configuration

Eine Target Version pinnt ein Deployment auf eine bestimmte Tool-Bundle-Version. Wenn du eine Target Version setzt, laden alle Edge Connectors in diesem Deployment genau diese Version des Tool-Bundles herunter und verwenden sie — unabhängig davon, ob neuere Versionen veröffentlicht wurden.

Das gibt dir präzise Kontrolle über Rollouts. Du kannst eine neue Bundle-Version in einem Staging-Deployment testen, bevor du sie in die Produktion bringst, oder auf eine bekannte stabile Version zurückrollen, falls Probleme auftreten.

  1. Navigiere zu Admin > Deployments und öffne das Deployment, das du konfigurieren möchtest.

  2. Finde das Feld Target Version in den Deployment-Einstellungen.

  3. Wähle eine bestimmte Bundle-Version aus dem Dropdown. Die Liste zeigt alle veröffentlichten Versionen mit Zeitstempeln und Checksummen.

  4. Klicke auf Save. Verbundene Edge Connectors übernehmen die neue Target Version beim nächsten Sync-Zyklus.

Bundle-Zuweisungen verknüpfen ein bestimmtes Tool-Bundle mit einem Deployment. Das legt fest, welche Tool-Implementierungen Edge Connectors in diesem Deployment herunterladen und ausführen.

Ein Bundle pro Deployment

Jedem Deployment wird ein einzelnes Tool-Bundle zugewiesen. Wenn du die Bundle-Zuweisung änderst, laden die Connectors das neue Bundle beim nächsten Sync herunter.

Version-Pinning

Kombiniere die Bundle-Zuweisung mit einer Target Version, um ein Deployment auf einen bestimmten Snapshot eines Tool-Bundles festzulegen.

Um ein Bundle zuzuweisen:

  1. Öffne das Deployment unter Admin > Deployments.

  2. Wähle im Abschnitt Tool Bundle das Bundle aus, das du zuweisen möchtest, aus der Liste der verfügbaren Bundles.

  3. Setze optional eine Target Version, um das Deployment auf eine bestimmte Version des ausgewählten Bundles zu pinnen.

  4. Speichere das Deployment. Die Zuweisung wird beim nächsten Connector-Sync wirksam.

Edge Connectors fragen die Plattform in regelmäßigen Abständen nach Bundle-Updates ab:

  • Standard-Abfrageintervall — alle 10 Minuten.
  • Wenn ein Connector feststellt, dass seine aktuelle Bundle-Version von der Target Version des Deployments abweicht (oder von der neuesten Version, falls keine Target Version gepinnt ist), lädt er das aktualisierte Bundle automatisch herunter.
  • Der Download ist atomar: Das neue Bundle wird vollständig heruntergeladen und validiert, bevor es die vorherige Version ersetzt. Laufende Tool-Aufrufe verwenden weiterhin das alte Bundle, bis sie abgeschlossen sind.

Du kannst ein Standard-Bundle für deine Organisation festlegen. Wenn ein neues Deployment ohne explizite Bundle-Zuweisung erstellt wird, erhält es automatisch das Standard-Bundle.

Navigiere zu Admin > Settings > Tool Bundles und markiere das gewünschte Bundle als Organisations-Standard.

Die Edge Connector CLI bietet Befehle zum Verwalten von Bundles und Target Versions:

BefehlBeschreibung
edge-connector bundle set-default --bundle <id>Setzt das Standard-Bundle für die Organisation
edge-connector bundle assign --deployment <id> --bundle <id>Weist einem Deployment ein bestimmtes Bundle zu
edge-connector bundle listListet alle verfügbaren Bundles und ihre Versionen
edge-connector bundle info --bundle <id>Zeigt Details zu einem bestimmten Bundle inkl. veröffentlichter Versionen

Deployments sind über die Registrierung mit Devices (Edge-Connector-Instanzen) verknüpft. Wenn ein Edge Connector startet, registriert er sich bei einem bestimmten Deployment. Diese Beziehung bestimmt:

  • Welches Bundle der Connector herunterlädt — das dem Deployment zugewiesene Bundle.
  • Welche Version der Connector nutzt — die im Deployment gepinnte Target Version, oder die neueste, falls keine gepinnt ist.
  • Wie der Connector im Monitoring erscheint — Connectors werden im Admin-UI nach Deployment gruppiert.

Ein einzelnes Deployment kann mehrere Devices (Edge Connectors) registriert haben. Jedes Device synchronisiert das Bundle unabhängig und meldet seinen Status an die Plattform.