Azure Marketplace クイックスタート
Azure Marketplace から AGENTIC STAR を購入し、デプロイが完了するまでの手順を解説します。購入フォームで設定値を入力すると、インフラ構築からアプリケーションのインストールまで自動的に行われます。
前提条件
- Azure サブスクリプション
- サブスクリプションに対する共同作成者以上のロール
- 必要な Resource Provider の事前登録(下記を参照)
- vCPU クォータの確保(下記を参照)
AKS クラスタや Helm の事前準備は不要です。すべてのインフラストラクチャは購入時に自動で構築されます。
必要な Azure Resource Provider
本プロダクトのデプロイには、サブスクリプションで以下の Resource Provider が 事前に登録済みである必要があります。未登録の場合、デプロイ途中で MissingSubscriptionRegistration 等のエラーが発生し、10〜20 分経過してから失敗します。
| Resource Provider | 用途 |
|---|---|
Microsoft.Resources | ARM Template の基盤(通常は自動登録済) |
Microsoft.Authorization | ロール割当(RBAC) |
Microsoft.ManagedIdentity | User-Assigned Managed Identity |
Microsoft.Network | VNet / Subnet / NSG / Public IP |
Microsoft.Compute | AKS ノード用 VMSS |
Microsoft.ContainerService | AKS クラスター |
Microsoft.ContainerInstance | デプロイ時の Deployment Script 実行用 ACI |
Microsoft.Storage | Storage Account(Private / Public) |
Microsoft.DBforPostgreSQL | PostgreSQL Flexible Server |
Microsoft.OperationalInsights | Log Analytics Workspace |
Microsoft.Insights | Container Insights / Data Collection Rules |
Microsoft.CognitiveServices | Azure AI Services(Content Safety / PII) |
登録状況の確認
# サブスクリプション全体の登録状況を確認
az provider list --query "[?contains(['Microsoft.Resources','Microsoft.Authorization','Microsoft.ManagedIdentity','Microsoft.Network','Microsoft.Compute','Microsoft.ContainerService','Microsoft.ContainerInstance','Microsoft.Storage','Microsoft.DBforPostgreSQL','Microsoft.OperationalInsights','Microsoft.Insights','Microsoft.CognitiveServices'], namespace)].{Provider:namespace, State:registrationState}" -o table
未登録 Provider の登録
# 個別に登録
az provider register --namespace Microsoft.ContainerInstance
az provider register --namespace Microsoft.Storage
az provider register --namespace Microsoft.Compute
# ... 必要に応じて他の Provider も同様
az provider register は冪等で、既に登録済みの場合は何もしません。登録完了までは数分かかる場合があるため、すべての Provider が Registered 状態になったことを確認してからデプロイを開始してください。
vCPU クォータ
AKS のノードは、サブスクリプションの vCPU クォータ(VM ファミリーごとの上限と、リージョン全体の上限)の範囲でしか作られません。クォータが足りないとノードが増えず、アプリケーションのインストールが途中で止まります。この場合、デプロイは 1 時間以上たってから失敗し、エラーには Azure の一般的な文言しか表示されません。デプロイを始める前に、デプロイ先のリージョンで次のクォータを確保してください。
| クォータ | 必要量 |
|---|---|
| Standard EDSv5 Family vCPUs | 最低 12、推奨 16(既定の VM サイズ Standard_E4ds_v5 で 3〜4 ノード分) |
| Total Regional vCPUs | 上記と同じ以上 |
- 必要量はアプリケーション一式の導入に要する分です。エージェントの実行が増えるとオートスケーラーがノードを足すため、運用規模に応じて余裕を持たせてください
- AKS Advanced Settings で既定以外の VM サイズ(Standard_D4ds_v4 など)を選ぶ場合は、そのファミリー(例: Standard DDSv4 Family vCPUs)で同じ量を確保してください。ファミリーによってはクォータの引き上げ申請が自動承認されないことがあります。申請が通らない場合は既定の Standard_E4ds_v5 を使ってください
- PostgreSQL Flexible Server はこのクォータを消費しません
クォータの確認
# デプロイ先リージョンの使用量と上限を表示(例: 東日本)
az vm list-usage --location japaneast -o table
Standard EDSv5 Family vCPUs と Total Regional vCPUs の行で、Limit から CurrentValue を引いた空きが必要量以上であることを確認します。
クォータの引き上げ
Azure ポータルで「クォータ」→「コンピューティング」を開き、対象のファミリーとリージョンを選んで新しい上限を申請します。自動承認されれば数分で反映されます。自動承認されない場合は、同じ画面からサポートリクエストを作成して申請します。
手順
1. Azure Marketplace で AGENTIC STAR Advanced プランを選択
Azure Marketplace で「AGENTIC STAR」を検索してオファーを開き、プラン「AGENTIC STAR Advanced」を選択して [作成] をクリックします。

