# Helm Values リファレンス

AGENTIC STAR マーケットプレイス版の Helm チャートで使用される設定パラメータの一覧です。

各パラメータの「ソース」列は値の設定方法を示します。

| ソース       | 説明                         |
| --------- | -------------------------- |
| **固定**    | デフォルトの固定値。通常は変更不要          |
| **UI 入力** | 購入時のデプロイフォームで指定した値が設定される   |
| **自動取得**  | デプロイ時に Azure リソースから自動取得される |
| **自動生成**  | デプロイ時にランダムなシークレットが自動生成される  |

## 自動取得・自動生成されるパラメータの全体像

各サービスのテーブルでは個別の値が「ソース」列に記載されていますが、デプロイ後に「想定どおりに値が設定されているか」を確認するには、ここに集約した一覧を参照してください。特に **`librechat-env-secret`** はメインアプリの主要シークレットが集約される Secret で、ここに格納される値の多くがインストーラーによって自動取得・自動生成されます。

### 自動取得されるパラメータ（Azure リソースから取得）

| パラメータ                                                                                                               | 取得元                                                          | 主な配置先                                                           |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------- |
| `global.azure.subscriptionId`                                                                                       | `az account show`                                            | 各サービスの ConfigMap                                                |
| `global.azure.resourceGroupName`                                                                                    | ARM テンプレート                                                   | 各サービスの ConfigMap                                                |
| `aks.nodeResourceGroup`                                                                                             | `az aks show --query nodeResourceGroup`                      | 各サービスの ConfigMap                                                |
| `global.postgresql.host`                                                                                            | PostgreSQL Flexible Server の FQDN                            | `*-env-secret`                                                  |
| `global.postgresql.database`                                                                                        | ARM テンプレート出力                                                 | `*-env-secret`                                                  |
| `global.objectStorage.azure.connectionString`                                                                       | `az storage account show-connection-string`（Private Storage） | `librechat-env-secret` (key: `AZURE_STORAGE_CONNECTION_STRING`) |
| `global.objectStorage.azure.storageAccountName`                                                                     | ARM テンプレート                                                   | ConfigMap                                                       |
| `global.objectStorage.azure.customDomain`                                                                           | `<storageAccountName>.blob.core.windows.net`                 | ConfigMap                                                       |
| `publicStorage.connectionString`                                                                                    | `az storage account show-connection-string`（Public Storage）  | 公開ストレージ用 Secret                                                 |
| `appConfig.authBaseUrl` / `domainClient` / `domainServer`                                                           | UI 入力ドメインから導出（未入力時は AKS External IP から自動生成）                  | `librechat-env-secret`, ConfigMap                               |
| `env.APP_URL` / `LIBRECHAT_URL` / `ADMIN_CONSOLE_URL`                                                               | 同上                                                           | `librechat-auth-secret`, `agenticai-admin-secret`               |
| `env.WEBAUTHN_RP_ID`                                                                                                | 認証ドメインから導出                                                   | `librechat-auth-secret`                                         |
| `env.ALLOWED_ORIGINS` / `AFD_CHATBOARD_FRONT_AUTH_DOMAIN` / `AFD_CHATBOARD_ADMIN_DOMAIN` / `CHATBOARD_FRONT_DOMAIN` | ドメイン設定から導出                                                   | `extauth-service` ConfigMap                                     |
| `internalHosts.storageHosts`                                                                                        | 内部ストレージ FQDN                                                 | `extauth-service` ConfigMap                                     |

### 自動生成されるパラメータ（ランダムシークレット）

