アプリアップデートガイド

AGENTIC STAR マーケットプレイス版の Kubernetes アプリケーションをアップデートする手順を解説します。

アップデート方法は次の 2 通りから選択できます。通常は 方法A（セルフアップデート） を推奨します。

方法	概要	推奨ケース
方法A: 管理画面からのセルフアップデート（推奨）	管理画面の「バージョン管理」ページから対象バージョンを選択して実行。各サービスのアップグレードを自動で順次実行する。	通常のアップデート全般
方法B: 手動アップデート（CLI操作）	`kubectl` / `helm` を直接操作して個別チャートをアップグレード。	個別の細かい制御が必要な場合、CI/CD への組み込み、トラブル時のリカバリ

方法A: 管理画面からのセルフアップデート（推奨）

管理画面の「バージョン管理」ページから、利用可能な次バージョンへ自動でアップグレードを実行できます。各サービスは事前に定義された依存関係順に順次アップグレードされ、進捗・結果が画面で確認できます。

A-1. 前提条件

管理画面（https://admin.<your-domain> 等）に管理者権限でログイン可能であること
アンブレラチャート (agentic-star-platform) が公式 Helm リポジトリで配信済みであること
アップグレードコントローラー (upgrade-controller) が AKS 上で稼働中であること

A-2. バージョン管理画面を開く

管理画面にログイン後、左サイドバーの 「バージョン管理」 メニューをクリックします。

バージョン管理画面（アップデート前）

画面では以下が確認できます。

現在のバージョン: 現在デプロイされているプラットフォームのバージョン（例: v2.0.0）と deployed ステータス
利用可能なバージョン: アップグレード可能な次バージョン（「次のバージョン」ラベル）と、各バージョンのリリースノートへのリンク
デプロイ済みチャート一覧: 各サブチャートの現在のバージョンと状態

注記

利用可能なバージョン一覧は順次アップグレード方式です。複数バージョン先までジャンプはできず、必ず「次のバージョン」を順番に適用していく必要があります。

A-3. アップグレード対象を選択

「利用可能なバージョン」セクションで、アップグレードしたい次バージョン（v2.1.0 など）の右側にある 「選択」 ボタンをクリックします。

A-4. リリースノート・変更内容を確認

「アップグレード分析」画面が表示されます。

アップグレード分析画面

ここでは以下を確認できます。

リリースノート（新機能、変更点、セキュリティ修正など）
全 N チャート中、何チャートが更新対象か
各サービスで自動適用される値（auto_set）と、入力が必要な値（user_input）
user_input がある場合: 入力フォームが表示されます。各項目のヒントを確認しながら値を入力してください

確認・入力が完了したら、画面右上の 「アップグレード実行」 ボタンをクリックします。

A-5. 実行確認

実行確認モーダルが表示されます。

アップグレード実行確認モーダル

警告メッセージを確認します。

アップグレード対象のチャート数
Helm 管理外の変更が検出された場合の警告（再設定が必要な場合あり）
アップグレード中の一時的なサービス影響について

問題なければ 「実行する」 をクリックします。中止したい場合は「キャンセル」を選択してください。

A-6. 進捗確認

アップグレードが開始され、進捗画面が表示されます。

アップグレード実行中画面

画面では以下が確認できます。

全体の進捗バー
現在処理中のチャート名（<chart-name> をアップグレード中...）
各チャートのステータス（processing / completed / skipped / failed）

注記

バージョン変更がない（既に target_version でデプロイされている）チャートは skipped として表示され、helm upgrade はスキップされます。

このページは閉じても処理は継続しますが、進捗を見届けたい場合は開いたままにしてください。

A-7. 完了確認

すべてのチャート処理が完了すると、完了画面が表示されます。

アップグレード完了画面

完了画面では以下を確認します。

ヘッダーに 「✓ アップグレード完了」 が表示されること
サマリ: 成功 / スキップ / 失敗 の件数
- 失敗が 0 であることを必ず確認
各チャートのステータス一覧

最後に upgrade-controller 自身も自己アップグレードを実行します（completed 表示）。

完了後、「バージョン管理に戻る」 ボタンをクリックしてバージョン管理画面に戻ります。

A-8. アップデート後の確認

バージョン管理画面で、「現在のバージョン」が新バージョンに更新されていることを確認します。

アップデート後のバージョン管理画面

現在のバージョン: 新バージョンが deployed 最新 で表示されること
デプロイ済みチャート一覧: 各サブチャートが新しいバージョンで deployed 状態であること

