> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/ja/platform-development/onprem-versioning-and-upgrades.md).
# バージョンとアップグレード
プライベートクラウドとオンプレミスの四半期リリース（2026.Qn）の番号体系、同一四半期内の更新と四半期をまたぐアップグレードの概要、想定停止時間、ロールバックの制約、およびオンプレミスの機能提供が SaaS より遅れる理由
プライベートクラウドとオンプレミスのデプロイでは、SaaS の継続的な更新に追随せず、四半期リリースを使用します。本ページは、運用スケジュールと変更管理を担当するお客様の IT 部門と SI パートナー向けです。バージョンの見方、アップグレードの準備、停止時間、および問題発生時に戻せる範囲を説明します。
{% hint style="info" %}
本ページは計画用の概要です。アップグレードの詳しい手順は、デプロイパッケージに付属するインストールマニュアルに記載されています。新バージョンの機能の違いと、アップグレード前後に調整が必要な設定は、MaiAgent が新バージョンとともに提供するリリースノートに記載されています。入手については MaiAgent の担当窓口にお問い合わせください。
{% endhint %}
## 四半期リリースとは
* **四半期単位のリリース系列**：オンプレミスのバージョンは、`2026.Q2`、`2026.Q3` のように四半期ごとの系列に分かれます。各系列は独立して保守され、同一四半期内でも更新が継続して公開されます。
* **バージョン番号**：四半期に公開日を加えた形式です。例：`2026.Q3-10.02`。
* **一組の提供バージョン**：各リリースにはバックエンド、管理画面、チャットページの 三つのバージョン番号が含まれます。MaiAgent が提供する同じ組み合わせを使用してください（例：バックエンドと管理画面は `2026.Q3-10.02`、チャットページは `2026.Q3-09.28`）。
* **デプロイパッケージ**：インストーラー自体にも別のバージョンがあり、アップグレード時に新しいデプロイパッケージへ置き換えます。
**現在保守中の四半期系列**：`2026.Q3`（最新）と `2026.Q2` は、どちらも引き続き更新を公開しています。`2026.Q1` の更新は終了しているため、保守中の系列へアップグレードしてください。新規デプロイではすべて最新の系列を使用します。特定の系列が保守中かどうかの確認や、最新バージョン番号の入手については、MaiAgent の担当窓口にお問い合わせください。
**現在インストールされているバージョンの確認方法**：デプロイ設定にあるバックエンド、管理画面、チャットページのバージョン欄が、そのホストのバージョンです。ホスト上で各サービスのコンテナが使用するイメージタグを直接確認することもできます（Docker：`docker compose ps`、Kubernetes：`kubectl get deploy -n maiagent -o wide`）。
## オンプレミスの機能提供時期
新機能はまず SaaS で公開され、その後の四半期リリースでオンプレミスに組み込まれます。そのため、同じ時点ではオンプレミスで利用できる機能が SaaS より少なくなります。例えば、次の違いがあります。
* Office オンライン編集（ファイルライブラリ）は現在 SaaS のみで提供されており、四半期リリースにはまだ含まれていません。
* AI Gateway と、ホスト内にデプロイした LocalAI によるオフライン音声認識は、`2026.Q3` から提供されます。`2026.Q2` では利用できません。
各四半期リリースで提供される機能は、リリースノートを参照してください。プライベートクラウドとオンプレミスの違いは、[デプロイ形態と機能の比較](/tech/ja/platform-development/onprem-deployment-types.md#feature-availability)を参照してください。
## 同一四半期内の更新と四半期をまたぐアップグレード
| | 同一四半期内の更新 | 四半期をまたぐアップグレード |
| ------ | --------------------------------- | --------------------------------------------------------------------------------------- |
| 例 | `2026.Q3-09.24` → `2026.Q3-09.30` | `2026.Q2` → `2026.Q3` |
| 手順 | 同じです | 同じです |
| 実測停止時間 | 約 10 分 | 約 20 分（データベーススキーマの更新は約 11 分） |
| 追加の注意点 | — | データベーススキーマの更新に時間がかかります。新バージョンで追加されたシステム設定には新バージョンのデフォルト値が適用されます。先にリリースノートの調整項目を確認してください |
* 実測環境のデータ量は非常に少ないものでした。データが多いほどデータベーススキーマの更新に時間がかかるため、停止時間には余裕を持たせ、事前にユーザーへ通知してください。
* **機能フラグは維持されます**：設定済みの機能フラグ（お客様が管理画面で変更したものを含みます）は、アップグレード時に変更されません。新バージョンで追加されたフラグと、「デプロイ設定確認表」で回答済みでも一度も適用されていない項目だけを設定します。
* **公式の組み込み Agent**：`2026.Q3-10.02` 以降へのアップグレード時に、そのホストで公式マーケットプレイスが未設定の場合は有効になります。無効のままにする場合は、アップグレード前に確認表で「いいえ」と回答してください。
* **オブジェクトストレージは既存のエンジンを使用します**：MinIO を使用していた環境は、アップグレード後も MinIO のままです。
* **MaiAgent 自体のサービスのみを更新します**（バックエンド、バックグラウンドワーカー、管理画面、チャットページ、および有効なローカルモデルサービスなどのオプションコンポーネント）。リバースプロキシ、検索エンジン、データベースなどのコンポーネントの設定変更は、アップグレード時には適用されません。必要な変更がある場合はリリースノートに記載されます。
## アップグレード手順の概要
{% stepper %}
{% step %}
### 現在のデプロイ設定を取得する
アップグレードではインストール時のデプロイ設定を引き継ぎ、バージョン番号のみを変更します。再設定は行いません。この設定にはモデルサービスのキーが含まれるため、社内規定に従って保管・受け渡しを行ってください。
{% endstep %}
{% step %}
### 作業開始前に新バージョンの資材を揃える
オフライン環境では、インターネットに接続できる作業用コンピューターで新しいデプロイパッケージとイメージをダウンロードし、ファイルごとに checksum を照合してください。オンライン環境ではホスト上で直接ダウンロードできます。プライベートクラウドでは、デプロイ設定のデプロイ種別が引き続きプライベートクラウドになっていることを確認してください。
{% endstep %}
{% step %}
### 新しいデプロイパッケージに置き換えて確認する
新しいデプロイパッケージをホストに配置し、**古いデプロイパッケージのディレクトリは残してください**。ロールバック時に必要です。インストール前チェックを実行し、バージョン番号と資材が正しいことを確認してください。
{% endstep %}
{% step %}
### アップグレードを実行する
アップグレードプログラムは次の順序で処理します。デプロイパッケージのバージョンとデプロイ種別を確認（プライベートクラウドまたはオンプレミス。不一致の場合は変更せず停止します）→ 自動バックアップ → バックエンドを新バージョンに置き換えてデータベーススキーマを更新 → バックグラウンドワーカー → 管理画面とチャットページ → すべてのサービスが新バージョンに置き換わったことを確認します。アップグレード前のバックアップには保持マークが付けられ、経過日数による削除の対象にはなりません。
{% endstep %}
{% step %}
### アップグレード後に確認する
各サービスのバージョン番号を確認し、機能受け入れテストを一度実施して、機能フラグの適用結果を確認してください。管理画面にログインして、既存のナレッジベースとファイルが残っていることも確認します。新バージョンの安定稼働を確認してから、アップグレード前のバックアップの保持マークを解除してください。
{% endstep %}
{% endstepper %}
## アップグレード前に確保するディスク容量
| 場所 | 必要な容量 |
| ---------------------- | --------------------------------------------------------------------- |
| インストール用アカウントのホームディレクトリ | 新しいデプロイパッケージの圧縮ファイルは約 7 GB、展開後は約 7.7 GB です。古いデプロイパッケージのディレクトリは残してください |
| デプロイディレクトリ | 新バージョンのイメージファイルは約 8 GB です |
| Docker データディレクトリ | 読み込み後の新バージョンのイメージは約 8 GB です。古いイメージはロールバック用に保持されます |
| バックアップディレクトリ | 完全バックアップ 一回分です |
## ロールバックの制約
* **完全なロールバックにはアップグレード前のバックアップが必要です**。アップグレード中にあるサービスのバージョン切り替えが失敗した場合、そのサービスだけが自動的に古いイメージへ戻ります。それ以前に更新されたサービスとデータベーススキーマは戻りません。システムが新旧混在の状態になるため、アップグレード前のバックアップを復元する必要があります。
* **アップグレード後に追加されたデータは失われます**：復元すると、データベース、アップロードされたファイル、サービス設定、Web サイトの証明書がすべてアップグレード前の状態に戻ります。
* **ロールバックの順序は逆にできません**：まずバックアップを復元し、その後で古いデプロイパッケージのディレクトリに戻してください。新しいデータベーススキーマと古いプログラムの組み合わせではログインできません。比較的新しいデプロイパッケージでは、処理開始前にこの状態を検出して停止します。
* **Kubernetes**：復元ではデータのみが戻り、サービスのイメージは古いバージョンに戻りません。旧バージョンへの切り戻しは MaiAgent にご相談ください。
* **Kubernetes クラスターのバージョン**：アップグレードで変更されるのは MaiAgent のバージョンのみで、クラスター自体のバージョンは変わりません。既存クラスターの 1.31 から 1.36 へのアップグレードは、現在サポートしていません。
実測結果（Docker 単一ホスト）：同一四半期内の更新後にロールバックした場合、復元に約 157 秒かかりました。完了後 10 秒以内にログインでき、バージョン、データベーススキーマ、既存データがすべてアップグレード前の状態に戻りました。
{% hint style="warning" %}
Docker 分散構成と Kubernetes 環境でアップグレードまたはロールバックを行う前に、MaiAgent の担当窓口とアップグレード計画を確認し、作業日時を調整してください。
{% endhint %}
## 2026.Q2 から 2026.Q3 へのアップグレード
* Q3 の機能フラグは、このアップグレードで初めて設定されます。デプロイ設定に確認表の回答があればその内容を適用し、なければデフォルト値を使用します（リリースノートに記載されます）。確認表に従って設定する場合は、アップグレード前に確認表からエクスポートしたアップグレード用設定に置き換えてください。
* Q2 の「作成できるアシスタント数を制限するか」という設定は、数値の上限に変わります。チェックされていたプランは最大 1 件、チェックされていなかったプランは無制限となり、Q2 の実際の動作と同じです。
## 関連ページ
* [デプロイ形態と機能の比較](/tech/ja/platform-development/onprem-deployment-types.md)
* [運用の要点：バックアップと復元](/tech/ja/platform-development/onprem-operations.md#backup-and-restore)
* [システム要件](/tech/ja/platform-development/system-requirements.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.maiagent.ai/tech/ja/platform-development/onprem-versioning-and-upgrades.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.