# 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）    |

#### 登録状況の確認

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

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

#### クォータの確認

```bash
# デプロイ先リージョンの使用量と上限を表示（例: 東日本）
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](https://azuremarketplace.microsoft.com/) で「AGENTIC STAR」を検索してオファーを開き、プラン「AGENTIC STAR Advanced」を選択して **\[作成]** をクリックします。

![AGENTIC STAR オファーページ](https://developers.fd.agenticstar.tm.softbank.jp/assets/images/quickstart-azure-offer-898299e06ccad0b28bd37f9084233922.png)

### 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 クォータ](#vcpu-quota)を先に確保してください。

**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 ポータルのデプロイ画面で進行状況を確認できます。

> **注意**
>
> デプロイが失敗した場合は、[構築トラブルシューティングガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/troubleshooting-guide.md)を参照してください。失敗した環境でインストールを手作業でやり直すのではなく、原因を直したうえでマネージドアプリケーションを削除して作り直します。

## デプロイ完了後

### 導入の確認

デプロイが成功すると、すべてのコンポーネントが Helm リリースとして導入されています。クラスターに接続し、次の点を確認してください。

```bash
# クラスターへの接続（リソースグループはマネージドアプリケーションの管理リソースグループ。名前は 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` には何も表示されません。

いずれかが満たされない場合は、[構築トラブルシューティングガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/troubleshooting-guide.md)を参照してください。

### アクセス用 IP アドレスの確認

デプロイが完了したら、各画面の IP アドレスを確認します。AGENTIC STAR は用途別に 4 つの LoadBalancer を作成します。

```bash
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 レコードに登録します。詳しくは[ドメイン設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/domain-guide.md)を参照してください。

> **クラウド別の差分**
>
> Azure Standard Load Balancer は静的 Public IP が付与されるため、`EXTERNAL-IP` 列に IP アドレスが直接表示されます。AWS Marketplace 版では LoadBalancer（NLB）の仕様により ELB DNS 名が表示され、DNS 設定も A レコードではなく CNAME になります。詳しくは [AWS 版クイックスタート](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/quickstart/quickstart-aws.md)を参照してください。

### ログイン

![管理画面ログイン](https://developers.fd.agenticstar.tm.softbank.jp/assets/images/quickstart-azure-login-108aae8054b69f8c894a8f26185b314a.png)

管理画面の IP アドレスにブラウザでアクセスし、購入フォームで入力した **Administrator Email** と **Administrator Password** でログインしてください。

次のステップとして、管理画面での初期設定を行います。詳しくは[設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/settings-guide.md)を参照してください。

API の利用を開始する場合は、[マーケットプレイス版 API クイックスタート](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/quickstart/call-api.md)を参照してください。