A-9. トラブルシューティング

状況	対応
ロック状態が解除されず再実行できない	別のアップグレードが進行中でないか確認。問題なければ管理者がロックを強制解除する
失敗したチャートがある	完了画面の失敗チャートのエラーメッセージを確認。AKS 上の Pod 状態 (`kubectl get pods -A`) と該当 Pod のログを確認の上、必要に応じて方法B（手動アップデート）でリカバリする
進捗画面が長時間動かない	upgrade-controller の Pod ログを確認 (`kubectl logs -n upgrade-controller deploy/upgrade-controller`)
「Helm 管理外の変更が検出されています」警告が出た	アップグレード後に手動で適用していた設定が上書きされる可能性がある。完了後にカスタム設定を再適用する

方法B: 手動アップデート（CLI操作）

kubectl / helm で各チャートを個別にアップグレードする手順です。CI/CD への組み込みや、方法A で失敗したサービスのリカバリ時に利用します。

B-1. 前提条件

AKS クラスタに kubectl で接続済み
Helm v3 がインストール済み
対象クラスタの管理者権限

注記

マーケットプレイス環境では Helm のストレージドライバが configmap のため、すべての helm コマンドに HELM_DRIVER=configmap を付与する必要があります。

B-2. アップデートの流れ

新バージョンのアンブレラ Helm チャートをダウンロード
展開して Chart.yaml から各サービスのバージョンを確認
個別チャートをダウンロード
各サービスを helm upgrade --reuse-values でアップデート
アップデート後の動作確認

B-3. アンブレラ Helm チャートのダウンロード

公開リポジトリから最新のアンブレラチャートをダウンロードします。

curl
# アンブレラチャートをダウンロード（バージョンは適宜変更）
curl -O https://agtstrmarketplacecharts.blob.core.windows.net/charts/agentic-star-platform-1.1.3.tgz

# 展開
tar xzf agentic-star-platform-1.1.3.tgz

B-4. バージョンの確認

展開した Chart.yaml に各サービスの個別バージョンが定義されています。

curl
cat agentic-star-platform/Chart.yaml

B-5. 個別チャートのダウンロード

Helm リポジトリを追加し、Chart.yaml に記載されたバージョンのチャートをダウンロードします。

curl
# AGENTIC STAR リポジトリを追加
helm repo add agenticai-prod https://agtstrmarketplacecharts.blob.core.windows.net/charts
helm repo update

# 個別チャートをダウンロード（例: agenticai-admin 1.1.3）
helm pull agenticai-prod/agenticai-admin --version 1.1.3 -d charts/

B-6. サービス一覧

以下がマーケットプレイス版に含まれるサービスの一覧です。

アプリケーションコンポーネント

リリース名	Namespace	備考
`librechat`	`agentic-star-front`	メインアプリケーション
`librechat-auth`	`librechat-auth`	認証サービス（Keycloak）
`agenticai-admin`	`agentic-star-admin`	管理画面
`agent-executor`	`agent-executor`	エージェント実行基盤
`agenticai-extapi`	`agenticai-extapi-service`	外部 API
`gate-services`	`gate-services`	ゲートウェイ・ルーティング
`db-migration`	`db-migration`	データベースマイグレーション

セキュリティ・インフラ

リリース名	Namespace	備考
`extauth-service`	`proxy-system`	ゼロトラスト認可サービス
`ingress-nginx`	`ingress-nginx`	Ingress コントローラー
`qdrant`	`qdrant`	ベクトル DB

監視・運用

リリース名	Namespace	備考
`prometheus-operator`	`monitoring`	Prometheus 監視スタック
`loki`	`observability`	ログストレージ
`alloy-logs`	`observability`	ログコレクター
`alloy-metrics`	`observability`	メトリクスコレクター
`k8s-monitoring`	`observability`	Kubernetes モニタリング
`agenticai-observability`	`observability`	Grafana / Jaeger
`agenticai-datadog`	`agenticai-datadog`	Datadog 連携（オプション）
`pvc-lifecycle-manager`	`pvc-lifecycle-manager`	PVC ライフサイクル管理

プラットフォーム初期化

リリース名	Namespace	備考
`init-platform`	`librechat-auth`	初期化ジョブ（通常アップデート不要）

B-7. アップデートコマンド

基本パターン

ほとんどのサービスは以下のパターンでアップデートできます。--reuse-values により既存の設定値はすべて保持され、--set-string "image.tag=..." で指定したイメージタグのみが更新されます。

