> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agens.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 要件

> Agens セルフホスト版をインストールする前提条件です。

## 必要なツール

デプロイを実行する端末に、次のツールを用意してください。

* `kubectl`
* Helm 3
* Kubernetes クラスタへのアクセス権
* Agens の chart とコンテナイメージの registry へのアクセス権

## Kubernetes

本番環境では、最低限次を想定します。

* 動作する Kubernetes クラスタ
* Agens 用 namespace。通常は `agens`
* Ingress が利用できること
* embedded PostgreSQL、RustFS、Milvus を使う場合は PersistentVolume が利用できること
* Kubernetes Secret を作成できること

## 推奨スペック

クラスタサイズは、利用人数、登録するナレッジ量、ツール実行量によって調整してください。

| 用途       | vCPU |  Memory | 備考                                                 |
| -------- | ---: | ------: | -------------------------------------------------- |
| 検証 / PoC |  2-4 |  8-16GB | embedded PostgreSQL、RustFS、Redis、Milvus を同一クラスタで利用 |
| 小規模本番    |  4-8 | 16-32GB | web/server を複数 replica にし、永続ボリュームを利用               |
| 本番推奨     |   8+ |   32GB+ | DB、オブジェクトストレージ、ベクトルDBの専用化を推奨                       |

## コンポーネント別の初期 request

| Component   |      CPU |    Memory |
| ----------- | -------: | --------: |
| web         | 100m x 2 | 256Mi x 2 |
| server      | 100m x 2 | 256Mi x 2 |
| jobs worker | 250m x 1 | 512Mi x 1 |
| PostgreSQL  |    500m+ |    1-2Gi+ |
| Redis       |    100m+ |    256Mi+ |
| RustFS      |    250m+ |    512Mi+ |
| Milvus      | 1-2 vCPU |     4-8Gi |

## ストレージ目安

| 用途          |  初期容量 |
| ----------- | ----: |
| PostgreSQL  | 20Gi+ |
| RustFS / S3 | 20Gi+ |
| Milvus      | 20Gi+ |
| Redis       |  2Gi+ |

本番環境では、PostgreSQL とオブジェクトストレージは外部サービスまたは専用基盤に分離することを推奨します。ナレッジ登録量が多い場合は、Milvus の CPU / Memory / Storage を増やしてください。

## ドメイン

次の DNS レコードを用意します。

* アプリ用ホスト
* API 用ホスト
* ストレージ用ホスト

例:

```text theme={null}
app.example.com
api.example.com
storage.example.com
```

## 配布物

インストール前に、配布元から次を受け取ってください。

* Helm chart の参照先
* Helm chart のバージョン
* ベースの `values.yaml`
* コンテナ registry の認証情報
* ライセンスキー