| 用途              | 代表的なキー                                                                        | 生成方式                               |
| --------------- | ----------------------------------------------------------------------------- | ---------------------------------- |
| JWT 署名 / リフレッシュ | `JWT_SECRET` / `JWT_REFRESH_SECRET`                                           | `openssl rand -hex 16` / `-hex 32` |
| 認証情報暗号化         | `CREDS_KEY` / `CREDS_IV`                                                      | `openssl rand -hex 32` / `-hex 16` |
| トークン暗号化         | `TOKEN_ENCRYPTION_KEY`                                                        | `openssl rand -hex 32`             |
| Gate / 外部 API   | `GATE_API_KEY` / `EXT_API_KEY` / `EXT_API_WEBHOOK_SECRET` / `CBF_S2S_API_KEY` | `openssl rand -hex 32`             |
| Keycloak 管理者    | `KEYCLOAK_ADMIN_PASSWORD`                                                     | `openssl rand -base64 12`          |
| Keycloak クライアント | `KEYCLOAK_CLIENT_ID` / `KEYCLOAK_CLIENT_SECRET`                               | `openssl rand -hex 8` / `-hex 32`  |
| Service Account | `SERVICE_ACCOUNT_CLIENT_ID` / `SERVICE_ACCOUNT_CLIENT_SECRET`                 | UUID / `openssl rand -hex 32`      |
| Redis 認証        | `REDIS_PASSWORD`                                                              | `openssl rand -base64 32`          |
| 検索同期 / Webhook  | `SEARCH_SYNC_SECRET` / `WEBHOOK_SECRET`                                       | `openssl rand -hex 32`             |
| Gate 暗号化        | `secrets.encryptionKey` (gate-services)                                       | `openssl rand -hex 32`             |

### デプロイ後の確認方法

デプロイが正常に完了したかは、Kubernetes 上で各 Secret の中身を読んで確認できます。最も重要な確認は `AZURE_STORAGE_CONNECTION_STRING` に正しい接続文字列が格納されているかです。

```bash
# AZURE_STORAGE_CONNECTION_STRING の確認
kubectl get secret librechat-env-secret -n autonomous-agent \
  -o jsonpath='{.data.AZURE_STORAGE_CONNECTION_STRING}' | base64 -d
```

`DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net` の形式であれば正常です。

> **注意**
>
> 空文字 / `CHANGE_ME_*` / `<placeholder>` のような値が返る場合は、インストーラーが何らかの理由で Azure リソースから値を取得できなかった可能性があります。インストーラーのログを確認するか、サポートへ連絡してください。

```bash
# JWT_SECRET など自動生成値の長さ確認（短すぎたら異常）
kubectl get secret librechat-env-secret -n autonomous-agent \
  -o jsonpath='{.data.JWT_SECRET}' | base64 -d | wc -c
```

## 共通設定（common-values）

すべてのサービスで共有される設定です。

### 環境設定

| パラメータ                        | デフォルト | ソース   | 説明                               |
| ---------------------------- | ----- | ----- | -------------------------------- |
| `global.environment`         | —     | UI 入力 | 環境名（Environment Name）            |
| `global.customerEnvironment` | —     | UI 入力 | 環境名と同値                           |
| `global.primary.language`    | `ja`  | UI 入力 | UI の表示言語（ja / en / fr / es / th） |

### コンテナレジストリ

| パラメータ                             | デフォルト   | ソース | 説明               |
| --------------------------------- | ------- | --- | ---------------- |
| `global.imagePullSecret.enabled`  | `false` | 固定  | イメージプルシークレットの有効化 |
| `global.imagePullSecret.name`     | `""`    | 固定  | シークレット名          |
| `global.imagePullSecret.registry` | `""`    | 固定  | レジストリ URL        |

### PostgreSQL

| パラメータ                              | デフォルト   | ソース   | 説明                    |
| ---------------------------------- | ------- | ----- | --------------------- |
| `global.postgresql.host`           | —       | 自動取得  | PostgreSQL サーバーの FQDN |
| `global.postgresql.port`           | `5432`  | 固定    | ポート番号                 |
| `global.postgresql.database`       | —       | 自動取得  | データベース名               |
| `global.postgresql.username`       | —       | UI 入力 | 管理者ユーザー名              |
| `global.postgresql.password`       | —       | UI 入力 | 管理者パスワード              |
| `global.postgresql.useAzureAd`     | `false` | 固定    | Azure AD 認証の使用        |
| `global.postgresql.poolMinSize`    | `5`     | 固定    | コネクションプール最小サイズ        |
| `global.postgresql.poolMaxSize`    | `20`    | 固定    | コネクションプール最大サイズ        |
| `global.postgresql.commandTimeout` | `60`    | 固定    | コマンドタイムアウト（秒）         |
| `global.postgresql.poolTimeout`    | `30`    | 固定    | プールタイムアウト（秒）          |
| `global.postgresql.maxOverflow`    | `10`    | 固定    | 最大オーバーフロー接続数          |

