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.

​
1. 変数を設定する

CHART_REF と REGISTRY_HOST は、Agens から提供される配布情報を設定します。 
CHART_REF="oci://<registry>/<chart>"
CHART_VERSION="1.0.0"
KEY_FILE="./registry-reader.json"
NAMESPACE="agens"
REGISTRY_HOST="<registry-host>"

​
2. chart registry にログインする

helm registry login \
  -u _json_key \
  --password-stdin "${REGISTRY_HOST}" < "${KEY_FILE}"

​
3. namespace を作成する

kubectl create namespace "${NAMESPACE}" --dry-run=client -o yaml | kubectl apply -f -

​
4. imagePullSecret を作成する

kubectl -n "${NAMESPACE}" create secret docker-registry agens-regcred \
  --docker-server="${REGISTRY_HOST}" \
  --docker-username=_json_key \
  --docker-password="$(cat "${KEY_FILE}")" \
  --dry-run=client -o yaml | kubectl apply -f -

​
5. 上書き values を作成する

配布された values.yaml は Agens のデフォルト設定です。そのまま使い、環境ごとの差分だけを your-values.yaml に書きます。 values.yaml には実際のシークレット値を入れないでください。DB パスワードや OAuth client secret などは Kubernetes Secret として作成し、your-values.yaml から参照します。 
global:
  domain: agens.example.com
  imagePullSecrets:
    - name: agens-regcred
  artifactRegistry:
    location: "<provided-location>"
    projectId: "<provided-project-id>"
    repository: "<provided-repository>"

auth:
  appSecret: "replace-with-random-secret"
  encryptionKey: "replace-with-random-secret"

database:
  postgres:
    password: "replace-with-random-secret"

selfhost:
  allowSignupAfterSetup: false

rustfs:
  accessKey: "replace-with-random-secret"
  secretKey: "replace-with-random-secret"
  ingress:
    host: "storage.agens.example.com"

web:
  publicUrl: "https://app.agens.example.com"
  ingress:
    host: "app.agens.example.com"

server:
  publicUrl: "https://api.agens.example.com"
  ingress:
    host: "api.agens.example.com"

storage:
  s3:
    publicEndpoint: "https://storage.agens.example.com"

​
6. デプロイする

helm upgrade --install agens \
  "${CHART_REF}" \
  --version "${CHART_VERSION}" \
  -n "${NAMESPACE}" \
  --create-namespace \
  --timeout 15m \
  -f values.yaml \
  -f your-values.yaml
-f values.yaml -f your-values.yaml の順で指定します。後に指定した your-values.yaml が配布デフォルトを上書きします。

​
7. 確認する

kubectl -n "${NAMESPACE}" get pods
kubectl -n "${NAMESPACE}" get jobs
kubectl -n "${NAMESPACE}" wait --for=condition=complete job/agens-bootstrap --timeout=10m
kubectl -n "${NAMESPACE}" logs job/agens-bootstrap --tail=200
期待する状態:
  • agens-web が running
  • agens-server が running
  • agens-jobs-worker が running
  • agens-bootstrap が completed

​
8. ライセンスキーを登録する

初回ログイン後、Agens UI のライセンス画面で発行済みライセンスキーを登録します。