# Azure Marketplace クイックスタート

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

## 前提条件

- Azure サブスクリプション
- サブスクリプションに対する**共同作成者**以上のロール
- **必要な Resource Provider の事前登録**（下記を参照）

> **注記**
>
> 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` 状態になったことを確認してからデプロイを開始してください。

## 手順

### 1. Azure Marketplace で AGENTIC STAR を検索

[Azure Marketplace](https://azuremarketplace.microsoft.com/) で「AGENTIC STAR」を検索してオファーを開き、プラン「AGENTIC STAR Basic」（以前のプラン名は AGENTIC STAR Standard）を選択して **\[作成]** をクリックします。

![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 / ไทย |

### 4. PostgreSQL Settings（データベース設定）

| 項目                               | 説明                | デフォルト値             | 制約                                |
| -------------------------------- | ----------------- | ------------------ | --------------------------------- |
| **PostgreSQL Server Name**       | サーバーの名前（グローバルで一意） | `agtstr-pg`        | 3〜63文字、小文字英字で開始                   |
| **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 ノードプールの詳細設定が表示されます。ほとんどの場合、デフォルト設定のままで問題ありません。

> **注意**
>
> VM サイズを推奨値より小さくすると、リソース不足が発生する可能性があります。

**System Pool（システムノードプール）**

| 項目                  | デフォルト値             | 範囲    |
| ------------------- | ------------------ | ----- |
| Node Count          | 1                  | 1〜20  |
| Min Count（オートスケーラー） | 1                  | 1〜20  |
| Max Count（オートスケーラー） | 8                  | 1〜100 |
| VM Size             | Standard\_D8ds\_v4 | —     |

**User Pool（ユーザーノードプール）**

| 項目                  | デフォルト値             | 範囲    |
| ------------------- | ------------------ | ----- |
| Node Count          | 1                  | 1〜50  |
| Min Count（オートスケーラー） | 1                  | 1〜50  |
| Max Count（オートスケーラー） | 10                 | 1〜100 |
| VM Size             | Standard\_D8ds\_v4 | —     |

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

## デプロイ完了後

### アクセス用 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/basic/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/basic/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/basic/build/guide/settings-guide.md)を参照してください。

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