### Azure 設定

| パラメータ                            | デフォルト | ソース  | 説明                 |
| -------------------------------- | ----- | ---- | ------------------ |
| `global.azure.subscriptionId`    | —     | 自動取得 | Azure サブスクリプション ID |
| `global.azure.resourceGroupName` | —     | 自動取得 | リソースグループ名          |

### オブジェクトストレージ

| パラメータ                                           | デフォルト                    | ソース  | 説明               |
| ----------------------------------------------- | ------------------------ | ---- | ---------------- |
| `global.objectStorage.provider`                 | `azure`                  | 固定   | ストレージプロバイダー      |
| `global.objectStorage.azure.container`          | `autonomous-agent-files` | 固定   | Azure Blob コンテナ名 |
| `global.objectStorage.azure.connectionString`   | —                        | 自動取得 | 接続文字列            |
| `global.objectStorage.azure.storageAccountName` | —                        | 自動取得 | ストレージアカウント名      |
| `global.objectStorage.azure.customDomain`       | —                        | 自動取得 | カスタムドメイン         |

### Ingress TLS

| パラメータ                               | デフォルト                 | ソース | 説明                |
| ----------------------------------- | --------------------- | --- | ----------------- |
| `global.ingress.tls.enabled`        | `true`                | 固定  | TLS の有効化          |
| `global.ingress.tls.secretName`     | `selfsigned-tls-cert` | 固定  | TLS 証明書の Secret 名 |
| `global.ingress.tls.useCertManager` | `false`               | 固定  | cert-manager の使用  |
| `global.ingress.tls.clusterIssuer`  | `""`                  | 固定  | ClusterIssuer 名   |

### Kubernetes

| パラメータ                              | デフォルト              | ソース | 説明              |
| ---------------------------------- | ------------------ | --- | --------------- |
| `global.kubernetes.namespace`      | `autonomous-agent` | 固定  | デフォルト Namespace |
| `global.kubernetes.serviceAccount` | `default`          | 固定  | サービスアカウント名      |
| `global.kubernetes.rbac.create`    | `true`             | 固定  | RBAC リソースの作成    |

## メインアプリケーション（librechat）