2. 基本設定
Azure の標準的な基本設定を入力します。
| 項目 | 説明 |
|---|---|
| サブスクリプション | デプロイ先の Azure サブスクリプション |
| リソースグループ | 新規作成または既存のリソースグループを選択 |
| リージョン | デプロイ先のリージョン |
3. General(一般設定)
| 項目 | 説明 | デフォルト値 | 制約 |
|---|---|---|---|
| Environment Name | 環境の識別名 | agenticstar | 3〜21文字、先頭は小文字、小文字英数字とハイフン |
| Managed Identity Name | マネージド ID の名前 | agtstr-id | 3〜128文字、小文字英数字とハイフン |
| AKS Cluster Name | AKS クラスタの名前 | agtstr-aks | 3〜63文字、小文字英数字とハイフン |
| Administrator Email | 初期管理者のメールアドレス | — | 有効なメールアドレス |
| Administrator Password | 初期管理者のパスワード | — | 12〜128文字、大文字・小文字・数字・特殊文字を各1文字以上含む。特殊文字は @$!%*?& だけ使える |
| Primary Language | UI の表示言語 | 日本語 | 日本語 / English / Français / Español / ไทย / العربية / Bahasa Indonesia / 中文(简体) / 中文(繁體) / Português (Brasil) / Deutsch / Italiano / Tiếng Việt / 한국어 |
4. PostgreSQL Settings(データベース設定)
| 項目 | 説明 | デフォルト値 | 制約 |
|---|---|---|---|
| PostgreSQL Admin Username | DB 管理者ユーザー名 | — | 1〜63文字、先頭は英字、英数字と _ のみ、pg_ で開始不可 |
| PostgreSQL Admin Password | DB 管理者パスワード | — | 12〜128文字、大文字・小文字・数字・特殊文字を各1文字以上含む。特殊文字は @$!%*?& だけ使える |
| PostgreSQL VM Size | サーバーのスペック | Standard_D2ds_v4 | 下記参照 |
| PostgreSQL High Availability | 高可用性モード | Disabled | 下記参照 |
PostgreSQL VM Size の選択肢
| サイズ | スペック | 用途 |
|---|---|---|
Standard_D2ds_v4 | 2 vCPU / 8 GiB RAM | 開発・検証環境向け |
Standard_D4ds_v4 | 4 vCPU / 16 GiB RAM | 小〜中規模の本番環境向け |
Standard_D8ds_v4 | 8 vCPU / 32 GiB RAM | 大規模な本番環境向け |
High Availability の選択肢
| モード | 説明 |
|---|---|
| Disabled | HA なし(最低コスト) |
| Same Zone | 同一ゾーン内でのレプリカ |
| Zone Redundant | ゾーン冗長(本番環境推奨、コンピュートコストが倍になる) |
5. AKS Advanced Settings(オプション)
「Customize AKS Advanced Settings」にチェックを入れると、AKS ノードプールの詳細設定が表示されます。ほとんどの場合、デフォルト設定のままで問題ありません。
既定の Standard_E4ds_v5 は動作に必要な最小構成です。VM サイズを変える場合は、そのファミリーの vCPU クォータを先に確保してください。
System Pool(システムノードプール)
| 項目 | デフォルト値 | 範囲・選択肢 |
|---|---|---|
| Node Count | 1 | 1〜20 |
| Min Count(オートスケーラー) | 1 | 1〜20 |
| Max Count(オートスケーラー) | 8 | 1〜100 |
| VM Size | Standard_E4ds_v5 | Standard_E4ds_v5 / Standard_D4ds_v4 / Standard_D8ds_v4 |
User Pool(ユーザーノードプール)
| 項目 | デフォルト値 | 範囲・選択肢 |
|---|---|---|
| Node Count | 1 | 1〜50 |
| Min Count(オートスケーラー) | 1 | 1〜50 |
| Max Count(オートスケーラー) | 10 | 1〜100 |
| VM Size | Standard_E4ds_v5 | Standard_E4ds_v5 / Standard_D4ds_v4 / Standard_D8ds_v4 |
Availability Zones(可用性ゾーン)
| 項目 | デフォルト値 | 選択肢 |
|---|---|---|
| Availability Zones | Zones 1 & 2 | Zones 1 & 2 / Zones 1 & 3 / Zones 2 & 3 |
2 つのゾーンが両方のノードプールに適用されます。サブスクリプションとリージョンによっては、特定のゾーンに VM を置けないことがあります。デプロイが AvailabilityZoneNotSupported で失敗した場合は、別の組み合わせを選んでやり直してください。
6. Datadog Integration(オプション)
「Enable Datadog Integration」にチェックを入れると、Datadog 連携の設定が表示されます。
| 項目 | 説明 |
|---|---|
| Datadog API Key | Datadog の API キー |
| Datadog Application Key | Datadog のアプリケーションキー |
| Datadog Site | Datadog サイト(AP1 / US1 / US3 / US5 / EU1) |
7. 確認とデプロイ
すべての設定を確認し、[作成] をクリックするとデプロイが開始されます。
デプロイでは以下のリソースが自動的に作成されます:
- AKS クラスタ(System Pool + User Pool、オートスケーラー付き)
- PostgreSQL Flexible Server(v16、pgvector 等の拡張機能インストール済み)
- Storage Account(プライベート用・パブリック用の2つ)
- Virtual Network / NSG(ネットワーク分離設定済み)
- Log Analytics Workspace(Container Insights 連携済み)
- Azure AI Services
- AGENTIC STAR アプリケーション一式(Helm チャートによる自動インストール)
デプロイには約 1 時間かかります。Azure ポータルのデプロイ画面で進行状況を確認できます。
デプロイが失敗した場合は、構築トラブルシューティングガイドを参照してください。失敗した環境でインストールを手作業でやり直すのではなく、原因を直したうえでマネージドアプリケーションを削除して作り直します。
デプロイ完了後
導入の確認
デプロイが成功すると、すべてのコンポーネントが Helm リリースとして導入されています。クラスターに接続し、次の点を確認してください。
# クラスターへの接続(リソースグループはマネージドアプリケーションの管理リソースグループ。名前は mrg- で始まる)
az aks get-credentials --resource-group <管理リソースグループ> --name <AKS Cluster Name>
# Helm リリースが 25 個すべて deployed であること
HELM_DRIVER=configmap helm list -A
# Running / Completed 以外の Pod が無いこと
kubectl get pods -A | grep -v -E 'Running|Completed'
# 初期設定ジョブ(init-platform)が Complete であること
kubectl get jobs -n librechat-auth
マーケットプレイス版は Helm のストレージドライバに configmap を使っています。HELM_DRIVER=configmap を付けないと helm list には何も表示されません。
いずれかが満たされない場合は、構築トラブルシューティングガイドを参照してください。
アクセス用 IP アドレスの確認
デプロイが完了したら、各画面の IP アドレスを確認します。AGENTIC STAR は用途別に 4 つの LoadBalancer を作成します。
kubectl get svc -n ingress-nginx -o wide | grep LoadBalancer
| サービス名 | 用途 | アクセス URL |
|---|---|---|
ingress-nginx-front | メイン画面 | https://<EXTERNAL-IP> |
ingress-nginx-admin | 管理画面 | https://<EXTERNAL-IP> |
ingress-nginx-extapi | API エンドポイント | https://<EXTERNAL-IP> |
ログイン画面(ingress-nginx-auth)は OAuth リダイレクトの仕様上、URL を直接開くとログイン後の画面遷移が成立しません。メイン画面の URL からアクセスし、認証が必要なタイミングでログイン画面へ自動遷移するフローでご利用ください。
自己署名証明書を使用しているため、ブラウザで証明書の警告が表示されます。初回アクセス時は警告を許可して続行してください。
カスタムドメインを設定する場合は、各 LoadBalancer の IP アドレスを DNS の A レコードに登録します。詳しくはドメイン設定ガイドを参照してください。
Azure Standard Load Balancer は静的 Public IP が付与されるため、EXTERNAL-IP 列に IP アドレスが直接表示されます。AWS Marketplace 版では LoadBalancer(NLB)の仕様により ELB DNS 名が表示され、DNS 設定も A レコードではなく CNAME になります。詳しくは AWS 版クイックスタートを参照してください。
ログイン

管理画面の IP アドレスにブラウザでアクセスし、購入フォームで入力した Administrator Email と Administrator Password でログインしてください。
次のステップとして、管理画面での初期設定を行います。詳しくは設定ガイドを参照してください。
API の利用を開始する場合は、マーケットプレイス版 API クイックスタートを参照してください。