Zum Hauptinhalt springen
Vantage 3.0 selbst gehostet wird in Form von zwei Helm-Charts ausgeliefert: vantage-operator (der Controller, der die Vantage-Custom-Resource überwacht) und vantage-selfhosted (das Chart, das die Vantage-Ressource und zugehörige Manifeste im von Ihnen gewählten Install-Namespace erstellt). Auf dieser Seite werden beide Charts sowie die Werte erläutert, die Sie am häufigsten festlegen. Details zu den CRD-Feldern finden Sie in der API-Referenz. Eine Installationsanleitung finden Sie unter Azure oder Selbstverwaltetes Kubernetes.
Installieren Sie zueinander passende Versionen von vantage-operator und vantage-selfhosted. Die auf dieser Seite angegebenen Standardwerte beziehen sich auf das neueste Release. Einige Werte sind in früheren Artefaktversionen nicht verfügbar. Alle Werte und Standardwerte eines bestimmten Release finden Sie auf der Seite mit den Helm-Chart-Werten des jeweiligen Release. Ihr Release finden Sie unter Releases.

vantage-operator

Wird einmal pro Cluster in einem Namensraum Ihrer Wahl installiert. Der Bediener gleicht die Vantage-Installation ab, die durch die Vantage-Custom-Resource definiert ist.
Installieren Sie pro Cluster nur eine Instanz dieses Charts. Die ClusterRole und die ClusterRoleBinding des Charts gelten clusterweit und verwenden feste Namen. Siehe Bekannte Einschränkungen.

Abschnitte der obersten Ebene

  • nameOverride / fullnameOverride: Überschreibt den vollständigen Namen des Charts teilweise (unter Beibehaltung des Release-Namens) oder vollständig. Standardmäßig nicht gesetzt.
  • manager: das Deployment des Bedieners: image, Container-args (Leader-Wahl ist standardmäßig aktiviert), env (Pod-Name und Namensraum über die Downward API), imagePullSecrets, Sicherheitskontexte für Pod und Container (non-root, keine Rechteausweitung, schreibgeschütztes Root-Dateisystem), resources sowie Scheduling (affinity, nodeSelector, tolerations).
  • rbacHelpers: optionale Admin-, Editor- und Viewer-Rollen zur Verwaltung der Custom-Resources. Standardmäßig deaktiviert.
  • crd: CRD-Lebenszyklus: Installiert die CRDs zusammen mit dem Chart (enable) und behält sie bei der Deinstallation des Charts bei (keep).
  • metrics: der per RBAC geschützte Endpunkt /metrics.
  • certManager: cert-manager-Integration für TLS-Zertifikate; erforderlich für Webhook-Zertifikate und Zertifikate des Metrics-Endpunkts. Standardmäßig deaktiviert.
  • prometheus: ein Prometheus-ServiceMonitor zum Abrufen von Metriken. Setzt den prometheus-Bediener im Cluster voraus. Standardmäßig deaktiviert.

Wichtige Werte

Die Standardwerte beziehen sich auf das neueste Release. Wie Sie die Werte ausgeben, die eine chart-Version akzeptiert, erfahren Sie unter Verfügbare Werte anzeigen. Die Konfiguration der Vantage-Anwendung erfolgt in der Custom-Resource Vantage, die vom chart vantage-selfhosted erstellt wird.

vantage-selfhosted

Wird in einen Namensraum Ihrer Wahl installiert. Dieser chart enthält die Vantage-Custom-Resource, eine ConfigMap mit den Daten der Vantage-Workloads samt zugehörigem RBAC sowie die Vantage-bezogenen CRDs und Rollen aus dem Upstream-Infrastruktur-Repository von ABBYY. Die meisten Werte lassen sich direkt den Feldern der Vantage-Custom-Resource zuordnen. Die Spezifikation auf Feldebene finden Sie in der API-Referenz.