| パラメータ                              | デフォルト                    | ソース          | 説明                                                                                                  |
| ---------------------------------- | ------------------------ | ------------ | --------------------------------------------------------------------------------------------------- |
| `image.tag`                        | —                        | 固定（バージョンに依存） | イメージタグ                                                                                              |
| `global.domain`                    | `front.agentic.internal` | 固定           | 内部ドメイン                                                                                              |
| `vectordb.enabled`                 | `true`                   | 固定           | ベクトル DB の有効化                                                                                        |
| `nginx-ingress.enabled`            | `false`                  | 固定           | 内蔵 Ingress の無効化（既存を使用）                                                                              |
| `appConfig.buildMode`              | `mp`                     | 固定           | ビルドモード（マーケットプレイス）                                                                                   |
| `appConfig.authBaseUrl`            | —                        | 自動取得         | 認証サービスの URL                                                                                         |
| `appConfig.domainClient`           | —                        | 自動取得         | クライアントドメイン                                                                                          |
| `appConfig.domainServer`           | —                        | 自動取得         | サーバードメイン                                                                                            |
| `appConfig.jwtSecret`              | —                        | 自動生成         | JWT シークレット                                                                                          |
| `appConfig.jwtRefreshSecret`       | —                        | 自動生成         | JWT リフレッシュシークレット                                                                                    |
| `appConfig.credsKey`               | —                        | 自動生成         | 認証情報暗号化キー                                                                                           |
| `appConfig.credsIv`                | —                        | 自動生成         | 認証情報暗号化 IV                                                                                          |
| `appConfig.tokenEncryptionKey`     | —                        | 自動生成         | トークン暗号化キー                                                                                           |
| `appConfig.searchSyncSecret`       | —                        | 自動生成         | 検索同期シークレット                                                                                          |
| `appConfig.gateApiKey`             | —                        | 自動生成         | Gate API キー                                                                                         |
| `appConfig.extApiKey`              | —                        | 自動生成         | 外部 API キー                                                                                           |
| `appConfig.extApiWebhookSecret`    | —                        | 自動生成         | Webhook シークレット                                                                                      |
| `appConfig.cspImgSrcAdditional`    | `""`                     | —            | CSP img-src 追加ドメイン                                                                                  |
| `appConfig.trustProxy`             | `""`（MP 既定 1）            | —            | 送信元 IP 判定で信頼する前段プロキシ段数。Front Door / CloudFront 等を前段に置く場合は `"2"` を指定（未指定だと実利用者ではなく前段プロキシの IP で判定される） |
| `appConfig.webpushVapidPublicKey`  | `""`                     | —            | WebPush VAPID 公開鍵                                                                                   |
| `appConfig.webpushVapidPrivateKey` | `""`                     | —            | WebPush VAPID 秘密鍵                                                                                   |
| `appConfig.webpushVapidEmail`      | `""`                     | —            | WebPush VAPID 通知先メールアドレス                                                                            |
| `mongodb.podAntiAffinityPreset`    | `soft`                   | 固定           | MongoDB の AntiAffinity                                                                              |
| `api.hpa.minReplicas`              | `1`                      | 固定           | 最小レプリカ数                                                                                             |

## 認証サービス（librechat-auth）

| パラメータ                             | デフォルト          | ソース          | 説明                     |
| --------------------------------- | -------------- | ------------ | ---------------------- |
| `image.tag`                       | —              | 固定（バージョンに依存） | イメージタグ                 |
| `env.APP_URL`                     | —              | 自動取得         | 認証サービスの URL            |
| `env.LIBRECHAT_URL`               | —              | 自動取得         | メインアプリの URL            |
| `env.ADMIN_CONSOLE_URL`           | —              | 自動取得         | 管理画面の URL              |
| `env.KEYCLOAK_REALM`              | `agenticstar`  | 固定           | Keycloak レルム名          |
| `env.KEYCLOAK_ADMIN`              | `admin`        | 固定           | Keycloak 管理者名          |
| `env.POSTGRES_DB`                 | `keycloak_db`  | 固定           | Keycloak 用データベース名      |
| `env.BUILD_MODE`                  | `mp`           | 固定           | ビルドモード                 |
| `env.EMAIL_AUTH_ENABLED`          | `true`         | 固定           | 認証メールの有効化              |
| `env.NEXT_PUBLIC_REQUIRE_OAUTH`   | `true`         | 固定           | OAuth 必須               |
| `env.WEBAUTHN_RP_NAME`            | `AGENTIC STAR` | 固定           | WebAuthn 表示名           |
| `env.WEBAUTHN_RP_ID`              | —              | 自動取得         | WebAuthn RP ID（認証ドメイン） |
| `secrets.JWT_SECRET`              | —              | 自動生成         | JWT シークレット             |
| `secrets.TOKEN_ENCRYPTION_KEY`    | —              | 自動生成         | トークン暗号化キー              |
| `secrets.KEYCLOAK_ADMIN_PASSWORD` | —              | 自動生成         | Keycloak 管理者パスワード      |
| `secrets.KEYCLOAK_CLIENT_SECRET`  | —              | 自動生成         | Keycloak クライアントシークレット  |
| `autoscaling.minReplicas`         | `1`            | 固定           | 最小レプリカ数                |
| `keycloakx.replicas`              | `1`            | 固定           | Keycloak レプリカ数         |

## 管理画面（agenticai-admin）

