> ## 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.

# APIリファレンス: 2026.10.16

> Vantage 3.0 セルフホスト版のインストールを制御する vantage.abbyy.com/v1alpha1 Vantage カスタムリソースのフィールドリファレンス。

## アーティファクトのバージョン

| アーティファクト | バージョン |
| - | - |
| `vantage-operator` チャート | `0.91.1` |
| `vantage-selfhosted` チャート | `0.91.1` |
| `vantage-operator` イメージ | `v0.91.1` |

Vantage 3.0 セルフホスト版のインストーラーは、単一の Kubernetes カスタムリソースによって制御されます。それが、`vantage.abbyy.com/v1alpha1` API グループに属する `Vantage` オブジェクトです。以下の field は、ユーザーとオペレーターとの間の取り決めをすべて網羅しています。

オペレーターがこのリソースをどのように利用するかについての概念的な説明は、[アーキテクチャ](https://docs.abbyy.com/ja/vantage/self-hosted/v3.0/architecture.md)を参照してください。インストール手順については、[Azure](https://docs.abbyy.com/ja/vantage/self-hosted/v3.0/providers/azure.md) または [セルフマネージド Kubernetes](https://docs.abbyy.com/ja/vantage/self-hosted/v3.0/providers/self-managed.md) のいずれかを選択してください。

## API グループ

| グループ | バージョン | リソース |
| - | - | - |
| `vantage.abbyy.com` | `v1alpha1` | `Vantage` |

## Vantage

Vantage は vantages API のスキーマです

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `apiVersion` | `string` | はい | vantage.abbyy.com/v1alpha1 |
| `kind` | `string` | はい | Vantage |
| `metadata` | `object` | はい | `metadata` フィールドに含まれるフィールドについては、Kubernetes API のドキュメントを参照してください。 |
| `spec` | `object` | はい | spec は Vantage の望ましい状態を定義します。[`spec`](#vantagespec) を参照してください。 |
| `status` | `object` | いいえ | status は Vantage の観測された状態を定義します。[`status`](#vantagestatus) を参照してください。 |

> [!NOTE]
>
> **`spec` の検証**: `!self.reportingEnabled || !has(self.databaseProvider) || self.databaseProvider == 'SqlServer'`: reportingEnabled を有効にするには、databaseProvider を 'SqlServer' に設定する必要があります。レポート機能は SQL Server 専用であり、PostgreSQL では使用できません

## Vantage.spec

spec は Vantage の望ましい状態を定義します。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `dnsRecord` | `string` | はい | dnsRecord は Vantage インストールの DNS レコードです。形式: `hostname`。 |
| `mailFrom` | `string` | はい | mailFrom は送信メールの差出人として使用するメールアドレスです。形式: `email`。 |
| `platformAdminEmail` | `string` | はい | platformAdminEmail はプラットフォーム管理者のメールアドレスです。形式: `email`。 |
| `secrets` | `object` | はい | secrets はシークレットプロバイダーを選択して設定します。プロバイダーは 1 つだけ指定する必要があります。[`secrets`](#vantagespecsecrets) を参照してください。 |
| `updatePolicy` | `object` | はい | updatePolicy は、オペレーターによる Vantage のアップグレードの扱いを制御します。[`updatePolicy`](#vantagespecupdatepolicy) を参照してください。 |
| `vantageVersion` | `string` | はい | vantageVersion はインストールする Vantage のバージョンです。 |
| `workloads` | `object` | はい | workloads は、チャートとイメージに関するデータを含む ConfigMap を設定します。[`workloads`](#vantagespecworkloads) を参照してください。 |
| `argocd` | `object` | いいえ | argocd は、オペレーターが Vantage ワークロードのインストール用に作成する Argo CD リソースを設定します。省略した場合は "default" プロジェクトにインストールされます。[`argocd`](#vantagespecargocd) を参照してください。 |
| `databaseProvider` | `enum` | いいえ | databaseProvider は、すべての Vantage サービスで使用するデータベースエンジンを選択します。デフォルト: `SqlServer` · 列挙値: `SqlServer, PostgreSQL`。 |
| `debug` | `boolean` | いいえ | debug は、ワークロードをデバッグモードでインストールするかどうかを制御します。デフォルト: `false`。 |
| `idReadingEnabled` | `boolean` | いいえ | idReadingEnabled は ID reading 機能を有効にします。デフォルト: `false`。 |
| `keda` | `object` | いいえ | keda は KEDA の設定を行います。指定しない場合、KEDA サポートは無効になります。[`keda`](#vantagespeckeda) を参照してください。 |
| `minimalInstall` | `boolean` | いいえ | minimalInstall は、ワークロードを最小限のリソース構成でデプロイするよう設定します。デフォルト: `false`。 |
| `ociMigration` | `object` | いいえ | ociMigration は、インストール前にソースレジストリから移行先レジストリへアーティファクトをコピーする処理を設定します。移行をスキップするには、このフィールド全体を省略するか、enabled=false を設定します。有効にした場合、destination は必須です。[`ociMigration`](#vantagespecocimigration) を参照してください。 |
| `reportingEnabled` | `boolean` | いいえ | reportingEnabled は SQL Server のレポート機能を有効にします。SQL Server 専用の機能です。レポートワークロードは SQL Server 固有のマイグレーションを実行するため、PostgreSQL ではサポートされません。true に設定するには databaseProvider が 'SqlServer' である必要があり (上記の spec 検証によって強制されます) 、PostgreSQL の場合は拒否されます。デフォルト: `false`。 |
| `reverseProxy` | `boolean` | いいえ | reverseProxy は、TLS を終端するリバースプロキシの背後で Vantage アプリケーションサービスが動作するよう構成します。デフォルト: `false`。 |
| `serviceAccountName` | `string` | いいえ | serviceAccountName は、Vantage ワークロードで使用するサービスアカウントの名前です。省略した場合はデフォルトのサービスアカウントが使用されます。個々のワークロードでは、workloads.serviceAccounts を使ってこの設定を上書きできます。デフォルト: `default` · 最小長: `1`。 |
| `smtp` | `object` | いいえ | smtp は SMTP メールサーバーを設定します。指定しない場合は、メールプロバイダーとして Sendgrid が使用されます。[`smtp`](#vantagespecsmtp) を参照してください。 |
| `storage` | `object` | いいえ | storage は高度なストレージオプションを設定します。[`storage`](#vantagespecstorage) を参照してください。 |
| `techcore` | `object` | いいえ | techcore には TechCore processing engine の設定が含まれます。[`techcore`](#vantagespectechcore) を参照してください。 |

> [!NOTE]
>
> **`secrets` の検証**: `has(self.kubernetes) != has(self.azure)`: プロバイダーは 1 つだけ指定する必要があります

> [!NOTE]
>
> **`updatePolicy` の検証**: `!has(self.auto)`: 自動更新は現在サポートされていません

> [!NOTE]
>
> **`updatePolicy` の検証**: `(has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1`: 更新ポリシーは必ず 1 つだけ指定する必要があります

> [!NOTE]
>
> **`ociMigration` の検証**: `!has(self.enabled) || self.enabled == false || has(self.destination)`: ociMigration が有効な場合、destination の指定は必須です

> [!NOTE]
>
> **`storage` の検証**: `!has(self.s3)`: S3 ストレージは現在サポートされていません

> [!NOTE]
>
> **`storage` の検証**: `(has(self.azure) ? 1 : 0) + (has(self.s3) ? 1 : 0) + (has(self.custom) ? 1 : 0) <= 1`: 指定できるストレージプロバイダーは 1 つまでです

## Vantage.spec.secrets

secrets は、シークレットプロバイダーを選択して設定します。
プロバイダーは 1 つだけ指定する必要があります。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `azure` | `object` | いいえ | azure は、Azure Key Vault (Secrets Store CSIドライバー経由) をシークレットのソースとして設定します。[`azure`](#vantagespecsecretsazure) を参照してください。 |
| `kubernetes` | `object` | いいえ | kubernetes は、Kubernetes ネイティブのシークレットをシークレットのソースとして設定します。[`kubernetes`](#vantagespecsecretskubernetes) を参照してください。 |

## Vantage.spec.secrets.azure

azure は、Azure Key Vault を (Secrets Store CSIドライバー経由で) シークレットのソースとして構成します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `keyVaultName` | `string` | はい | keyVaultName は、シークレットを格納する Azure Key Vault です。 |
| `tenantId` | `string` | はい | tenantId は、Key Vault を所有する Azure AD テナントです。 |
| `clientId` | `string` | いいえ | clientId は、Key Vault への読み取りアクセス権を持つユーザー割り当てマネージドIDの Azure AD クライアントIDです。identityMode が "workloadIdentity" (デフォルト) の場合は必須です。 |
| `identityMode` | `enum` | いいえ | identityMode は、CSI ドライバーが Azure で認証を行う方法を選択します。デフォルト: `workloadIdentity` · 列挙値: `workloadIdentity, podIdentity, vmManagedIdentity`。 |
| `objects` | `map[string]object` | いいえ | objects は、シークレットのエイリアス (workloads-secrets.yml で参照されるもの) から特定の Key Vault オブジェクトへのマッピングを必要に応じて上書きします。エイリアスがこのマップに存在しない場合は、エイリアス自体が Key Vault オブジェクト名として使用され、オブジェクトは型 "secret" として取得されます。[`objects`](#vantagespecsecretsazureobjectskey) を参照してください。 |
| `userAssignedIdentityID` | `string` | いいえ | userAssignedIdentityID は、identityMode が "vmManagedIdentity" の場合に使用するユーザー割り当てマネージドIDのクライアントIDです。 |

## Vantage.spec.secrets.azure.objects\[key]

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `objectName` | `string` | はい | objectName は、Azure Key Vault 内のオブジェクトの名前です。 |
| `objectType` | `enum` | いいえ | objectType は、Key Vault オブジェクトの種類です。デフォルトは「secret」です。デフォルト: `secret` · Enum: `secret, key, cert`。 |
| `objectVersion` | `string` | いいえ | objectVersion は、使用する Key Vault オブジェクトのバージョンを固定します。デフォルトでは最新バージョンが使用されます。 |

## Vantage.spec.secrets.kubernetes

kubernetes は、Kubernetes ネイティブの Secrets をシークレットのソースとして設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `objects` | `map[string]object` | いいえ | objects は、使用する Kubernetes シークレットを定義します。定義しない場合は、デフォルトのシークレット名が使用されます。[`objects`](#vantagespecsecretskubernetesobjectskey) を参照してください。 |

## Vantage.spec.secrets.kubernetes.objects\[key]

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `secretName` | `string` | はい | secretName は Kubernetes Secret の名前です |

## Vantage.spec.updatePolicy

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `manual` | `object` | いいえ | manual を指定すると、自動アップグレードが無効になります。アップグレードは、オペレーターの Helm チャートの新しいバージョンをインストールして行います。 |

現在はまだサポートされていません。これらのフィールドが設定されたリソースは、オペレーターによって拒否されます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `auto` | `object` | いいえ | auto はバージョンの自動アップグレードを有効にします。まだ実装されていません。[`auto`](#vantagespecupdatepolicyauto) を参照してください。 |

## Vantage.spec.updatePolicy.auto

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `releaseURL` | `string` | はい | releaseURL は、Vantage のリリースバンドルの取得元 URL です。形式: `uri`。 |

## Vantage.spec.workloads

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `configMap` | `string` | はい | configMap は、ワークロードデータを含む ConfigMap の名前です。 |
| `metadataTemplateKey` | `string` | はい | metadataTemplateKey は、チャートのインストールに関するメタデータテンプレートを格納する ConfigMap 内のキーです。 |
| `secretsKey` | `string` | はい | secrets は、シークレットのメタデータを格納する ConfigMap 内のキーです。 |
| `workloadsKey` | `string` | はい | workloadsKey は、チャートとイメージの一覧を格納する ConfigMap 内のキーです。 |
| `additionalMetadataKey` | `string` | いいえ | additionalMetadataKey は、チャートのインストールに関する追加メタデータを格納する ConfigMap 内のキーです。 |
| `pods` | `object` | いいえ | pods は、ワークロードの pod に付与するメタデータを設定します。[`pods`](#vantagespecworkloadspods) を参照してください。 |
| `serviceAccounts` | `object` | いいえ | serviceAccounts は、特定のワークロードについて spec.serviceAccountName を上書きします。[`serviceAccounts`](#vantagespecworkloadsserviceaccounts) を参照してください。 |

## Vantage.spec.workloads.pods

pods は、ワークロードの pod に追加するメタデータを設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `charts` | `map[string]object` | いいえ | charts は、チャート名を、そのチャートのワークロードの pod に追加するメタデータにマッピングします。このメタデータは、すべてのワークロードに共通のメタデータに加えて適用され、共通のメタデータよりも優先されます。[`charts`](#vantagespecworkloadspodschartskey) を参照してください。 |
| `labels` | `map[string]string` | いいえ | labels は、すべてのワークロードの pod に追加されます。 |

## Vantage.spec.workloads.pods.charts\[key]

ChartPodsConfig は、単一の Vantage Helm チャートに含まれるワークロードの pod に追加するメタデータを定義します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `deployment` | `object` | いいえ | deployment は、チャートのデプロイメントの pod を設定します。[`deployment`](#vantagespecworkloadspodschartskeydeployment) を参照してください。 |
| `migrator` | `object` | いいえ | migrator は、チャートのマイグレーター ジョブの pod を設定します。[`migrator`](#vantagespecworkloadspodschartskeymigrator) を参照してください。 |
| `statefulSet` | `object` | いいえ | statefulSet は、チャートの StatefulSet の pod を設定します。[`statefulSet`](#vantagespecworkloadspodschartskeystatefulset) を参照してください。 |

## Vantage.spec.workloads.pods.charts\[key].deployment

deployment は、チャートのデプロイメントに含まれる pod を設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `labels` | `map[string]string` | いいえ | labels はワークロードの pod に付与されます。 |

## Vantage.spec.workloads.pods.charts\[key].migrator

migrator は、チャートのマイグレーター ジョブの pod を設定します。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `labels` | `map[string]string` | いいえ | ワークロードの pod に付与されるラベルです。 |

## Vantage.spec.workloads.pods.charts\[key].statefulSet

statefulSet は、チャートの StatefulSet の pod を構成します。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `labels` | `map[string]string` | いいえ | labels は、ワークロードの pod に付与されます。 |

## Vantage.spec.workloads.serviceAccounts

serviceAccounts は、特定のワークロードに対して spec.serviceAccountName を上書きします。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `charts` | `map[string]object` | いいえ | charts は、チャート名を、そのチャートのワークロードが使用するサービスアカウントにマッピングします。エントリがないワークロードには spec.serviceAccountName が使用されます。詳細は [`charts`](#vantagespecworkloadsserviceaccountschartskey) を参照してください。 |

## Vantage.spec.workloads.serviceAccounts.charts\[key]

ChartServiceAccountsConfig は、単一の Vantage Helm チャート内のワークロードが使用するサービスアカウントの設定を定義します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `deployment` | `object` | いいえ | deployment は、チャートのデプロイメントが使用するサービスアカウントを設定します。[`deployment`](#vantagespecworkloadsserviceaccountschartskeydeployment) を参照してください。 |
| `migrator` | `object` | いいえ | migrator は、チャートのマイグレータージョブが使用するサービスアカウントを設定します。[`migrator`](#vantagespecworkloadsserviceaccountschartskeymigrator) を参照してください。 |
| `statefulSet` | `object` | いいえ | statefulSet は、チャートの StatefulSet が使用するサービスアカウントを設定します。[`statefulSet`](#vantagespecworkloadsserviceaccountschartskeystatefulset) を参照してください。 |

## Vantage.spec.workloads.serviceAccounts.charts\[key].deployment

deployment は、チャートのデプロイメントで使用するサービスアカウントを設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `name` | `string` | はい | サービスアカウントの名前。最小長: `1` · 最大長: `253` · パターン: `^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$`。 |

## Vantage.spec.workloads.serviceAccounts.charts\[key].migrator

migrator は、チャートのマイグレータージョブが使用するサービスアカウントを設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `name` | `string` | はい | サービスアカウントの名前。最小長: `1` · 最大長: `253` · パターン: `^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$`。 |

## Vantage.spec.workloads.serviceAccounts.charts\[key].statefulSet

statefulSet は、チャートの statefulset が使用するサービスアカウントを設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `name` | `string` | はい | サービスアカウントの名前。最小長: `1` · 最大長: `253` · パターン: `^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$`。 |

## Vantage.spec.argocd

argocd は、オペレーターが Vantage ワークロードをインストールする際に作成する Argo CD リソースを設定します。
省略した場合は「default」プロジェクトにインストールされます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `project` | `string` | いいえ | project は、生成される Application が属する Argo CD AppProject です。このプロジェクトでは、デプロイ先のクラスターと名前空間が許可されている必要があります。許可されていない場合、Argo CD は同期を拒否します。デフォルト: `default` · 最小長: `1`。 |

## Vantage.spec.keda

keda は KEDA の設定を構成します。指定しない場合、KEDA サポートは無効になります。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `enabled` | `boolean` | いいえ | enabled は、KEDA に対応したワークロードで KEDA ベースのオートスケーリングを使用するかどうかを制御します。デフォルト: `false`。 |

## Vantage.spec.ociMigration

ociMigration は、インストール前にソースレジストリから宛先へアーティファクトをコピーする処理を構成します。
移行をスキップするには、この項目全体を省略するか、enabled=false を設定します。
有効にした場合、destination は必須です。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `concurrency` | `integer` | はい | concurrency は、並列でコピーするアーティファクトの数です。デフォルト: `5` · 最小値: `1`。 |
| `destination` | `object` | いいえ | destination は、アーティファクトのコピー先です。[`destination`](#vantagespecocimigrationdestination) を参照してください。 |
| `enabled` | `boolean` | いいえ | enabled は、OCI 移行を有効にします。デフォルト: `true`。 |
| `imagePullSecrets` | `[]object` | いいえ | imagePullSecrets は、同じ名前空間内のシークレットへの参照を格納するリストです (オプション)。これらのシークレットは、この名前空間で OCI 移行ジョブを実行するオペレーターイメージをプルする際に使用されます。[`imagePullSecrets`](#vantagespecocimigrationimagepullsecretsindex) を参照してください。 |
| `labels` | `map[string]JSON` | いいえ | labels は、OCI 移行ジョブおよび pod テンプレートに適用するラベルのセットです。string 以外の値は \[fmt.Sprint] で文字列に変換されます。 |
| `resources` | `object` | いいえ | resources は、OCI 移行ジョブのコンテナーに割り当てるコンピューティングリソースです。デフォルトでは、コピー処理でバーストできるよう CPU は無制限に設定されています。すべてのコンテナーに CPU 制限を求めるポリシーが適用されたクラスターでは、CPU 制限を設定してください。反映されるのは requests と limits のみです。ジョブは pod レベルの resourceClaims を宣言しないため、クレームは拒否されます。デフォルト: `{"limits":{"memory":"512Mi"},"requests":{"cpu":"100m","memory":"128Mi"}}`。[`resources`](#vantagespecocimigrationresources) を参照してください。 |
| `serviceAccountName` | `string` | いいえ | serviceAccountName は、OCI 移行ジョブの実行に使用する ServiceAccount の名前です。 |
| `sources` | `[]object` | いいえ | sources は、アーティファクトのコピー元レジストリ (例: JFrog) にアクセスするための認証情報です。(最大長 20) 最大項目数: `20`。[`sources`](#vantagespecocimigrationsourcesindex) を参照してください。 |

> [!NOTE]
>
> **`destination` の検証**: `!self.host.contains('/')`: host にパスを含めることはできません。レジストリのパスは repository フィールドで指定してください

> [!NOTE]
>
> **`destination` の検証**: `!self.host.contains('://')`: host にスキーム (例: https\://) を含めることはできません

> [!NOTE]
>
> **`resources` の検証**: `!has(self.claims) || size(self.claims) == 0`: resources.claims は OCI 移行ジョブではサポートされていません

## Vantage.spec.ociMigration.destination

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `host` | `string` | はい | host は、レジストリのホスト名と、オプションでポート番号を指定します (例: registry.example.com、registry.example.com:5000) 。最小長: `1`。 |
| `credentialsRef` | `object` | いいえ | credentialsRef は、ユーザー名とパスワードのキーを含む Secret、または kubernetes.io/dockerconfigjson タイプの Secret を参照します。指定した場合は、username/password よりも優先されます。[`credentialsRef`](#vantagespecocimigrationdestinationcredentialsref) を参照してください。 |
| `password` | `string` | いいえ | レジストリ認証用のパスワード (平文。本番環境では credentialsRef を使用してください) |
| `repository` | `string` | いいえ | repository は、アーティファクトを格納するレジストリのパス/名前空間です (例: "abbyy-docker"、"vantage/images") 。パターン: `^[a-z0-9]+([._-][a-z0-9]+)*(/[a-z0-9]+([._-][a-z0-9]+)*)*$`。 |
| `username` | `string` | いいえ | レジストリ認証用のユーザー名 (平文。本番環境では credentialsRef を使用してください) |
| `workloadIdentity` | `object` | いいえ | workloadIdentity は、ワークロードの ID (Kubernetes サービスアカウント) を使用してレジストリにアクセスするための設定を定義します。[`workloadIdentity`](#vantagespecocimigrationdestinationworkloadidentity) を参照してください。 |

## Vantage.spec.ociMigration.destination.credentialsRef

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

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `name` | `string` | はい | name は Secret の名前です |

## Vantage.spec.ociMigration.destination.workloadIdentity

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `audience` | `string` | いいえ | audience は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するエンドポイントです。 |
| `clientId` | `string` | いいえ | clientId は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するクライアントIDです。 |
| `tokenEndpoint` | `string` | いいえ | tokenEndpoint は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するエンドポイントです。 |

## Vantage.spec.ociMigration.imagePullSecrets\[index]

LocalObjectReference には、同じ名前空間内で参照先の
オブジェクトを特定するために必要な情報が含まれています。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `name` | `string` | いいえ | 参照先の名前。この field は実質的に必須ですが、後方互換性のために空にすることが許可されています。この値が空になっているこの型のインスタンスは、ほぼ確実に誤りです。詳細: [https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names) デフォルト: \`\`。 |

## Vantage.spec.ociMigration.resources

resources は、OCI 移行ジョブのコンテナーに割り当てるコンピューティングリソースです。デフォルトでは、コピー処理がバーストできるよう
CPU は無制限になっています。すべてのコンテナーに CPU 制限の設定をポリシーで義務付けているクラスターでは、CPU 制限を設定してください。
適用されるのは requests と limits のみです。このジョブは pod レベルの
resourceClaims を宣言しないため、claims は却下されます。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `limits` | `map[string]intorstring` | いいえ | Limits は、許可されるコンピューティングリソースの上限を表します。詳細: [https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) |
| `requests` | `map[string]intorstring` | いいえ | Requests は、必要なコンピューティングリソースの最小量を表します。コンテナーで Requests を省略した場合、Limits が明示的に指定されていればその値が、指定されていなければ実装で定義された値がデフォルトとして使用されます。Requests に Limits を超える値は指定できません。詳細: [https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) |

まだサポートされていません。これらのfieldを設定したリソースは、オペレーターによって拒否されます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `claims` | `[]object` | いいえ | Claims には、spec.resourceClaims で定義されたリソースのうち、このコンテナーが使用するリソースの名前を列挙します。このfieldを使用するには、DynamicResourceAllocation フィーチャーゲートが必要です。このfieldは変更できません。設定できるのはコンテナーに対してのみです。[`claims`](#vantagespecocimigrationresourcesclaimsindex) を参照してください。 |

## Vantage.spec.ociMigration.resources.claims\[index]

ResourceClaim は、PodSpec.ResourceClaims 内の 1 つのエントリを参照します。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `name` | `string` | はい | このフィールドを使用する Pod の pod.spec.resourceClaims 内のいずれかのエントリ名と一致している必要があります。これにより、そのリソースをコンテナー内で使用できるようになります。 |
| `request` | `string` | いいえ | 参照先のクレーム内のリクエストに付けられた名前です。空の場合はクレームのすべてが使用可能になり、指定した場合はこのリクエストの結果のみが使用可能になります。 |

## Vantage.spec.ociMigration.sources\[index]

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `host` | `string` | はい | host は、レジストリのホスト名と、オプションのポート番号です (例: registry.example.com、registry.example.com:5000) 。最小の長さ: `1`。 |
| `credentialsRef` | `object` | いいえ | credentialsRef は、ユーザー名とパスワードのキーを含む Secret、または kubernetes.io/dockerconfigjson 型の Secret を参照します。指定した場合は、username/password よりも優先されます。[`credentialsRef`](#vantagespecocimigrationsourcesindexcredentialsref) を参照してください。 |
| `password` | `string` | いいえ | レジストリ認証用のパスワード (平文。本番環境では credentialsRef を使用してください) |
| `repository` | `string` | いいえ | repository は、アーティファクトを格納するレジストリのパス/名前空間です (例: "abbyy-docker"、"vantage/images") 。パターン: `^[a-z0-9]+([._-][a-z0-9]+)*(/[a-z0-9]+([._-][a-z0-9]+)*)*$`。 |
| `username` | `string` | いいえ | レジストリ認証用のユーザー名 (平文。本番環境では credentialsRef を使用してください) |
| `workloadIdentity` | `object` | いいえ | workloadIdentity は、ワークロードの ID (Kubernetes サービスアカウント) を使用してレジストリにアクセスするための設定を定義します。[`workloadIdentity`](#vantagespecocimigrationsourcesindexworkloadidentity) を参照してください。 |

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

credentialsRef は、ユーザー名とパスワードのキーを含む Secret、または kubernetes.io/dockerconfigjson 型の Secret を参照します。
指定すると、username/password よりも優先されます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `name` | `string` | はい | name は Secret の名前です |

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

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `audience` | `string` | いいえ | audience は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するエンドポイントです。 |
| `clientId` | `string` | いいえ | clientId は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するクライアントIDです。 |
| `tokenEndpoint` | `string` | いいえ | tokenEndpoint は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するエンドポイントです。 |

## Vantage.spec.smtp

smtp は SMTP メールサーバーを設定します。指定しない場合は、メールプロバイダーとして Sendgrid が使用されます。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `host` | `string` | はい | host は SMTP サーバーのホスト名です |
| `login` | `string` | いいえ | SMTP 認証に使用するログイン名 |
| `password` | `string` | いいえ | SMTP 認証に使用するパスワード |
| `port` | `integer` | いいえ | port は SMTP サーバーのポート番号です。デフォルト: `587` · 書式: `int32`。 |
| `useSSL` | `boolean` | いいえ | useSSL は SMTP 接続で TLS を有効にします。デフォルト: `false`。 |

## Vantage.spec.storage

storage は高度なストレージオプションを設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `azure` | `object` | いいえ | azure は Azure ストレージバックエンドを設定します。 |
| `custom` | `object` | いいえ | custom はカスタムストレージバックエンドを設定します。[`custom`](#vantagespecstoragecustom) を参照してください。 |

まだサポートされていません。これらのフィールドを設定したリソースは、オペレーターによって拒否されます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `s3` | `object` | いいえ | s3 は S3 ストレージバックエンドを設定します。[`s3`](#vantagespecstorages3) を参照してください。 |

## Vantage.spec.storage.custom

custom は、カスタムストレージバックエンドを設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `size` | `intorstring` | はい | size は PVC のサイズを定義します。デフォルト: `300Gi` · パターン: `^(\+\|-)?(([0-9]+(\.[0-9]*)?)\|(\.[0-9]+))(([KMGTPE]i)\|[numkMGTPE]\|([eE](\+\|-)?(([0-9]+(\.[0-9]*)?)\|(\.[0-9]+))))?$`。 |
| `storageClass` | `string` | はい | storageClass は、カスタムストレージバックエンドのボリュームをマウントする PVC で使用するストレージクラスを定義します。 |

## Vantage.spec.storage.s3

s3 は S3 ストレージバックエンドを設定します。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `buckets` | `object` | いいえ | buckets はストレージバケット名を設定します。[`buckets`](#vantagespecstorages3buckets) を参照してください。 |
| `region` | `string` | いいえ | region は S3 クライアントが使用する AWS リージョンを設定します |
| `scopedClientCredentials` | `object` | いいえ | scopedClientCredentials を設定すると、ストレージサービスは自身のキーレス接続を使用する代わりに、単一のストレージにスコープ設定された短期間有効な認証情報 (STS AssumeRole) をクライアントに渡すようになります。[`scopedClientCredentials`](#vantagespecstorages3scopedclientcredentials) を参照してください。 |
| `uri` | `string` | いいえ | uri は S3 エンドポイント (例: [https://s3.us-east-1.amazonaws.com](https://s3.us-east-1.amazonaws.com) や S3 互換サービス) を設定します。パターン: `^https?://`。 |

## Vantage.spec.storage.s3.buckets

buckets はストレージバケット名を設定します

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `archive` | `string` | いいえ | archive は Archive バケットの名前を設定します。 |
| `permanent` | `string` | いいえ | permanent は Permanent バケットの名前を設定します。 |
| `standard` | `string` | いいえ | standard は Standard バケットの名前を設定します。 |
| `temporary` | `string` | いいえ | temporary は Temporary バケットの名前を設定します |

## Vantage.spec.storage.s3.scopedClientCredentials

scopedClientCredentials を設定すると、ストレージサービスは自身のキーレス接続を使用する代わりに、
単一のストレージにスコープ設定された有効期間の短い認証情報 (STS AssumeRole) をクライアントに渡すようになります。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `credentialsExpiration` | `string` | いいえ | credentialsExpiration は、発行される各認証情報の有効期間です。.NET TimeSpan 形式で指定します (例: 01:00:00) 。デフォルトは 1 時間です。パターン: `^([0-9]+\.)?[0-9]{1,2}:[0-9]{2}:[0-9]{2}$` |
| `enabled` | `boolean` | いいえ | enabled は、スコープ設定されたクライアント認証情報を有効にします。 |
| `roleArn` | `string` | いいえ | roleArn は、認証情報の発行時に引き受ける IAM ロールです。AWS では必須です。 |
| `roleSessionName` | `string` | いいえ | roleSessionName は、roleArn を引き受ける際に使用するセッション名です。 |
| `stsUri` | `string` | いいえ | stsUri は STS エンドポイントを上書きします。指定しない場合、エンドポイントはリージョンから解決されます。パターン: `^https?://` |

## Vantage.spec.techcore

techcore には TechCore processing engine の設定が含まれます。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `versions` | `[]integer` | はい | versions は、デプロイする TechCore のバージョンです (利用可能なバージョンは 2、3、4) 。最小項目数: `1` · Enum: `2, 3, 4`。 |
| `nnTrainingWorkers` | `object` | いいえ | nnTrainingWorkers は、ニューラルネットワークのトレーニングワーカーを設定します。[`nnTrainingWorkers`](#vantagespectechcorenntrainingworkers) を参照してください。 |

## Vantage.spec.techcore.nnTrainingWorkers

nnTrainingWorkers は、ニューラルネットワークのトレーニングワーカーを設定します。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `enabled` | `boolean` | いいえ | ニューラルネットワークのトレーニングワーカーを有効にします。デフォルト: `false`。 |
| `gpu` | `boolean` | いいえ | トレーニングワーカーの GPU アクセラレーションを有効にします。デフォルト: `false`。 |

## Vantage.status

status は Vantage の観測された状態を定義します

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `availableVersions` | `[]string` | いいえ | availableVersions は、リリース URL から入手可能なバージョンの一覧です。 |
| `conditions` | `[]object` | いいえ | conditions は、Vantage リソースの現在の状態を表します。各 condition は一意の型を持ち、リソースの特定の側面のステータスを示します。標準の condition 型は次のとおりです: - "Available": リソースが完全に機能している - "Progressing": リソースが作成中または更新中である - "Degraded": リソースが望ましい状態に到達できなかった、または維持できなかった 各 condition のステータスは True、False、Unknown のいずれかです。[`conditions`](#vantagestatusconditionsindex) を参照してください。 |
| `degradationReasons` | `[]object` | いいえ | degradationReasons は、インストールが劣化状態になっている理由を表します。[`degradationReasons`](#vantagestatusdegradationreasonsindex) を参照してください。 |
| `installedVantageVersion` | `string` | いいえ | installedVantageVersion は、現在実行中のバージョンです。 |
| `observedGeneration` | `integer` | いいえ | observedGeneration は、コントローラーによって「処理」された spec の世代です。書式: `int64`。 |

## Vantage.status.conditions\[index]

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `lastTransitionTime` | `string` | はい | lastTransitionTime は、状態のステータスが最後に別のステータスへ遷移した時刻です。基になる状態が変化した時点を指定してください。それが不明な場合は、API フィールドが変更された時刻を使用しても構いません。書式: `date-time`。 |
| `message` | `string` | はい | message は、遷移の詳細を示す人間が読める形式のメッセージです。空文字列でも構いません。最大長: `32768`。 |
| `reason` | `string` | はい | reason には、状態が最後に遷移した理由を示す、プログラムで扱うための識別子が含まれます。特定の条件の型のプロデューサーは、このフィールドに想定される値とその意味、およびそれらの値を保証された API として扱うかどうかを定義できます。値は CamelCase の文字列にしてください。このフィールドは空にできません。最小長: `1` · 最大長: `1024` · パターン: `^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$`。 |
| `status` | `enum` | はい | 状態のステータスで、True、False、Unknown のいずれかです。Enum: `True, False, Unknown`。 |
| `type` | `string` | はい | 状態の型で、CamelCase または foo.example.com/CamelCase の形式で指定します。最大長: `316` · パターン: `^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$`。 |
| `observedGeneration` | `integer` | いいえ | observedGeneration は、状態を設定する際に基準とした .metadata.generation を表します。たとえば、現在の .metadata.generation が 12 で、.status.conditions\[x].observedGeneration が 9 の場合、その状態はインスタンスの現在の状態から見て古くなっています。書式: `int64` · 最小値: `0`。 |

## Vantage.status.degradationReasons\[index]

DegradationReason は、インストール環境内の個々のコンポーネントが劣化状態にある理由を表します。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `component` | `string` | はい | component は、インストール環境のうち劣化状態にある部分です。 |
| `message` | `string` | はい | message は、コンポーネントの劣化内容を人が読める形式で記述した説明です。 |
| `reason` | `string` | はい | reason には、コンポーネントが劣化した理由を示す、プログラムで処理するための識別子が格納されます。値は CamelCase 形式の string にする必要があります。 |