curl
export HELM_DRIVER=configmap

HELM_DRIVER=configmap helm upgrade <リリース名> <チャートパス> \
  --namespace <namespace> \
  --reuse-values \
  --set-string "image.tag=<バージョン>" \
  --wait \
  --timeout 10m

アプリケーションコンポーネント

librechat（メインアプリケーション）:

curl
HELM_DRIVER=configmap helm upgrade librechat ./charts/librechat-1.1.3.tgz \
  --namespace agentic-star-front \
  --reuse-values \
  --set-string "image.tag=1.1.3" \
  --wait \
  --timeout 20m

librechat-auth（認証サービス）:

curl
HELM_DRIVER=configmap helm upgrade librechat-auth ./charts/librechat-auth-1.1.3.tgz \
  --namespace librechat-auth \
  --reuse-values \
  --set-string "image.tag=1.1.3" \
  --wait \
  --timeout 20m

agenticai-admin（管理画面）:

curl
HELM_DRIVER=configmap helm upgrade agenticai-admin ./charts/agenticai-admin-1.1.3.tgz \
  --namespace agentic-star-admin \
  --reuse-values \
  --set-string "image.tag=1.1.3" \
  --wait \
  --timeout 10m

agent-executor（エージェント実行基盤）:

curl
HELM_DRIVER=configmap helm upgrade agent-executor ./charts/agent-executor-1.1.3.tgz \
  --namespace agent-executor \
  --reuse-values \
  --set-string "image.tag=1.1.3" \
  --wait \
  --timeout 20m

agenticai-extapi(外部 API):

curl
HELM_DRIVER=configmap helm upgrade agenticai-extapi ./charts/agenticai-extapi-1.0.0.tgz \
  --namespace agenticai-extapi-service \
  --reuse-values \
  --set-string "image.tag=1.0.0" \
  --wait \
  --timeout 10m

gate-services（ゲートウェイ）:

curl
HELM_DRIVER=configmap helm upgrade gate-services ./charts/gate-services-1.1.0.tgz \
  --namespace gate-services \
  --reuse-values \
  --set-string "image.tag=1.1.0" \
  --wait \
  --timeout 10m

db-migration（データベースマイグレーション）:

curl
HELM_DRIVER=configmap helm upgrade db-migration ./charts/db-migration-1.1.3.tgz \
  --namespace db-migration \
  --reuse-values \
  --set-string "image.tag=1.1.3" \
  --wait \
  --timeout 10m

セキュリティ・インフラ

extauth-service（ゼロトラスト認可サービス）:

curl
HELM_DRIVER=configmap helm upgrade extauth-service ./charts/extauth-service-1.0.0.tgz \
  --namespace proxy-system \
  --reuse-values \
  --set-string "image.tag=1.0.0" \
  --set-string "webhook.image.tag=1.0.0" \
  --set cert-manager.enabled=false \
  --wait \
  --timeout 20m

注意

extauth-service は webhook.image.tag も合わせて指定してください。また cert-manager.enabled=false を必ず付与してください（cert-manager は別途インストール済みのため）。

ingress-nginx（Ingress コントローラー）:

curl
HELM_DRIVER=configmap helm upgrade ingress-nginx ./charts/ingress-nginx-4.14.0.tgz \
  --namespace ingress-nginx \
  --reuse-values \
  --wait \
  --timeout 10m

qdrant（ベクトル DB）:

curl
HELM_DRIVER=configmap helm upgrade qdrant ./charts/qdrant-1.1.0.tgz \
  --namespace qdrant \
  --reuse-values \
  --wait \
  --timeout 20m

監視・運用

prometheus-operator（Prometheus 監視スタック）:

curl
HELM_DRIVER=configmap helm upgrade prometheus-operator ./charts/kube-prometheus-stack-79.5.0.tgz \
  --namespace monitoring \
  --reuse-values \
  --wait \
  --timeout 15m

注記

チャート名は kube-prometheus-stack ですが、リリース名は prometheus-operator です。

loki（ログストレージ）:

curl
HELM_DRIVER=configmap helm upgrade loki ./charts/loki-6.37.0.tgz \
  --namespace observability \
  --reuse-values \
  --wait \
  --timeout 20m

alloy-logs（ログコレクター）:

curl
HELM_DRIVER=configmap helm upgrade alloy-logs ./charts/alloy-1.1.2.tgz \
  --namespace observability \
  --reuse-values \
  --wait \
  --timeout 20m