| パラメータ                                 | デフォルト         | ソース          | 説明                      |
| ------------------------------------- | ------------- | ------------ | ----------------------- |
| `image.tag`                           | —             | 固定（バージョンに依存） | イメージタグ                  |
| `env.GEO_BLOCKING_EXCLUDED_COUNTRIES` | `JP`          | 固定           | Geo ブロック除外国（ISO 3166-1） |
| `env.ALLOWED_ORIGINS`                 | —             | 自動取得         | 許可オリジン                  |
| `env.AFD_CHATBOARD_FRONT_AUTH_DOMAIN` | —             | 自動取得         | 認証・フロントドメイン             |
| `env.AFD_CHATBOARD_ADMIN_DOMAIN`      | —             | 自動取得         | 管理画面ドメイン                |
| `env.CHATBOARD_FRONT_DOMAIN`          | —             | 自動取得         | フロントドメイン                |
| `secrets.KEYCLOAK_DB`                 | `keycloak_db` | 固定           | Keycloak データベース名        |
| `secrets.TOKEN_ENCRYPTION_KEY`        | —             | 自動生成         | トークン暗号化キー               |
| `replicaCount`                        | `1`           | 固定           | レプリカ数                   |
| `autoscaling.minReplicas`             | `1`           | 固定           | 最小レプリカ数                 |
| `rbac.create`                         | `true`        | 固定           | RBAC リソースの作成            |

## エージェント実行基盤（agent-executor）

| パラメータ                     | デフォルト   | ソース          | 説明                                  |
| ------------------------- | ------- | ------------ | ----------------------------------- |
| `image.tag`               | —       | 固定（バージョンに依存） | イメージタグ                              |
| `memory.graphiti.enabled` | `false` | 固定           | Graphiti メモリの有効化（FalkorDB 未搭載のため無効） |
| `deployment.replicas`     | `1`     | 固定           | レプリカ数                               |
| `hpa.minReplicas`         | `1`     | 固定           | HPA 最小レプリカ数                         |

## 外部 API（agenticai-extapi）

| パラメータ                     | デフォルト  | ソース          | 説明             |
| ------------------------- | ------ | ------------ | -------------- |
| `image.tag`               | —      | 固定（バージョンに依存） | イメージタグ         |
| `config.LOG_LEVEL`        | `INFO` | 固定           | ログレベル          |
| `secrets.CBF_S2S_API_KEY` | —      | 自動生成         | S2S API キー     |
| `secrets.WEBHOOK_SECRET`  | —      | 自動生成         | Webhook シークレット |
| `replicaCount`            | `1`    | 固定           | レプリカ数          |
| `autoscaling.minReplicas` | `1`    | 固定           | 最小レプリカ数        |

## ゲートウェイ（gate-services）

| パラメータ                           | デフォルト | ソース          | 説明               |
| ------------------------------- | ----- | ------------ | ---------------- |
| `image.tag`                     | —     | 固定（バージョンに依存） | イメージタグ           |
| `appConfig.defaultFromName`     | `""`  | 固定           | メール送信者名          |
| `secrets.apiKey`                | —     | 自動生成         | Gate API キー      |
| `secrets.encryptionKey`         | —     | 自動生成         | 暗号化キー            |
| `secrets.azureConnectionString` | `""`  | 固定           | Azure 接続文字列（未使用） |
| `replicaCount`                  | `1`   | 固定           | レプリカ数            |
| `autoscaling.minReplicas`       | `1`   | 固定           | 最小レプリカ数          |

## ゼロトラスト認可サービス（extauth-service）

