メインコンテンツへスキップ
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 がクラスターですでに設定されている必要があります。

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 が機能低下している理由を表します。