alloy-metrics（メトリクスコレクター）:

curl
HELM_DRIVER=configmap helm upgrade alloy-metrics ./charts/alloy-1.1.2.tgz \
  --namespace observability \
  --reuse-values \
  --wait \
  --timeout 20m

注記

alloy-logs と alloy-metrics は同じチャート（alloy-1.1.2.tgz）を使用しますが、リリース名と values が異なります。

k8s-monitoring（Kubernetes モニタリング）:

curl
HELM_DRIVER=configmap helm upgrade k8s-monitoring ./charts/k8s-monitoring-3.1.2.tgz \
  --namespace observability \
  --reuse-values \
  --wait \
  --timeout 15m

agenticai-observability（Grafana / Jaeger）:

curl
HELM_DRIVER=configmap helm upgrade agenticai-observability ./charts/agenticai-observability-1.0.0.tgz \
  --namespace observability \
  --reuse-values \
  --wait \
  --timeout 15m

agenticai-datadog（Datadog 連携）:

curl
HELM_DRIVER=configmap helm upgrade agenticai-datadog ./charts/agenticai-datadog-1.0.0.tgz \
  --namespace agenticai-datadog \
  --reuse-values \
  --wait \
  --timeout 10m

pvc-lifecycle-manager（PVC ライフサイクル管理）:

curl
HELM_DRIVER=configmap helm upgrade pvc-lifecycle-manager ./charts/pvc-lifecycle-manager-1.0.0.tgz \
  --namespace pvc-lifecycle-manager \
  --reuse-values \
  --wait \
  --timeout 10m

B-8. アップデート後の確認

Pod の状態確認

curl
# 全 Namespace の Pod 状態を一括確認
HELM_DRIVER=configmap helm list -A

# 特定 Namespace の Pod 確認
kubectl get pods -n <namespace>

ログの確認

アップデート後にエラーが発生していないか確認します。

curl
# 特定 Pod のログ確認
kubectl logs -n <namespace> <pod-name>

# 直近のイベント確認
kubectl get events -n <namespace> --sort-by='.lastTimestamp'

注意事項

アップデートはサービス単位で実行してください。全サービスを一度にアップデートするのではなく、1つずつ確認しながら進めることを推奨します（方法A は内部で順次実行されます）。
--reuse-values を使用するため、ドメイン設定ガイドやセキュリティガイドで変更した設定値はそのまま保持されます。
アップデート前にバックアップを取得することを推奨します。
問題が発生した場合は、前バージョンのチャートで同じコマンドを実行することでロールバックできます（方法B）。

方法A: 管理画面からのセルフアップデート（推奨）​

A-1. 前提条件​

A-2. バージョン管理画面を開く​

A-3. アップグレード対象を選択​

A-4. リリースノート・変更内容を確認​

A-5. 実行確認​

A-6. 進捗確認​

A-7. 完了確認​

A-8. アップデート後の確認​

A-9. トラブルシューティング​

方法B: 手動アップデート（CLI操作）​

B-1. 前提条件​

B-2. アップデートの流れ​

B-3. アンブレラ Helm チャートのダウンロード​

B-4. バージョンの確認​

B-5. 個別チャートのダウンロード​

B-6. サービス一覧​

アプリケーションコンポーネント​

セキュリティ・インフラ​

監視・運用​

プラットフォーム初期化​

B-7. アップデートコマンド​

基本パターン​

アプリケーションコンポーネント​

セキュリティ・インフラ​

監視・運用​

B-8. アップデート後の確認​

Pod の状態確認​

ログの確認​

注意事項​

方法A: 管理画面からのセルフアップデート（推奨）

A-1. 前提条件

A-2. バージョン管理画面を開く

A-3. アップグレード対象を選択

A-4. リリースノート・変更内容を確認

A-5. 実行確認

A-6. 進捗確認

A-7. 完了確認

A-8. アップデート後の確認

A-9. トラブルシューティング

方法B: 手動アップデート（CLI操作）

B-1. 前提条件

B-2. アップデートの流れ

B-3. アンブレラ Helm チャートのダウンロード

B-4. バージョンの確認

B-5. 個別チャートのダウンロード

B-6. サービス一覧

アプリケーションコンポーネント

セキュリティ・インフラ

監視・運用

プラットフォーム初期化

B-7. アップデートコマンド

基本パターン

アプリケーションコンポーネント

セキュリティ・インフラ

監視・運用

B-8. アップデート後の確認

Pod の状態確認

ログの確認

注意事項