Abschnitte der obersten Ebene

  • operator: Verweis auf die Bediener-Installation (namespace und controllerManagerServiceAccount).
  • ingress: der integrierte Ingress des Charts, ausgewählt über ingress.type. Setzen Sie enabled: false, wenn Sie den Ingress selbst verwalten, zum Beispiel mit Traefik.
  • mesh: Istio-Mesh-Ressourcen (mesh.istio.enabled). Dies ist ein Konfigurationsabschnitt auf oberster Ebene, kein Vantage.spec-Feld.
  • serviceAccounts: ServiceAccounts, die das Chart für Vantage-Workloads, den OCI-Migrations-Job und einzelne Workloads erstellt. Dies ist ein Konfigurationsabschnitt auf oberster Ebene, kein Vantage.spec-Feld.
  • vantage: die Vantage.spec-Nutzdaten: argocd, databaseProvider, debug, dnsRecord, idReadingEnabled, keda, mailFrom, minimalInstall, ociMigration, platformAdminEmail, reportingEnabled, reverseProxy, secrets, serviceAccountName, smtp, storage, techcore, updatePolicy, vantageVersion, workloads. Diese Werte werden direkt an die Custom-Resource Vantage übergeben.
  • defaultSkills: legt fest, welche Standard-Skills aus dem mitgelieferten Katalog der skill-installer-Bediener installiert. Dies ist ein Konfigurationsabschnitt auf oberster Ebene, kein Vantage.spec-Feld.
  • observability: vom Chart gerenderte Prometheus-ServiceMonitor-Konfiguration. Dies ist ein Konfigurationsabschnitt auf oberster Ebene, kein Vantage.spec-Feld.
  • workloadsConfigMap: steuert die workload-ConfigMap, die mit dem Chart ausgeliefert wird. create legt fest, ob das Chart sie erstellt, und additionalMetadata enthält erweiterte Überschreibungen pro Chart. Dies ist ein Konfigurationsabschnitt auf oberster Ebene, kein Vantage.spec-Feld.

Erforderliche Werte

Optionale Werte

Verfügbare Werte anzeigen

Der vantage-operator-chart wird vom Kubebuilder-Helm-plugin generiert. Im vantage-selfhosted-chart werden die Vorlagen für die Vantage-Custom-Resource und die workload-ConfigMap manuell gepflegt. So geben Sie die Werte aus, die eine chart-version akzeptiert:
Für $charts_uri, $chart_uri und die Versionsvariablen gelten die unter Installationsvariablen beschriebenen Konventionen. So prüfen Sie die gerenderten Manifeste, bevor Sie sie anwenden:

Bediener- vs. Vantage-Konfiguration

Bereitstellung der TechCore-Worker

Das vantage-selfhosted-chart wendet eine Vantage-Custom-Resource an. Der Bediener stellt anschließend anhand von spec.techcore.* eine Teilmenge der TechCore-Worker-charts bereit, wie in den folgenden Matrizen dargestellt.

Namenskonvention

Worker-charts werden nach dem Schema vtc-{version}-worker-{name}-helm benannt, wobei {version} eine in spec.techcore.versions aufgeführte Version ist. Die Versionsnummern dienen lediglich als Namenspräfixe und haben für den Bediener keine semantische Bedeutung. Welche Worker verfügbar sind, ergibt sich aus der workload-ConfigMap, die mit dem chart vantage-selfhosted ausgeliefert wird.

Zwei Bereitstellungsdurchläufe

Worker-Charts für Versionen, die nicht in spec.techcore.versions aufgeführt sind, werden nicht bereitgestellt. Wenn die Worker einer früheren TechCore-Version parallel zur aktuellen weiterlaufen sollen, geben Sie beide Versionen an. Mit dem Standardwert des Charts, [3, 4], wird TechCore 4 als aktuelle Version und TechCore 3 als vorherige Version bereitgestellt.

Inklusionsmatrix: Durchlauf der aktuellen Version

Inklusionsmatrix: Durchlauf für vorherige Versionen

Wird für jede Version in spec.techcore.versions außer der höchsten ausgeführt.
Die ID-Erkennung wird auf Plattformebene gesteuert, nicht über TechCore. Das zugehörige Flag spec.idReadingEnabled befindet sich außerhalb von spec.techcore. Die worker-id-reading-Charts werden nie bereitgestellt. Siehe Vantage.spec-Referenz.
Die Matrix entscheidet nur darüber, welche der Worker aus der workload-ConfigMap der ausgewählten Version aufgenommen werden. Charts, die in den Workloads dieser Version fehlen, können schlicht nicht bereitgestellt werden. So ist worker-ocr-join derzeit nur im Workload-Satz von vtc-2 enthalten und wird daher nur dann als vtc-2-worker-ocr-join-helm bereitgestellt, wenn spec.techcore.versions den Wert 2 enthält.

Wie geht es weiter?

API-Referenz

Referenz aller Felder der Vantage-Custom-Resource.

Installation auf Azure

Schritt-für-Schritt-Anleitung zur Installation mit diesen charts.

Selbstverwaltetes Kubernetes

Installation mit kundenseitig verwaltetem Ingress, Mesh, secrets, Speicher und Datendiensten.