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

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

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

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

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

オペレーターがこのリソースをどのように使用するかの概要については、[アーキテクチャ](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 のスキーマです

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `apiVersion` | `string` | はい | vantage.abbyy.com/v1alpha1 |
| `kind` | `string` | はい | Vantage |
| `metadata` | `object` | はい | `metadata` field に含まれる fields については、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 Cloud のバージョンです。表示用の値であり、インストール内容には影響しません。 |
| `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 を有効にすると、Vantage アプリケーションサービスが TLS を終端するリバースプロキシの背後で動作するよう構成されます。デフォルト: `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 | 型 | 必須 | 説明 |
| - | - | - | - |
| `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 | 型 | 必須 | 説明 |
| - | - | - | - |
| `objectName` | `string` | はい | objectName は、Azure Key Vault 内のオブジェクトの名前です。 |
| `objectType` | `enum` | いいえ | objectType は、Key Vault オブジェクトの種類です。デフォルトは「secret」です。デフォルト: `secret` · 列挙値: `secret, key, cert`。 |
| `objectVersion` | `string` | いいえ | objectVersion は、Key Vault オブジェクトの特定のバージョンに固定します。デフォルトでは最新バージョンが使用されます。 |

## Vantage.spec.secrets.kubernetes

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

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

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

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

## Vantage.spec.updatePolicy

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

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

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

| 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 を設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `labels` | `map[string]string` | いいえ | ワークロードの pod に追加するラベルです。 |

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

statefulSet は、チャートの StatefulSet の pod を設定します。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `labels` | `map[string]string` | いいえ | ワークロードの 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 は、チャートの移行ジョブが使用するサービスアカウントを設定します。

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

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

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

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

## Vantage.spec.argocd

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

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `namespace` | `string` | いいえ | namespace は、Argo CD がインストールされている名前空間です。オペレーターはこの名前空間に ApplicationSet を作成し、Argo CD は Applications を作成します。一度設定すると変更できません。デフォルト: `argocd` · 最小長: `1`。 |
| `project` | `string` | いいえ | project は、生成された Applications が属する Argo CD AppProject です。このプロジェクトでは、デプロイ先のクラスターと名前空間が許可されている必要があります。許可されていない場合、Argo CD は同期を拒否します。デフォルト: `default` · 最小長: `1`。 |

> [!NOTE]
>
> **`namespace` の検証**: `self == oldSelf`: namespace は変更できません

## Vantage.spec.keda

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

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

## Vantage.spec.ociMigration

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `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 を宣言しないため、claims は拒否されます。デフォルト: `{"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 | 型 | 必須 | 説明 |
| - | - | - | - |
| `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 | 型 | 必須 | Description |
| - | - | - | - |
| `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 | 型 | 必須 | Description |
| - | - | - | - |
| `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 | 型 | 必須 | Description |
| - | - | - | - |
| `claims` | `[]object` | いいえ | Claims には、spec.resourceClaims で定義されたリソースのうち、このコンテナーが使用するリソースの名前を列挙します。このフィールドは DynamicResourceAllocation フィーチャーゲートが有効な場合にのみ使用できます。このフィールドは変更できません。設定できるのはコンテナーに対してのみです。[`claims`](#vantagespecocimigrationresourcesclaimsindex) を参照してください。 |

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

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

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

## 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 | 型 | 必須 | 説明 |
| - | - | - | - |
| `audience` | `string` | いいえ | audience は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するエンドポイントです。 |
| `clientId` | `string` | いいえ | clientId は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するクライアントIDです。 |
| `tokenEndpoint` | `string` | いいえ | tokenEndpoint は、サービスアカウントトークンを OAuth アクセストークンに交換する際に使用するエンドポイントです。 |

## Vantage.spec.smtp

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `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) を参照してください。 |

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

| 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 ストレージバックエンドを設定します。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `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 | 型 | 必須 | Description |
| - | - | - | - |
| `archive` | `string` | いいえ | archive は、Archive バケットの名前を設定します。 |
| `permanent` | `string` | いいえ | permanent は、Permanent バケットの名前を設定します。 |
| `standard` | `string` | いいえ | standard は、Standard バケットの名前を設定します。 |
| `temporary` | `string` | いいえ | temporary は、Temporary バケットの名前を設定します。 |

## Vantage.spec.storage.s3.scopedClientCredentials

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `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 の設定が含まれます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `versions` | `[]integer` | はい | versions は、デプロイする TechCore のバージョンです (利用可能なバージョンは 2、3、4) 。最小項目数: `1` · 列挙値: `2, 3, 4`。 |
| `nnTrainingWorkers` | `object` | いいえ | nnTrainingWorkers は、ニューラルネットワークのトレーニングワーカーを設定します。[`nnTrainingWorkers`](#vantagespectechcorenntrainingworkers) を参照してください。 |
| `workers` | `object` | いいえ | workers は、TechCore worker のデプロイメントとそのオートスケーリングを調整します。すべての field は keda.enabled が true の場合にのみ有効です。ただし replicaCount は例外で、Deployment の replicas の設定にも使用されます。[`workers`](#vantagespectechcoreworkers) を参照してください。 |

## Vantage.spec.techcore.nnTrainingWorkers

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

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

## Vantage.spec.techcore.workers

workers は、TechCore worker のデプロイメントとそのオートスケーリングを調整します。replicaCount を除くすべてのフィールドは、
keda.enabled が true の場合にのみ有効です。replicaCount は例外で、Deployment の replicas の設定にも使用されます。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `defaults` | `object` | いいえ | defaults は、デプロイされているすべてのバージョンのすべての TechCore worker に適用されます。詳しくは [`defaults`](#vantagespectechcoreworkersdefaults) を参照してください。 |
| `overrides` | `map[string]object` | いいえ | overrides は特定の種類のワーカーに適用され、defaults の上に統合されます。デプロイされているすべての TechCore バージョンが対象です。キーには、バージョンプレフィックスを除いたワーカーの種類を指定します (例: "ocr"、"extraction"、"classification-training") 。デプロイされているどのワーカーにも一致しないキーは影響しません。詳しくは [`overrides`](#vantagespectechcoreworkersoverrideskey) を参照してください。 |

## Vantage.spec.techcore.workers.defaults

defaults は、デプロイされたすべてのバージョンのすべての TechCore worker に適用されます。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `kedaActiveThreadsThreshold` | `integer` | いいえ | kedaActiveThreadsThreshold は、常に確保しておく空きワーカーの数です。デフォルトは 1 です。最小値: `1`。 |
| `kedaThreshold` | `integer` | いいえ | kedaThreshold は、スケールアップのトリガーとなるレプリカあたりのキューの長さです。値が小さいほど早くスケールアップします。デフォルトは 5 です。最小値: `1`。 |
| `maxReplicaCount` | `integer` | いいえ | maxReplicaCount は、オートスケーリングでスケールアップできる上限です。ワーカーのチャートのデフォルトは、最小構成のインストールでは 20 です。フルインストールでは、各チャートで独自の値を設定できます。最小値: `1`。 |
| `replicaCount` | `integer` | いいえ | replicaCount は、負荷が発生する前から稼働させておくワーカーの数であり、オートスケーリングでスケールアップする際の下限となります。keda.enabled が必要です。ワーカーのチャートのデフォルトは、最小構成のインストールでは 1 です。フルインストールでは、各チャートで独自の値を設定できます。ワーカー数を 0 まで減らせるようにするには、scaling.scaleInactiveToZero を使用してください。replicaCount に 0 を指定すると、最小構成のインストールでは未設定、フルインストールではゼロとして解釈されます。最小値: `1`。 |
| `resources` | `object` | いいえ | resources は、1 つのワーカーに割り当てるリソースを設定します。サイジングガイドに記載された合計値は、このワーカーごとの値を基に算出されています。そのため、これを変更するとインストールに必要なリソースも変わります。[`resources`](#vantagespectechcoreworkersdefaultsresources) を参照してください。 |
| `scaleDownStabilizationWindowSecs` | `integer` | いいえ | scaleDownStabilizationWindowSecs は、レプリカが削除されるまでに、負荷の低い状態が継続する必要がある時間です。デフォルトは 300 です。最小値: `0`。 |
| `scaleUpPolicyPodsCount` | `integer` | いいえ | scaleUpPolicyPodsCount は、30 秒ごとに追加できるレプリカの数です。デフォルトは 15 です。最小値: `1`。 |
| `scaling` | `object` | いいえ | scaling は、オートスケーリングの動作を設定します。この設定は、keda.enabled が有効でない場合は効果がありません。[`scaling`](#vantagespectechcoreworkersdefaultsscaling) を参照してください。 |

## Vantage.spec.techcore.workers.defaults.resources

resources は、1 つのワーカーに割り当てるリソースを設定します。サイジングガイドに記載されている合計値は、このワーカー単位の値を基に算出されています。そのため、この値を変更すると、インストールに必要なリソースも変わります。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `cpu` | `integer` | いいえ | cpu は CPU のリミット (コア数) です。リクエストはこの値から算出され、90% の値と 1 コア少ない値のうち、大きい方が使用されます。ほとんどのワーカーのデフォルトは 1 ですが、トレーニングワーカーではより大きな値がデフォルトになります。最小値: `1`。 |
| `gpu` | `integer` | いいえ | gpu は GPU の数で、リクエストとリミットの両方にこの値が設定されます。ワーカーをスケジュール可能な GPU ノードが必要です。最小値: `1`。 |
| `memoryGB` | `integer` | いいえ | memoryGB はメモリのリミット (GiB 単位) です。デフォルト値はワーカーによって異なり、Optical Character Recognition (OCR) では 8 です。最小値: `1`。 |
| `memoryRequestGB` | `integer` | いいえ | memoryRequestGB はメモリのリクエスト (GiB 単位) です。未設定の場合は memoryGB の 0.9 倍になります。ただし、ワーカーのチャートに独自のリクエストが含まれている場合は、その値がそのまま使用され、memoryGB には連動しません。memoryGB をワーカーのデフォルト以外の値に設定する場合は、必ずこの値も設定してください。最小値: `1`。 |

## Vantage.spec.techcore.workers.defaults.scaling

scaling はオートスケーリングの動作を設定します。keda.enabled が有効でない場合、この設定は効果がありません。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `cooldown` | `integer` | いいえ | cooldown は、キューが空になった後もワーカーが稼働し続ける時間 (秒) です。デフォルトは 300 です。最小値: `0`。 |
| `cron` | `object` | いいえ | cron は、業務時間中はワーカーをウォーム状態に保ち、業務時間外はゼロまでスケールダウンできるようにします。scaleInactiveToZero が必要です。また、低優先度のキューのみを処理するワーカーには効果がありません。[`cron`](#vantagespectechcoreworkersdefaultsscalingcron) を参照してください。 |
| `growRate` | `string` | いいえ | growRate は、直近 5 分間に稼働していたワーカー数に対する乗数として指定し、現在の需要を見越してレプリカを先行的にスケーリングします。1 以下の値を指定すると無効になります。デフォルトは、高優先度のワーカーでは 1.3、それ以外のワーカーでは無効です。パターン: `^[0-9]+(\.[0-9]+)?$`。 |
| `scaleInactiveToZero` | `boolean` | いいえ | scaleInactiveToZero は、アイドル状態のワーカーのレプリカをすべて削除します。次のドキュメントの処理時にコールドスタートが発生する代わりに、それまでの間のコアを節約できます。 |

## Vantage.spec.techcore.workers.defaults.scaling.cron

cron は、業務時間中はワーカーをウォーム状態に保ち、業務時間外はワーカーをゼロまでスケールダウンできるようにします。scaleInactiveToZero の設定が必要です。
なお、低優先度キューのみを処理するワーカーには影響しません。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `dayEnd` | `string` | いいえ | dayEnd は、ワーカーをゼロまでスケールダウンできるようになる時刻を cron 形式で指定します。デフォルトは "0 22 \* \* 1-5" です。 |
| `dayStart` | `string` | いいえ | dayStart は、ワーカーを起動する時刻を cron 形式で指定します。デフォルトは "0 7 \* \* 1-5" です。 |
| `timezone` | `string` | いいえ | timezone は、下記の時刻の基準となるタイムゾーンを IANA 名で指定します (例: "America/New\_York") 。デフォルト値と上書き値が統合された後の時点では必須ですが、ここでは省略して継承することもできます。 |

## Vantage.spec.techcore.workers.overrides\[key]

WorkerConfig は、TechCore worker の調整可能な設定を定義します。未設定の field には、ワーカー
チャート自体のデフォルト値がそのまま適用されます。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `kedaActiveThreadsThreshold` | `integer` | いいえ | kedaActiveThreadsThreshold は、常に確保しておく空きワーカーの数です。デフォルトは 1 です。最小値: `1`。 |
| `kedaThreshold` | `integer` | いいえ | kedaThreshold は、スケールアップのトリガーとなるレプリカあたりのキューの長さです。値を小さくするほど早くスケールアップします。デフォルトは 5 です。最小値: `1`。 |
| `maxReplicaCount` | `integer` | いいえ | maxReplicaCount は、オートスケーリングでスケールアップできる上限です。ワーカーチャートのデフォルトは最小構成のインストールでは 20 で、フルインストールでは各チャートが独自の値を設定できます。最小値: `1`。 |
| `replicaCount` | `integer` | いいえ | replicaCount は、負荷が発生する前から稼働させておくワーカーの数で、オートスケーリングでスケールアップする際の下限となります。keda.enabled が必要です。ワーカーチャートのデフォルトは最小構成のインストールでは 1 で、フルインストールでは各チャートが独自の値を設定できます。ワーカーを 0 まで減らせるようにするには、scaling.scaleInactiveToZero を使用してください。replicaCount に 0 を指定すると、最小構成のインストールでは未設定として扱われ、フルインストールでは 0 として扱われます。最小値: `1`。 |
| `resources` | `object` | いいえ | resources は、1 つのワーカーに割り当てるリソースを設定します。サイジングガイドの合計値はこのワーカーあたりの値を基に算出されるため、変更するとインストールに必要なリソースも変わります。[`resources`](#vantagespectechcoreworkersoverrideskeyresources) を参照してください。 |
| `scaleDownStabilizationWindowSecs` | `integer` | いいえ | scaleDownStabilizationWindowSecs は、レプリカが削除されるまでに低負荷の状態が継続している必要がある時間です。デフォルトは 300 です。最小値: `0`。 |
| `scaleUpPolicyPodsCount` | `integer` | いいえ | scaleUpPolicyPodsCount は、30 秒ごとに追加できるレプリカの数です。デフォルトは 15 です。最小値: `1`。 |
| `scaling` | `object` | いいえ | scaling は、オートスケーリングの動作を設定します。keda.enabled が設定されていない場合は効果がありません。[`scaling`](#vantagespectechcoreworkersoverrideskeyscaling) を参照してください。 |

## Vantage.spec.techcore.workers.overrides\[key].resources

resources は、1 つのワーカーに割り当てるリソースを設定します。サイジングガイドに記載されている合計値は、これらのワーカー単位の値をもとに算出されています。そのため、この値を変更すると、インストールに必要なリソースも変わります。

| Field | Type | Required | Description |
| - | - | - | - |
| `cpu` | `integer` | いいえ | cpu は CPU の上限値 (コア単位) です。リクエスト値はこの値から算出され、上限値の 90% と上限値から 1 コアを引いた値のうち、大きい方になります。ほとんどのワーカーのデフォルトは 1 ですが、トレーニングワーカーではより大きな値がデフォルトです。最小値: `1`。 |
| `gpu` | `integer` | いいえ | gpu は GPU の数で、リクエスト値と上限値の両方に設定されます。ワーカーをスケジュールできる GPU ノードが必要です。最小値: `1`。 |
| `memoryGB` | `integer` | いいえ | memoryGB はメモリの上限値 (GiB 単位) です。値はワーカーによって異なり、OCR のデフォルトは 8 です。最小値: `1`。 |
| `memoryRequestGB` | `integer` | いいえ | memoryRequestGB はメモリのリクエスト値 (GiB 単位) です。未設定の場合は memoryGB の 0.9 倍になります。ただし、ワーカーのチャートに独自のリクエスト値が含まれている場合はその値がそのまま使用され、memoryGB には連動しません。memoryGB をワーカーのデフォルト以外の値に設定する場合は、必ずこの値も設定してください。最小値: `1`。 |

## Vantage.spec.techcore.workers.overrides\[key].scaling

scaling はオートスケーリングの動作を設定します。この設定は keda.enabled を指定しない限り効果がありません。

| Field | 型 | 必須 | 説明 |
| - | - | - | - |
| `cooldown` | `integer` | いいえ | cooldown は、キューが空になった後もワーカーが稼働し続ける時間 (秒) です。デフォルトは 300 です。最小値: `0`。 |
| `cron` | `object` | いいえ | cron は、業務時間中はワーカーをウォーム状態に保ち、業務時間外はゼロまでスケールダウンできるようにします。scaleInactiveToZero が必要です。また、低優先度のキューのみを処理するワーカーには効果がありません。[`cron`](#vantagespectechcoreworkersoverrideskeyscalingcron) を参照してください。 |
| `growRate` | `string` | いいえ | growRate は、直近 5 分間にビジー状態だったワーカー数に対する乗数として、現在の需要を見越してレプリカをスケーリングします。1 以下の値を指定すると無効になります。デフォルトは、高優先度のワーカーでは 1.3、それ以外では無効です。パターン: `^[0-9]+(\.[0-9]+)?$`。 |
| `scaleInactiveToZero` | `boolean` | いいえ | scaleInactiveToZero は、アイドル状態のワーカーのレプリカをすべて削除します。次のドキュメントの処理時にコールドスタートが発生する代わりに、アイドル期間中のコアを節約できます。 |

## Vantage.spec.techcore.workers.overrides\[key].scaling.cron

cron は、業務時間中はワーカーを起動状態に保ち、業務時間外にはワーカーをゼロまでスケールダウンできるようにします。
scaleInactiveToZero が必要です。また、低優先度のキューのみを処理するワーカーには影響しません。

| Field | 型 | 必須 | Description |
| - | - | - | - |
| `dayEnd` | `string` | いいえ | ワーカーをゼロまでスケールダウンしてよい時刻を cron 形式で指定します。デフォルトは "0 22 \* \* 1-5" です。 |
| `dayStart` | `string` | いいえ | ワーカーを起動する時刻を cron 形式で指定します。デフォルトは "0 7 \* \* 1-5" です。 |
| `timezone` | `string` | いいえ | dayStart および dayEnd の時刻の基準となるタイムゾーンを IANA 名で指定します (例: "America/New\_York")。デフォルト値と上書き値が統合された後は必須ですが、ここでは省略して継承させることもできます。 |

## Vantage.status

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `availableVersions` | `[]string` | いいえ | availableVersions は、リリース URL から入手可能なバージョンのリストです。 |
| `conditions` | `[]object` | いいえ | conditions は、Vantage リソースの現在の状態を表します。各状態は一意の型を持ち、リソースの特定の側面のステータスを示します。標準の条件の型は次のとおりです: - "Available": リソースが完全に機能している - "Progressing": リソースが作成中または更新中である - "Degraded": リソースが望ましい状態に到達できなかった、または維持できなかった 各状態のステータスは 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 と見なすかどうかを定義できます。値はキャメルケース文字列である必要があります。このフィールドを空にすることはできません。最小長: `1` · 最大長: `1024` · パターン: `^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$`。 |
| `status` | `enum` | はい | 状態のステータスです。True、False、Unknown のいずれかです。列挙値: `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 は、インストール環境内の個々のコンポーネントが機能低下状態になっている理由を表します。

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `component` | `string` | はい | component は、インストール環境のうち機能低下状態になっている部分です。 |
| `message` | `string` | はい | message は、コンポーネントの機能低下について人が読める形式で記述した説明です。 |
| `reason` | `string` | はい | reason には、コンポーネントの機能低下の理由を示す、プログラムで処理するための識別子が格納されます。値はキャメルケース文字列にする必要があります。 |