Skip to main content
Vantage 3.0 セルフホスト型のインストーラーは、単一の Kubernetes カスタムリソース、つまり vantage.abbyy.com/v1alpha1 API グループ内の Vantage オブジェクトによって制御されます。以下のフィールドが、ユーザーと オペレーター の間の完全な契約を構成します。 オペレーター がこのリソースをどのように利用するかの概要については、Architecture を参照してください。インストール手順については、Azure または Self-Managed Kubernetes を選択してください。

API グループ

Vantage

最上位の Vantage リソースです。vantage-selfhosted チャートには Vantage CR インスタンスが含まれており、そのチャートをインストールした名前空間に作成されます。

Vantage.spec

spec は Vantage の望ましい状態を定義します
secrets の検証: has(self.kubernetes) != has(self.azure): 指定するプロバイダーはちょうど 1 つだけです。
updatePolicy の検証: !has(self.auto): 自動更新はまだサポートされていません。
updatePolicy の検証: (has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1: 指定する更新ポリシーはちょうど 1 つだけです。
ociMigration の検証: !has(self.enabled) || self.enabled == false || has(self.destination): ociMigration が有効な場合は destination が必須です。
データベースとレポート機能の検証: PostgreSQL は PostgreSQL という厳密な値で選択します。レポート機能は SQL Server 専用です。databaseProviderPostgreSQL で、かつ reportingEnabledtrue の場合、この resource は拒否されます。
techcore の検証: !self.keepPreviousVersion || has(self.previousVersion): keepPreviousVersion が true の場合は previousVersion が必須です。

Vantage.spec.keda

keda は、サポートされている Vantage ワークロード向けに KEDA ベースのオートスケーリングを設定します。有効にする前に、KEDA と必要な Prometheus サービスをインストールしてください。 現在の Vantage ワークロード チャートでは、KEDA 2.17.x が必要です。一部の ScaledObject リソースは http://prometheus-operated.observability.svc.cluster.local:9090 をクエリします。詳細は Autoscaling with KEDA を参照してください。

Vantage.spec.smtp

smtp は SMTP メールサーバーを設定します。SendGrid の任意の代替手段であり、設定されている場合にのみ使用されます。

Vantage.spec.workloads

workloads は、チャートとイメージに関するデータを格納する ConfigMap を設定します

Vantage.spec.secrets

secrets は、アプリケーションのシークレット (データベース接続文字列、API key、証明書) を Vantage ワークロードに提供するために使用されるシークレット プロバイダーを設定します。指定するプロバイダーは必ず1つだけです。概念モデルとエイリアスの一覧全体については、Secrets and Key Vault を参照してください。

Vantage.spec.secrets.azure

azure は、Secrets Store CSI Driver を介して Azure Key Vault をシークレットのソースとして設定します。

Vantage.spec.secrets.azure.objects[alias]

AzureSecretObjectConfig は、シークレット エイリアスの参照先となる単一の Key Vault オブジェクトを表します。

Vantage.spec.secrets.kubernetes

kubernetes は、インストール先の名前空間にある既存の Kubernetes Secret リソースを使用します。

Vantage.spec.secrets.kubernetes.objects[alias]

各エントリは、シークレットのエイリアスを Kubernetes Secret 名にマッピングします。

Vantage.spec.storage

storage は高度なストレージ オプションを構成します。省略すると、Vantage はデフォルトの Azure Blob バックエンドを使用し、storage*ConnectionString シークレット エイリアスに定義された接続文字列を読み取ります。詳細は Secrets and Key Vault を参照してください。

Vantage.spec.storage.custom

custom は、カスタムのストレージバックエンド (Kubernetes の StorageClass による PVC ベース) を設定します。
カスタム ストレージ バックエンドで Vantage をインストールする前に、参照先の Kubernetes StorageClass がクラスターですでに設定されている必要があります。そこでプロビジョニングされるボリュームは、非 root ユーザーが書き込み可能である必要があります。詳細は 永続ストレージの設定 を参照してください。

Vantage.spec.updatePolicy

updatePolicy は、オペレーターによる Vantage のアップグレード方法を制御します。

Vantage.spec.updatePolicy.auto

auto は、バージョンの自動アップグレードを有効にします。現時点では未実装です。

Vantage.spec.ociMigration

ociMigration は、インストール前にソース レジストリ から宛先へ artifacts をコピーするための設定です。 OCI 移行をスキップするには、この設定を完全に省略するか、enabled=false を設定します。 有効にする場合、destination は必須です。
destination の validation: !self.host.contains(’/’): host にはパスを含めないでください。レジストリ パスには repository field を使用してください
destination の validation: !self.host.contains(’://’): host にはスキーム (例: https://) を含めないでください
migration job のイメージ pull アクセス: レジストリ pull secret を持つ ServiceAccount (serviceAccountName) で job を実行するか、ソース エントリで secret (sources[].credentialsRef.name) を参照してください。Azure では、AKS managed identity に AcrPull を付与する方法が、pull secrets を使うより簡単な代替手段です。ArgoCD から使用する レジストリ へのアクセスは、ArgoCD repository connection として別途設定します。Image pull access および Connect ArgoCD to your OCI registry を参照してください。

Vantage.spec.ociMigration.destination

destination は、アーティファクトのコピー先です。

Vantage.spec.ociMigration.destination.credentialsRef

credentialsRef は、username キーと password キーを含む Secret、または kubernetes.io/dockerconfigjson 型の Secret を参照します。 指定した場合は、username/password より優先されます。

Vantage.spec.ociMigration.destination.workloadIdentity

workloadIdentity は、レジストリにアクセスするためにワークロードの ID (Kubernetes の サービスアカウント) を使用するための設定を定義します。

Vantage.spec.ociMigration.imagePullSecrets[index]

LocalObjectReference には、同じ名前空間内で参照先の object を特定するために十分な情報が含まれています。

Vantage.spec.ociMigration.sources[index]

ContainerRegistryConfig は、コンテナーレジストリの接続設定を定義します。

Vantage.spec.ociMigration.sources[index].credentialsRef

credentialsRef は、username キーと password キーを含む Secret、または kubernetes.io/dockerconfigjson 型の Secret を参照します。 指定した場合、username/password より優先されます。

Vantage.spec.ociMigration.sources[index].workloadIdentity

workloadIdentity は、レジストリへのアクセスにワークロードの ID (Kubernetes サービスアカウント) を使用するための設定を定義します。

Vantage.spec.techcore

techcore には、TechCore processing engine の構成が含まれています

Vantage.spec.techcore.nnTrainingWorkers

nnTrainingWorkers はニューラル ネットワークの学習ワーカーを構成します

Vantage.status

status は、Vantage の観測された状態を定義します
Skill のインストールは、status.conditions[] には反映されず、ArgoCD 経由でも表示されない、個別の Kubernetes job として実行されます。job の実行中も Vantage は使用できます。監視コマンドについては、Lifecycle を参照してください。

Vantage.status.conditions[index]

Condition には、この APIリソースの現在の状態の一側面に関する詳細が含まれます。

Vantage.status.degradationReasons[index]

DegradationReason は、インストール内の 1 つの component が機能低下している理由を表します。