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.

​
Pod の確認

kubectl -n agens get pods
kubectl -n agens describe pod <pod-name>
kubectl -n agens logs <pod-name> --tail=200

​
Bootstrap job が失敗する

Job とログを確認します。 
kubectl -n agens get jobs
kubectl -n agens describe job agens-bootstrap
kubectl -n agens logs job/agens-bootstrap --tail=200
よくある原因:
  • データベースに接続できない
  • migration が失敗している
  • provider または endpoint の seed data が不足している
  • 必須 Secret が不足している

​
新しい image が反映されない

deployment が :latest と imagePullPolicy: IfNotPresent を使っている場合、Kubernetes が cached image を再利用することがあります。 実行中の image digest を確認します。 
kubectl -n agens get pod -l app.kubernetes.io/component=web \
  -o jsonpath='{range .items[*]}{.metadata.name}{"\n"}{.status.containerStatuses[0].imageID}{"\n"}{end}'
更新時に digest を明示します。 
kubectl -n agens set image deployment/agens-web \
  web=<image>@sha256:<digest>

​
SSL handshake failed

TLS 証明書と Ingress の状態を確認します。 
kubectl -n agens get ingress
kubectl -n agens get managedcertificate
kubectl -n agens describe managedcertificate <name>
マネージド証明書を使っている場合は、証明書が有効になるまで待ってから再度アクセスしてください。

​
ライセンスが未登録になる

Agens UI のライセンス画面でライセンスキーを登録してください。 Secret でライセンスキーを事前設定している場合は、Secret が存在することと、キー変更後に workload を再起動していることを確認します。 
kubectl -n agens get secret agens-license
kubectl -n agens rollout restart deploy/agens-web deploy/agens-server

​
サービス連携が表示されない

bootstrap job が完了し、provider data が投入されていることを確認します。その後、web のログを確認します。 
kubectl -n agens logs deploy/agens-web --tail=200