メインコンテンツまでスキップ

Azure Marketplace クイックスタート

Azure Marketplace から AGENTIC STAR を購入し、デプロイが完了するまでの手順を解説します。購入フォームで設定値を入力すると、インフラ構築からアプリケーションのインストールまで自動的に行われます。

前提条件​

  • Azure サブスクリプション
  • サブスクリプションに対する共同作成者以上のロール
  • 必要な Resource Provider の事前登録(下記を参照)
  • vCPU クォータの確保(下記を参照)
注記

AKS クラスタや Helm の事前準備は不要です。すべてのインフラストラクチャは購入時に自動で構築されます。

必要な Azure Resource Provider​

本プロダクトのデプロイには、サブスクリプションで以下の Resource Provider が 事前に登録済みである必要があります。未登録の場合、デプロイ途中で MissingSubscriptionRegistration 等のエラーが発生し、10〜20 分経過してから失敗します。

Resource Provider用途
Microsoft.ResourcesARM Template の基盤(通常は自動登録済)
Microsoft.Authorizationロール割当(RBAC)
Microsoft.ManagedIdentityUser-Assigned Managed Identity
Microsoft.NetworkVNet / Subnet / NSG / Public IP
Microsoft.ComputeAKS ノード用 VMSS
Microsoft.ContainerServiceAKS クラスター
Microsoft.ContainerInstanceデプロイ時の Deployment Script 実行用 ACI
Microsoft.StorageStorage Account(Private / Public)
Microsoft.DBforPostgreSQLPostgreSQL Flexible Server
Microsoft.OperationalInsightsLog Analytics Workspace
Microsoft.InsightsContainer Insights / Data Collection Rules
Microsoft.CognitiveServicesAzure AI Services(Content Safety / PII)

登録状況の確認​

curl
# サブスクリプション全体の登録状況を確認
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 の登録​

curl
# 個別に登録
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 はこのクォータを消費しません

クォータの確認​

curl
# デプロイ先リージョンの使用量と上限を表示(例: 東日本)
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」を選択して [作成] をクリックします。

AGENTIC STAR オファーページ

2. 基本設定​

Azure の標準的な基本設定を入力します。

項目説明
サブスクリプションデプロイ先の Azure サブスクリプション
リソースグループ新規作成または既存のリソースグループを選択
リージョンデプロイ先のリージョン

3. General(一般設定)​

項目説明デフォルト値制約
Environment Name環境の識別名agenticstar3〜21文字、先頭は小文字、小文字英数字とハイフン
Managed Identity Nameマネージド ID の名前agtstr-id3〜128文字、小文字英数字とハイフン
AKS Cluster NameAKS クラスタの名前agtstr-aks3〜63文字、小文字英数字とハイフン
Administrator Email初期管理者のメールアドレス—有効なメールアドレス
Administrator Password初期管理者のパスワード—12〜128文字、大文字・小文字・数字・特殊文字を各1文字以上含む。特殊文字は @$!%*?& だけ使える
Primary LanguageUI の表示言語日本語日本語 / English / Français / Español / ไทย / العربية / Bahasa Indonesia / 中文(简体) / 中文(繁體) / Português (Brasil) / Deutsch / Italiano / Tiếng Việt / 한국어

4. PostgreSQL Settings(データベース設定)​

項目説明デフォルト値制約
PostgreSQL Admin UsernameDB 管理者ユーザー名—1〜63文字、先頭は英字、英数字と _ のみ、pg_ で開始不可
PostgreSQL Admin PasswordDB 管理者パスワード—12〜128文字、大文字・小文字・数字・特殊文字を各1文字以上含む。特殊文字は @$!%*?& だけ使える
PostgreSQL VM SizeサーバーのスペックStandard_D2ds_v4下記参照
PostgreSQL High Availability高可用性モードDisabled下記参照

PostgreSQL VM Size の選択肢

サイズスペック用途
Standard_D2ds_v42 vCPU / 8 GiB RAM開発・検証環境向け
Standard_D4ds_v44 vCPU / 16 GiB RAM小〜中規模の本番環境向け
Standard_D8ds_v48 vCPU / 32 GiB RAM大規模な本番環境向け

High Availability の選択肢

モード説明
DisabledHA なし(最低コスト)
Same Zone同一ゾーン内でのレプリカ
Zone Redundantゾーン冗長(本番環境推奨、コンピュートコストが倍になる)

5. AKS Advanced Settings(オプション)​

「Customize AKS Advanced Settings」にチェックを入れると、AKS ノードプールの詳細設定が表示されます。ほとんどの場合、デフォルト設定のままで問題ありません。

注意

既定の Standard_E4ds_v5 は動作に必要な最小構成です。VM サイズを変える場合は、そのファミリーの vCPU クォータを先に確保してください。

System Pool(システムノードプール)

項目デフォルト値範囲・選択肢
Node Count11〜20
Min Count(オートスケーラー)11〜20
Max Count(オートスケーラー)81〜100
VM SizeStandard_E4ds_v5Standard_E4ds_v5 / Standard_D4ds_v4 / Standard_D8ds_v4

User Pool(ユーザーノードプール)

項目デフォルト値範囲・選択肢
Node Count11〜50
Min Count(オートスケーラー)11〜50
Max Count(オートスケーラー)101〜100
VM SizeStandard_E4ds_v5Standard_E4ds_v5 / Standard_D4ds_v4 / Standard_D8ds_v4

Availability Zones(可用性ゾーン)

項目デフォルト値選択肢
Availability ZonesZones 1 & 2Zones 1 & 2 / Zones 1 & 3 / Zones 2 & 3

2 つのゾーンが両方のノードプールに適用されます。サブスクリプションとリージョンによっては、特定のゾーンに VM を置けないことがあります。デプロイが AvailabilityZoneNotSupported で失敗した場合は、別の組み合わせを選んでやり直してください。

6. Datadog Integration(オプション)​

「Enable Datadog Integration」にチェックを入れると、Datadog 連携の設定が表示されます。

項目説明
Datadog API KeyDatadog の API キー
Datadog Application KeyDatadog のアプリケーションキー
Datadog SiteDatadog サイト(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 リリースとして導入されています。クラスターに接続し、次の点を確認してください。

curl
# クラスターへの接続(リソースグループはマネージドアプリケーションの管理リソースグループ。名前は 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 を作成します。

curl
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-extapiAPI エンドポイント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 クイックスタートを参照してください。