Vantage) 、および ArgoCD の 3 つのコンポーネントを中心に構成されています。目的のインストール内容を記述した Vantage オブジェクトを適用すると、オペレーターはそのリソースに合致するようにインストール状態をリコンシルし、コンポーネントごとの同期は ArgoCD に委ねます。このページでは、これらの構成要素を概念的に説明します。field レベルの詳細については、API リファレンス を参照してください。
なぜこのパターンなのか
- Infrastructure: オペレーターの対象外であり、お客様がプロビジョニングします。ABBYY は 3.0 向けのプロビジョニング自動化を提供していません。
- Application:
Vantageリソースで宣言的に記述されます。オペレーターは、Vantage Core コンポーネントの依存関係の解決、アーティファクトの移行、ArgoCD による整合性の維持を処理します。
vantage-operator と vantage-selfhosted Helm チャートの対応する新しいバージョンをインストールすることで実行されます。
Vantage カスタムリソース
vantage.abbyy.com/v1alpha1 に登録されています。最小構成のリソースは次のとおりです (例示用です。完全な仕様については API リファレンス を参照してください) :
spec.secrets は必須で、プロバイダー (azure または kubernetes) は必ず 1 つだけ指定する必要があります。spec.smtp は任意です。省略すると、デフォルトの SendGrid メールプロバイダーが使用されます (sendgridApiKey はシークレットプロバイダー経由で指定してください) 。サポートされているプロバイダーについては、シークレットと Key Vault を参照してください。
実際には、これらのほとんどは vantage-selfhosted Helm チャートで設定します。Azure または 自己管理型 Kubernetes を参照してください。
基本概念
ワークロード ConfigMap
spec.workloads は、Vantage の特定のバージョンを構成するチャートとイメージのマニフェストを含む ConfigMap をオペレーターが参照するよう指定します。オペレーターはこのマニフェストを読み取り、OCI 移行を実行してアーティファクトを使用中のレジストリにコピーした後、各コンポーネントの ArgoCD Application マニフェストを生成します。この ConfigMap は、ABBYY が Vantage の各リリースの一部としてビルドし、公開しています。
シークレットと証明書
Secret リソース) 、インストールごとに設定できるのはそのうち 1 つのみです。サポートされているプロバイダー、ID モード、エイリアスの完全な一覧については、シークレットと Key Vault を参照してください。
OCI 移行
spec.ociMigration は、インストール前に、構成済みの 1 つ以上のソースレジストリから宛先レジストリへ artifacts をコピーする 1 回限りの job を定義します。移行が完了すると、それ以降のすべてのコンポーネントのプル元はお客様自身のレジストリになります。ArgoCD は、お客様が設定したリポジトリ Connection を介して、そのレジストリからコンポーネントのチャートをプルします。宛先の authentication では、認証なし、basic auth、または Azure RBAC を使用する Azure Workload Identity をサポートしています。workload には、Kubernetes image pull Secrets、または Azure の場合は AKS managed identity に付与された AcrPull を通じたプルアクセスも必要です。Azure の image pull アクセス または セルフマネージド レジストリ アクセス を参照してください。
Skill のインストール
Vantage resource は、job がまだ実行中でも Ready を報告することがあり、その間も Vantage は使用できます。監視コマンドは ライフサイクル にあります。
ランタイムコントラクト
Vantage resource をどのように処理するか、どの condition を返すか、また再試行を強制する方法) については、この概念的な概要とは別に記載されています。詳しくは ライフサイクル を参照してください。
次のステップ
API リファレンス
spec とステータスの各プロパティを、field ごとに参照できます。
ライフサイクル
リコンシルのフェーズ、ステータス条件、再試行を強制する方法。
Helm チャートの値
オペレーター と Vantage チャートで使用できる、すべての Helm 値のリファレンス。
トラブルシューティング
オペレーター、ArgoCD、secrets、データベース、ingress、mesh に関する一般的な問題を診断します。