| パラメータ                            | デフォルト    | ソース          | 説明                            |
| -------------------------------- | -------- | ------------ | ----------------------------- |
| `image.tag`                      | —        | 固定（バージョンに依存） | イメージタグ                        |
| `webhook.enabled`                | `true`   | 固定           | Webhook の有効化                  |
| `webhook.image.tag`              | —        | 固定（バージョンに依存） | Webhook イメージタグ                |
| `webhook.replicaCount`           | `1`      | 固定           | Webhook レプリカ数                 |
| `webhook.pdb.enabled`            | `false`  | 固定           | Webhook PDB の有効化              |
| `webhook.mutating.failurePolicy` | `Ignore` | 固定           | Webhook 障害時ポリシー               |
| `webhook.affinity`               | `null`   | 固定           | AntiAffinity 無効（単一レプリカ）       |
| `cert-manager.enabled`           | `false`  | 固定           | cert-manager の無効化（別途インストール済み） |
| `cert-manager.installCRDs`       | `false`  | 固定           | CRD インストールの無効化                |
| `replicaCount`                   | `1`      | 固定           | レプリカ数                         |
| `autoscaling.minReplicas`        | `1`      | 固定           | 最小レプリカ数                       |
| `pdb.enabled`                    | `false`  | 固定           | PDB の有効化                      |
| `affinity`                       | `null`   | 固定           | AntiAffinity 無効（単一レプリカ）       |
| `internalHosts.storageHosts`     | —        | 自動取得         | 内部ストレージホスト名（認可バイパス対象）         |

> **ヒント**
>
> セキュリティ強化のためのレプリカ数・PDB・failurePolicy の変更方法は[セキュリティガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/basic/build/guide/security-guide.md)を参照してください。

## ベクトル DB（qdrant）

| パラメータ                           | デフォルト   | ソース | 説明                |
| ------------------------------- | ------- | --- | ----------------- |
| `qdrant.replicaCount`           | `1`     | 固定  | レプリカ数             |
| `qdrant.config.cluster.enabled` | `false` | 固定  | クラスターモードの有効化      |
| `loadBalancer.enabled`          | `false` | 固定  | LoadBalancer の有効化 |
| `dashboard.enabled`             | `false` | 固定  | ダッシュボードの有効化       |

> **危険**
>
> `loadBalancer.enabled` および `dashboard.enabled` は本番環境では必ず `false` にしてください。有効化すると外部からのアクセスが可能になり、データ漏洩のリスクがあります。

## データベースマイグレーション（db-migration）

| パラメータ                       | デフォルト         | ソース          | 説明                 |
| --------------------------- | ------------- | ------------ | ------------------ |
| `image.tag`                 | —             | 固定（バージョンに依存） | イメージタグ             |
| `secrets.create`            | `true`        | 固定           | Secret の自動作成       |
| `secrets.keycloakDb`        | `keycloak_db` | 固定           | Keycloak データベース名   |
| `jobs.migrate.enabled`      | `true`        | 固定           | マイグレーションジョブの有効化    |
| `jobs.migrate.backoffLimit` | `0`           | 固定           | リトライ回数             |
| `jobs.migrate.target`       | `head`        | 固定           | マイグレーションターゲット      |
| `jobs.downgrade.enabled`    | `false`       | 固定           | ダウングレードジョブの有効化     |
| `masterData.enabled`        | `true`        | 固定           | マスターデータ投入の有効化      |
| `qdrant.enabled`            | `true`        | 固定           | Qdrant 初期データ投入の有効化 |

## 掲載対象外のサービス

以下のサービスの values は本リファレンスに掲載していません。これらは監視・インフラ基盤のサービスで、ユーザーが設定を変更する必要は通常ありません。

| サービス                           | 説明                |
| ------------------------------ | ----------------- |
| **kube-prometheus-stack**      | Prometheus 監視スタック |
| **prometheus-adapter**         | カスタムメトリクス API     |
| **ingress-nginx**              | Ingress コントローラー   |
| **loki**                       | ログストレージ           |
| **alloy-logs / alloy-metrics** | ログ・メトリクスコレクター     |
| **k8s-monitoring**             | Kubernetes モニタリング |
| **agenticai-observability**    | Grafana / Jaeger  |
| **agenticai-datadog**          | Datadog 連携        |
| **pvc-lifecycle-manager**      | PVC ライフサイクル管理     |
| **init-platform**              | プラットフォーム初期化ジョブ    |

これらのサービスの設定変更が必要な場合は、`helm get values <リリース名> -n <namespace>` で現在の値を確認してください。
