設定 - Agens

配布された 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`
配布 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 を復号できなくなったりします。

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 を使い続ける場合があります。

はじめに

Agens の機能

設定マニュアル

セルフホスト

設定

配布情報

必須の設定

認証 Secret

サインアップ設定

Image pull policy

​配布情報

​必須の設定

​認証 Secret

​サインアップ設定

​Image pull policy

配布情報

必須の設定

認証 Secret

サインアップ設定

Image pull policy