Skip to main content
Mit den Metadaten für zusätzliche Workloads können Sie eigene Überschreibungen von Helm-Werten an einzelne Vantage-Workload-Charts übergeben. Nutzen Sie diese Möglichkeit, wenn ein bestimmtes Deployment eine Anpassung erfordert, die die Custom-Resource Vantage nicht bereitstellt – etwa eine feste Anzahl von Replicas für einen einzelnen Service.
Dies ist eine fortgeschrittene Funktion, die nur als letztes Mittel dienen sollte. Überschreibungen wirken auf die internen Werte einzelner Charts von Vantage-Komponenten, die sich zwischen Vantage-Versionen ohne Vorankündigung ändern können. Prüfen Sie Ihre Überschreibungen bei jedem Upgrade und bevorzugen Sie die unterstützten Felder unter Vantage.spec sowie die automatische Skalierung mit KEDA, soweit diese Ihren Bedarf abdecken.

​
Funktionsweise

Das Chart vantage-selfhosted enthält eine Workloads-ConfigMap, die dem Operator mitteilt, welche Charts wie installiert werden sollen. Standardmäßig fügt das Chart dieser ConfigMap den Schlüssel additional-metadata.yml hinzu und befüllt ihn aus dem Chart-Wert workloadsConfigMap.additionalMetadata. Der Operator führt diesen Inhalt per Deep Merge mit den gerenderten Workloads-Metadaten zusammen, bevor er das jeweilige Komponenten-Chart installiert. Der Name des Schlüssels wird über vantage.workloads.additionalMetadataKey (Vantage.spec.workloads.additionalMetadataKey) gesteuert. Belassen Sie ihn beim Standardwert, sofern Sie keinen Grund haben, ihn umzubenennen. Den Feldvertrag finden Sie in der Helm-Chart-Referenz und in der API-Referenz. Das Schema für Überschreibungen richtet sich nach der Vorlage für Workloads-Metadaten, die in derselben ConfigMap unter dem Schlüssel workloads-metadata.yml.gotmpl hinterlegt ist. Das Chart benennt diese ConfigMap nach dem Muster <vantage.workloads.configMap>-<chart version>, zum Beispiel vantage-workloads-3.0.0. Prüfen Sie diesen Schlüssel, um zu sehen, welche Charts und Wertepfade in Ihrer installierten Version verfügbar sind.

​
Beispiel: Anzahl der Replicas für einen Service festlegen

Um die Anzahl der Deployment-Replicas für den Chart mail-helm zu überschreiben, übergeben Sie beim Installieren oder Aktualisieren des Charts vantage-selfhosted die folgenden Werte:
Fügen Sie weitere Charts unter charts hinzu, jeweils mit einem eigenen values-Block.

​
Einschränkungen

  • Werte aus der Vorlage haben Vorrang. Ihre additionalMetadata werden per Deep Merge mit dem gerenderten Inhalt von workloads-metadata.yml.gotmpl zusammengeführt, wobei die Vorlage bei Konflikten Vorrang hat. Sie können Werte hinzufügen oder ändern, die die Vorlage nicht setzt; Werte, die sie setzt, lassen sich jedoch nicht überschreiben.
  • order wird ignoriert. Ein in additionalMetadata definierter order-Schlüssel hat keine Auswirkung auf die Installationsreihenfolge der charts.
  • Keine Validierung zur Installationszeit. Ein additionalMetadata-Wert mit einem ungültigen schema wird bei der Installation des chart nicht abgelehnt. Der Fehler wird ausschließlich im status der Vantage-Ressource sichtbar. Prüfen Sie die conditions der Ressource, nachdem Sie Änderungen angewendet haben; siehe Lifecycle.
  • Änderungen erfordern eine erneute Verarbeitung. Wenn Sie additionalMetadata bearbeiten, ohne zugleich die Vantage-Ressource zu ändern, wendet der Operator die Änderung nicht an. Versehen Sie die Vantage-Ressource mit der Annotation vantage.abbyy.com/reprocess, um eine Synchronisierung zu erzwingen, wie unter Lifecycle beschrieben.

​
Wie geht es weiter

Helm-Chart-Referenz

Alle Werte von vantage-selfhosted, einschließlich workloadsConfigMap.additionalMetadata.

Automatische Skalierung mit KEDA

Der unterstützte Weg, Vantage-Workloads bedarfsgerecht zu skalieren.