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

# 設定

> Agens セルフホスト版で重要な Helm values です。

配布された `values.yaml` は Agens のデフォルト設定としてそのまま使います。環境ごとの設定は `your-values.yaml` に書き、Helm 実行時に後から読み込ませます。

```bash theme={null}
helm upgrade --install agens <chart> \
  -f values.yaml \
  -f your-values.yaml
```

`your-values.yaml` には差分だけを書きます。実際のシークレット値は直接書かず、Kubernetes Secret を参照してください。

## 配布情報

`global.artifactRegistry.location`、`global.artifactRegistry.projectId`、`global.artifactRegistry.repository` は Agens から提供される配布情報を設定します。ユーザーが任意に決める値ではありません。

```yaml theme={null}
global:
  artifactRegistry:
    location: "<provided-location>"
    projectId: "<provided-project-id>"
    repository: "<provided-repository>"
```

同じ配布情報を使って、`CHART_REF` と `REGISTRY_HOST` も設定します。

## 必須の設定

| 項目           | Values                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------- |
| イメージ取得       | `global.imagePullSecrets`                                                                                     |
| 配布 registry  | `global.artifactRegistry.location`, `global.artifactRegistry.projectId`, `global.artifactRegistry.repository` |
| 認証 Secret    | `auth.appSecret`, `auth.encryptionKey` または `auth.existingSecret`                                              |
| データベース       | `database.postgres.password` または外部 DB 設定                                                                      |
| 公開 URL       | `web.publicUrl`, `server.publicUrl`, `storage.s3.publicEndpoint`                                              |
| ストレージ Secret | `rustfs.accessKey`, `rustfs.secretKey` または existing secret                                                    |

## 認証 Secret

安定したランダム値を使ってください。ユーザーや接続情報が存在する状態で変更すると、セッションが無効になったり、暗号化済みの接続 credential を復号できなくなったりします。

```yaml theme={null}
auth:
  appSecret: "replace-with-random-secret"
  encryptionKey: "replace-with-random-secret"
```

本番では Kubernetes Secret を事前に作成し、existing secret として参照することを推奨します。

```yaml theme={null}
auth:
  existingSecret: agens-auth
  existingSecretAppSecretKey: app-auth-secret
  existingSecretEncryptionKeyKey: auth-server-encryption-key
```

## サインアップ設定

```yaml theme={null}
selfhost:
  allowSignupAfterSetup: false
```

ユーザーが存在しない状態では、最初のユーザーが登録できます。最初のユーザー作成後は、この値を `false` のままにして招待制にすることを推奨します。

## Image pull policy

本番では mutable tag を避け、固定 tag または digest 指定を推奨します。

```yaml theme={null}
image:
  pullPolicy: IfNotPresent
```

`latest` を使う場合は、各コンポーネントの pull policy を `Always` にするか、更新時に digest を明示してください。そうしないと、Kubernetes がノード上の cached image を使い続ける場合があります。