アップグレード

Solo Enterprise for agentregistry をアップグレードします。

始める前に

破壊的変更や使用したい新しい設定がないか、チェンジログを確認してください。

アップグレード

Solo Enterprise for agentregistry サーバーが接続している PostgreSQL データベースのバックアップを取得します。Helm アップグレード中に Solo Enterprise for agentregistry がデータを削除することはありませんが、アップグレード中の予期しないエラーに備えて現在のデータのバックアップを作成することがベストプラクティスです。アップグレードが失敗した場合は、データを使って以前のバージョンの製品を安全に復元できます。
```
pg_dump --format=custom --no-owner \
 "postgres://${USER}:${PASSWORD}@${HOST}:5432/agentregistry?sslmode=disable" \
 > agentregistry-backup-$(date -u +%Y%m%dT%H%M%SZ).dump
```
組み込みの PostgreSQL データベースインスタンスを使用している場合は、このコマンドのプレースホルダー値を次の情報に置き換えます。
- $USER: agentregistry
- $PASSWORD: agentregistry
- $HOST: ローカルマシンで agentregistry-enterprise-postgresql-* サービスをポートフォワードして localhost:PORT をホスト値として使用するか、LoadBalancer サービスとして公開してそのアドレスとポートを使用します。
Solo Enterprise for agentregistry サーバーのレプリカが複数ある場合は、1 にスケールダウンします。
```
kubectl scale deploy/agentregistry-enterprise-server -n agentregistry-enterprise --replicas=1
```
アップグレード先のバージョンを環境変数に設定します。最新のパッチバージョン (2026.9.0) などです。
```
export NEW_VERSION=2026.9.0
```

現在のバージョンの Helm values ファイルを取得します。

helm get values agentregistry -n agentregistry-system -o yaml > values.yaml
open values.yaml

現在の Helm チャート values と、アップグレード先バージョンの values を比較し、必要な変更を加えます。
- すべての値を表示する:
  helm show values oci://us-docker.pkg.dev/solo-public/agentregistry-enterprise/helm/agentregistry-enterprise --version 2026.9.0
- すべての値を含むファイルを取得する: Helm チャートをローカルにプルして確認すると、アップグレードバージョンの agentregistry-enterprise/values.yaml ファイルを取得できます。
  helm pull oci://us-docker.pkg.dev/solo-public/agentregistry-enterprise/helm/agentregistry-enterprise --version 2026.9.0 tar -xvf agentregistry-enterprise-2026.9.0.tgz open agentregistry-enterprise/values.yaml
Solo Enterprise for agentregistry の Helm インストールをアップグレードします。新しい Helm values は values.yaml ファイルまたは --set フラグで必ず指定してください。指定しない場合、以前に設定したカスタム値が上書きされる可能性があります。
Warning
バージョン 2026.6.0 では PostgreSQL データベーススキーマが変更されました。Solo Enterprise for agentregistry サーバーのアップグレード中に、既存のデータは旧スキーマから新スキーマへ自動的にコピーされます。設定や Helm の更新は必要ありません。
サーバーをアップグレードする前にデータをマイグレーションして、サーバーがマイグレーション済みのデータベーススキーマで起動するようにすることもできます。その場合は、Solo Enterprise for agentregistry の Helm チャートをアップグレードする前に arctl db migrate コマンドを使用してください。
```
helm upgrade -i -n agentregistry-system agentregistry oci://us-docker.pkg.dev/solo-public/agentregistry-enterprise/helm/agentregistry-enterprise \
  -f values.yaml \
  --version 2026.9.0
```
コントロールプレーンの Pod が起動して実行中であることを確認します。
```
kubectl get pods -n agentregistry-system
```
AWS Bedrock AgentCore ランタイムを使用している場合は、AWS アカウントで Solo Enterprise for agentregistry に付与した IAM 権限を確認します。新しいバージョンでは、エージェントと MCP サーバーバンドルをステージングする S3 バケットの名前が are-<partition>-<hash>-<account-id>-<region> になり、レジストリサーバーがそのバケットを作成できる必要があります。権限がない場合、s3:CreateBucket 呼び出しが拒否されるため、AgentCore へのデプロイは Ready=False 状態のままになります。
この権限は、Solo Enterprise for agentregistry がランタイム用に引き受ける IAM ロールに属し、このロールは CloudFormation テンプレートによって作成されます。権限を追加するには、ランタイム IAM ロールを設定するで説明されているように、テンプレートを再生成してスタックを更新します。更新によってロールが置き換えられないように、スタックがすでに作成したロールの名前を必ず渡してください。

BYO PostgreSQL データベース