Skip to main content

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.

配布された values.yaml は Agens のデフォルト設定としてそのまま使います。環境ごとの設定は your-values.yaml に書き、Helm 実行時に後から読み込ませます。 
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 から提供される配布情報を設定します。ユーザーが任意に決める値ではありません。 
global:
  artifactRegistry:
    location: "<provided-location>"
    projectId: "<provided-project-id>"
    repository: "<provided-repository>"
同じ配布情報を使って、CHART_REF と REGISTRY_HOST も設定します。

​
必須の設定

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

​
認証 Secret

安定したランダム値を使ってください。ユーザーや接続情報が存在する状態で変更すると、セッションが無効になったり、暗号化済みの接続 credential を復号できなくなったりします。 
auth:
  appSecret: "replace-with-random-secret"
  encryptionKey: "replace-with-random-secret"
本番では Kubernetes Secret を事前に作成し、existing secret として参照することを推奨します。 
auth:
  existingSecret: agens-auth
  existingSecretAppSecretKey: app-auth-secret
  existingSecretEncryptionKeyKey: auth-server-encryption-key

​
サインアップ設定

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

​
Image pull policy

本番では mutable tag を避け、固定 tag または digest 指定を推奨します。 
image:
  pullPolicy: IfNotPresent
latest を使う場合は、各コンポーネントの pull policy を Always にするか、更新時に digest を明示してください。そうしないと、Kubernetes がノード上の cached image を使い続ける場合があります。