> ## 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 の chart と image を安全に更新します。

初回インストールもアップグレードも `helm upgrade --install` を使います。

## アップグレード前の確認

* 対象 chart version を確認します。
* values の差分を確認します。
* PostgreSQL をバックアップします。
* DB migration が含まれるか確認します。
* bootstrap で endpoint data の ingest が必要か確認します。
* rollback 手順を確認します。

## アップグレードコマンド

```bash theme={null}
helm upgrade --install agens \
  "${CHART_REF}" \
  --version "${CHART_VERSION}" \
  -n "${NAMESPACE}" \
  --timeout 15m \
  -f values.yaml \
  -f your-values.yaml
```

## rollout を確認する

```bash theme={null}
kubectl -n "${NAMESPACE}" rollout status deploy/agens-web --timeout=5m
kubectl -n "${NAMESPACE}" rollout status deploy/agens-server --timeout=5m
kubectl -n "${NAMESPACE}" rollout status deploy/agens-jobs-worker --timeout=5m
kubectl -n "${NAMESPACE}" get pods
```

## Mutable tag を使う場合

`latest` のような mutable tag と `imagePullPolicy: IfNotPresent` を組み合わせると、Kubernetes が cached image を使い続ける場合があります。

固定 tag または digest 指定を推奨します。

```bash theme={null}
kubectl -n agens set image deployment/agens-web \
  web=<image>@sha256:<digest>
```

mutable tag を使う場合は、pull policy を `Always` にしてください。

## Rollback

```bash theme={null}
helm -n "${NAMESPACE}" history agens
helm -n "${NAMESPACE}" rollback agens <REVISION>
```

rollback 後も rollout 状態を確認してください。