> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 既知の制限事項

> Vantage 3.0 セルフホスト型の運用時に、顧客が事前に考慮すべき現在の制限事項と制約。

現在、Vantage 3.0 セルフホスト型にはいくつかの制約があります。デプロイのサイジングや実施計画を立てる前に、あらかじめこれらを考慮してください。

<div id="architectural-constraints">
  ## アーキテクチャ上の制約
</div>

<div id="one-operator-instance-per-cluster">
  ### クラスターごとに operator インスタンスは1つまで
</div>

`vantage-operator` Helm チャートは、クラスター スコープのテンプレート化されていない resource 名を使用します。具体的には、`manager-role` ClusterRole、`manager-rolebinding` ClusterRoleBinding、`controller-manager` ServiceAccount です。このチャートを同じクラスターに2回インストールすると (異なる名前空間であっても) 、これらの resource が競合します。**このチャートは、クラスターごとに1インスタンスのみインストールしてください。**

<div id="deployment-support">
  ## デプロイのサポート
</div>

<div id="supported-deployment-targets">
  ### サポートされているデプロイ対象
</div>

Vantage 3.0 セルフホスト型は、AKS と自己管理型 Kubernetes をサポートしています。検証済みの統合構成については、[Compatibility](/ja/vantage/self-hosted/v3.0/compatibility) に記載されています。その他の Kubernetes バージョン、サービスメッシュ、ingress コントローラー、データベースエンジン、およびコンポーネントの置き換えは検証されていません。記載のない組み合わせを本番環境で使用する前に、ABBYY アカウントチームにご相談ください。

<div id="database-support">
  ## 対応データベース
</div>

<div id="reporting-requires-sql-server">
  ### レポート機能には SQL Server が必要です
</div>

PostgreSQL は Vantage サービスでサポートされていますが、レポート機能のワークロードは SQL Server 固有の移行処理を使用するため、PostgreSQL では利用できません。PostgreSQL へのデプロイでは、`vantage.databaseProvider: PostgreSQL` を設定し、`vantage.reportingEnabled: false` のままにしてください。

<div id="mail-delivery">
  ## メール送信
</div>

<div id="smtp-supports-basic-auth-only">
  ### SMTP は basic auth のみをサポート
</div>

SendGrid はデフォルトのメールプロバイダーです。`sendgridApiKey` シークレットを指定すると、Vantage は追加設定なしでそれを使用します。SMTP が使用されるのは `spec.smtp` を設定した場合のみで、現在 SMTP では basic auth または認証なしのみがサポートされています。メールリレーで別の認証スキームが必要で、SendGrid を使用できない場合は、basic auth にダウングレードする中継リレーを用意することを検討してください。

<div id="operational-notes">
  ## 運用上の注意事項
</div>

<div id="alternate-ingress-controllers-require-the-vantage-route-contract">
  ### 別の ingress コントローラーを使用する場合は、Vantage のルート契約への準拠が必要です
</div>

検証済みの ingress パスは、AKS 上の組み込み Istio 構成と、自己管理型 Kubernetes 上でドキュメント化されている Traefik 構成です。別の ingress コントローラーを使用する場合は、同じルート、リライト、TLS の動作、内部ステータス保護、および転送される HTTPS スキームを実装する必要があります。別のコントローラーまたはルート実装の検証は、お客様の責任で行ってください。

TLS が HTTP バックエンドの手前で終端される場合、Vantage の認証サービスは `X-Forwarded-Proto` を尊重する必要があります。ワークロード チャートで必要な環境設定が公開されていない場合は、[Self-Managed Kubernetes](/ja/vantage/self-hosted/v3.0/providers/self-managed#forwarded-https-scheme) に記載されている、サポート対象の admission mutation メカニズムを使用してください。

<div id="keda-is-limited-to-217x">
  ### KEDA は 2.17.x に制限されています
</div>

現在の Vantage ワークロード チャートでは、KEDA 2.18 で削除された KEDA スケーラーの field を使用しています。KEDA 2.17.3 を使用してください。KEDA 2.18 以降では、影響を受ける `ScaledObject` リソースは HPA を作成できず、degraded 状態のままになります。[KEDA を使用したオートスケーリング](/ja/vantage/self-hosted/v3.0/performance/autoscaling)を参照してください。

<div id="skill-installation-is-not-surfaced-in-argocd">
  ### ArgoCD には Skill のインストール状況は表示されません
</div>

Skill は Operator 管理の ArgoCD アプリケーションではなく、別個の Kubernetes ジョブによってインストールされるため、現時点では ArgoCD から Skill のインストール進行状況を確認できません。ジョブの実行中でも、`Vantage` リソースが `Ready` を報告することがあります。Skill のインストール中でも Vantage は利用できます。ジョブは `kubectl wait` で直接監視してください。コマンドについては [Lifecycle](/ja/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately) を参照してください。

<div id="whats-next">
  ## 次のステップ
</div>

<CardGroup cols={2}>
  <Card title="Vantage 2.7 からの移行" icon="right-left" href="/ja/vantage/self-hosted/v3.0/migration-from-2.7">
    既存の 2.7 セルフホスト型環境からの移行を計画します。
  </Card>

  <Card title="アップグレード" icon="arrow-up" href="/ja/vantage/self-hosted/v3.0/upgrading">
    3.0 の各バージョン間を移行するための手動アップグレード手順です。
  </Card>
</CardGroup>
