シングルノード Kubernetes 展開

1. 適用シナリオ

K8s 単一ノード展開:
- 軽量の小規模チーム、200人未満の小規模使用、 PoCデモ、機能検証、短期テストに適しています。
サーバーは1台のみで十分であり、そのサーバーがインストールノード、 K8s マスターノード、およびビジネスワーカーノードとして同時に機能します。
注意
- 公式のローンチ、長期運用、またはその後の高可用性スケーリングのためには、使用することを推奨します K8s クラスタの展開。

2. 展開プロセスの概要

ステップ	何をするか	完了インジケーター
1. システム環境を確認する	サーバーのリソース、ディスク、ネットワーク、時刻同期、および基本的なコマンドを確認する	サーバーは展開要件を満たしています
2. インストール資料を準備する	インストーラーおよび製品インストールパッケージを取得する。オフライン環境の場合は、オフラインイメージパッケージの準備も必要です	ファイル名が CPU アーキテクチャと一致していること
3. インストール素材のアップロード	インストーラーおよびインストールパッケージをデプロイノードにアップロードする	ファイルはサーバー上の指定ディレクトリに配置されています
4. インストーラーの起動	ウェブページを起動する `mdp-installer` ウェブページ	インストーラーページはブラウザからアクセス可能です
5. ウェブページインストール	配布パッケージを選択し、ノードを構成し、環境チェックを完了し、デプロイメントを開始します	すべてのインストールタスクが成功しました
6. インストール後の受け入れ	クラスター、サービス、ログイン、ライセンス、ビジネス機能を確認します	コア機能は通常通り使用可能です

3. デプロイメント前の準備

3.1 サーバー情報の準備

情報	例	説明
INSTALL_NODE_IP	`<INSTALL_NODE_IP>`	シングルノード K8s デプロイメントでは1台のサーバーのみを使用します
CPU アーキテクチャ	`amd64` / `arm64`	インストーラーとインストールパッケージはサーバーのアーキテクチャと一致する必要があります
ネットワーク環境	オンライン / オフライン	パブリックネットワークにアクセス可能な場合はオンラインを選択し、内部または隔離された環境ではオフラインを選択します
実行ユーザー	`root` または権限を持つユーザー `sudo` 権限	インストーラーはデプロイメントタスクを実行する必要があります SSH
SSH ポート	`22`	もし SSH ポートが変更されました。実際のポートを入力してください。
アクセスプロトコル	HTTP / HTTPS	HTTP テスト環境で使用できます。 HTTPS 本番または外部アクセスには推奨されます。
ACCESS_DOMAIN	`<ACCESS_DOMAIN>` または `<INSTALL_NODE_IP>`	ユーザーがアクセスするためのエントリーアドレス ShimoDocs Suite
データディレクトリ	`/data`	データディスクを別にマウントすることを推奨します。

3.2 インストール材料の準備

材料	例ファイル名	説明
インストーラー	`mdp-installer-amd64`	例: `amd64` アーキテクチャ向け。その他のアーキテクチャの場合は実際のファイル名に置き換えてください。
製品インストールパッケージ	`co1.8.20260807.3639-drive-release..tar.gz`	シングルノード用 K8s 展開の場合、ファイル名に含まれない配布パッケージを選択してください。 `k3s`ファイル名は実際の配送に従います。
ベースオフラインイメージパッケージ	`smbase_image-amd64.tar.gz`	オフラインインストール時のみ必要です
製品オフラインイメージパッケージ	`offline_app_image.tar.gz`	オフラインインストール時のみ必要で、製品インストールパッケージのバージョンと一致する必要があります。

注意:

コマンド内のファイル名は、実際のファイル名に置き換える必要があります。例: mdp-installer-amd64, co1.8.<VERSION>-drive-release.tar.gz.
製品インストールパッケージ、オフラインイメージパッケージ、およびサーバー CPU アーキテクチャは一致する必要があります。
オフラインインストール前に、ベースオフラインイメージパッケージと製品オフラインイメージパッケージをまとめて準備すると、展開中に一時的にパッケージを追加する必要がなくなります。

3.3 サーバーリソースの確認

項目	推奨要件
サーバー数	1
CPU	16コア以上
メモリ	32 GB以上
システムディスク	ルート `/` パーティション100 GB以上
データディスク	独立してマウントされている `/data`、利用可能な空き容量300 GB以上
オフラインインストール	イメージパッケージおよび一時抽出ファイル用にデータディスクにさらに100 GB以上を確保することを推奨します。

サーバーで実行:

lscpu
free -g
df -h
timedatectl status

次の結果を確認してください:

CPU、メモリ、ディスクが展開仕様を満たしていること。
/data は別のデータディスクにマウントされました。
システム時間の同期は正常です。
サーバーにアクセス可能 SSH ログイン。
オンラインインストール環境はパブリックネットワークにアクセスできます。オフラインインストール環境にはオフラインイメージパッケージが用意されています。

3.4 ポートの確認

ポート	目的
`22/TCP`	SSH ログインおよびインストールタスクの実行
`18080/TCP`	インストーラーWebページ
`80/TCP` または `443/TCP`	ShimoDocs Suite アクセス入口

サーバーにファイアウォールまたはセキュリティグループが有効な場合は、事前に上記ポートを開放してください。

4. インストールツールとパッケージのアップロード

以下の例では amd64 アーキテクチャを使用しています。他のアーキテクチャの場合は、実際のファイル名に置き換えてください。

4.1 インストーラーのアップロード

ローカルコンピュータで実行:

scp mdp-installer-amd64 root@<INSTALL_NODE_IP>:/root/

4.2 オフラインイメージパッケージのアップロード

このステップはオンラインインストールの場合はスキップできます。

オフラインインストールの場合、オフラインイメージパッケージをデプロイノードにアップロードする必要があります:

scp smbase_image-amd64.tar.gz offline_app_image.tar.gz root@<INSTALL_NODE_IP>:/root/

4.3 サーバーへのログイン

ssh root@<INSTALL_NODE_IP>

4.4 インストーラーへの実行権限の付与

chmod +x /root/mdp-installer-amd64

4.5 インストーラーWebページの起動

サーバーで実行:

cd /root
./mdp-installer-amd64 server

インストーラーをバックグラウンドで実行したい場合は、次を使用できます:

nohup /root/mdp-installer-amd64 server > /root/mdp-installer.log 2>&1 &

ブラウザアクセス:

http://<INSTALL_NODE_IP>:18080

5. Webページによるインストール

5.1 配布パッケージの選択

インストーラーWebページに入った後、今回展開する製品の配布パッケージを選択します。

以下のために K8s 単一ノード展開の場合は、ファイル名に k3sを含まない配布パッケージを選択してください。例えば:

co1.8.20260807.3639-drive-release.tar.gz

5.2 設定 SSH 接続

インストーラーはデプロイノードにログインします SSH インストールタスクを実行します。 SSH 設定は2つの認証方法をサポートしています：

秘密鍵認証。
PASSWORD 認証。

次の使用を推奨します。 root ユーザーまたは権限を持つユーザー sudo でデプロイを実行します。情報を入力した後、最初に接続をテストして、インストーラーが正常にデプロイノードにログインできることを確認できます。

5.3 基本設定の確認

配布パッケージを選択した後、次のステップに進みます。特別な要件がなければ、ページのデフォルト設定を保持できます。もしデプロイ環境に既にドメイン名、証明書、ネットワークセグメント、またはミドルウェアに関する明確な計画がある場合は、実際の計画に従って記入してください。

設定時に確認すべき要点：

アクセスプロトコルと ACCESS_DOMAIN が正しく入力されていることを確認してください。
ポッド CIDR およびサービス CIDR は既存のネットワーク、オフィスネットワーク、 VPN、または IDC ネットワークセグメント。
データディレクトリには、実際に予定されているデータディスクのディレクトリを使用してください。 /data データディレクトリには、実際に予定されているデータディスクのディレクトリを使用してください。
オンライン/オフラインのインストール方法は、現在のネットワーク環境と一致させてください。

5.4 初期展開

設定が完了したら、初期展開をクリックしてください。ページにはこの展開の概要が表示されます。以下の点を重点的に確認してください：

製品パッケージのバージョン。
展開 NODE_IP。
SSH ユーザーとポート。
ACCESS_DOMAIN およびプロトコル。
データディレクトリ。
オンラインまたはオフラインのインストールモード。
ミドルウェアの選択。

すべてが正しいことを確認した後、続行してください。

5.5 システム環境の確認

インストーラーはサーバー環境を自動的にチェックします。

チェックを通過した後にデプロイメントを続行します。項目に不備がある場合は、ページの指示に従って対応し、再チェックしてください。一般的な対応方法には以下が含まれます：

ディスク容量不足：スペースを確保するか、データディスクを拡張してください。
ポートが使用不可：ポートを解放するか、ポート使用を調整してください。
SSH 接続に失敗しました：アカウント、 PASSWORD、秘密鍵、ポート、およびセキュリティグループ。
時刻同期異常：設定 NTP またはサーバ時刻を校正してください。
基本コマンドが不足している：システムのディストリビューションに従って不足しているコマンドをインストールしてください。

5.6 デプロイメント開始

環境チェックが通過したら、クリックしてデプロイメントを開始します。

デプロイメントの実行中、各コンポーネントの実行ログを確認できます。インストール中は以下を確認してください：

インストーラプロセスが実行中であること。
ブラウザがインストールノードのネットワークに接続できること。
サーバを再起動しないこと。
インストールパッケージ、オフラインイメージパッケージ、またはデータディレクトリを移動または削除しないこと。

5.7 インストール完了まで待機

インストールプロセスには時間がかかります。具体的な時間はサーバの性能、ネットワーク環境、イメージダウンロード速度によります。

ページにすべてのタスクが正常に実行され、失敗したコンポーネントがないと表示された場合、デプロイメントが完了したことを示します。

5.8 インストール結果の確認

インストール完了後、インストーラーはデプロイメント完了ページとアクセス情報を表示します。ビジネスシステムおよび MDP 操作プラットフォーム。

ビジネスアドレスにアクセス：

http://<ACCESS_DOMAIN>/

もし HTTPS インストール中に設定した場合、次にアクセスしてください：

https://<ACCESS_DOMAIN>/

デフォルトアカウントまたは管理者アカウントでログインした後、初期の PASSWORD 設定をすぐに変更してください。

アクセス MDP オペレーションプラットフォームにアクセスする前に、ページ上に失敗したタスクがないことを確認してください。

http://<ACCESS_DOMAIN>/mdp/

管理者を変更する必要がある場合は、展開ノードで次のコマンドを実行して、管理者パスワードを変更またはリセットできます。 MDP 管理者 PASSWORD次のコマンドを実行して修正またはリセット可能です PASSWORD. {password} を新しい複雑で強力なパスワードに置き換えてください PASSWORD 実際のセキュリティ要件に従ってください。

kubectl exec -it $(kubectl get pods -l app=mdp -o jsonpath='{.items[0].metadata.name}') -- reset-admin-password {password}

6. インストール後の受け入れ検査

6.1 確認 K8s ノードステータス

展開ノードで実行してください:

kubectl get node

ノードのステータスは次の状態である必要があります Ready.

サービスの確認を続けます:

kubectl get pod -A

通常の状態は次の通りです:

Running: サービスが稼働中です。
Completed: タスクの実行が完了しました。

次のような状態が発生した場合 CrashLoopBackOff, ImagePullBackOff, Error, Pending対応するPodのログを最初に確認して対処してください。

6.2 アクセス入口の確認

アクセス ShimoDocs Suite ブラウザ経由のエントリ:

http://<ACCESS_DOMAIN>/

もし HTTPS が設定されている場合、次にアクセスしてください:

https://<ACCESS_DOMAIN>/

ログインページが正常に開けることを確認してください。

6.3 管理バックエンドとライセンスの確認

以下の項目を確認してください：

管理者バックエンドにアクセスできること。
管理者がログインできること。
ライセンスページが開けること。
マシン情報を表示できます。
ライセンスは認証プロセスに従って申請または更新できます。

6.4 ビジネス機能の確認

テストアカウントまたは管理者が作成したアカウントでログインした後、少なくとも次を確認してください：

ドキュメント、スプレッドシート、スライドを作成できること。
ドキュメントを編集して保存でき、リフレッシュ後も内容が残っていること。
複数ユーザーによる共同編集が可能であること。
ファイルのインポートとエクスポートが正常であること。
検索、チームスペース、連絡先リストなどのコア機能が使用可能であること。

初めてデフォルトのテストアカウントでログインした後、次を変更してください。 PASSWORD 設定をすぐに変更してください。アカウント PASSWORD は展開納品アカウントです。 PASSWORD!

ACCOUNT:[email protected]
PASSWORD:xxxxx

6.5 インストーラーのプロセスを停止する

展開が完了し、受け入れが通過した後、インストーラーのWebサービスを停止できます：インストールWebページを停止する: インストーラーを停止するコマンド:

ps -ef | grep mdp-installer | grep -v grep
kill <PID>

インストーラーがバックグラウンドで起動されている場合 nohup、ログを確認することもできます:

tail -f /root/nohup.out

7. よくあるトラブルシューティング

7.1 ブラウザがインストーラーページを開けない

次の点を確認してください:

インストーラープロセスがまだ実行中かどうか。
ポート 18080 がファイアウォールまたはセキュリティグループによってブロックされているかどうか。
ブラウザからアクセスされているIPが INSTALL_NODE_IP。

サーバー上で次の操作を実行できます：

ps -ef | grep mdp-installer | grep -v grep
ss -lntp | grep 18080

7.2 環境チェックに失敗

ページの指示に従って各項目を対応してください。対応後、インストーラーページに戻り、環境チェックを再実行します。

優先チェック:

かどうか CPU、メモリ、およびディスクが要件を満たしています。
かどうか /data は独立したデータディスクです。
サーバー時間が同期されているかどうか。
かどうか SSH ユーザーはデプロイ権限を持っています。

7.3 オフラインインストールイメージの取得に失敗

確認手順:

オフラインイメージパッケージがデプロイノードにアップロードされているか。
ベースオフラインイメージパッケージおよび製品オフラインイメージパッケージが完全かどうか。
イメージパッケージのバージョンが製品インストールパッケージと一致しているか。
プライベートイメージリポジトリのアドレス、アカウント、ならびに PASSWORD が正しく入力されていること。

7.4 Podが長時間異常状態のままになる

まず、異常な Pod を確認します:

kubectl get pod -A

ログを再確認します:

kubectl logs -n <namespace> <pod-name>

ログに基づいて、イメージ、構成、リソース、または依存関係の問題を対処します。

8. インストール後の資材保持

展開後、次回の保守、アップグレード、トラブルシューティングを容易にするため、以下の資料を保管することを推奨します:

INSTALL_NODE_IP、 ACCESS_DOMAINおよびアクセスプロトコル。
インストーラーのファイル名とバージョン。
製品インストールパッケージのファイル名とバージョン。
オフラインイメージパッケージのファイル名とバージョン。
ウェブページの主要構成スクリーンショット。
kubectl get node チェック結果。
kubectl get pod -A チェック結果。
ライセンス認証記録。
業務機能受け入れ記録。
導入中に発生した問題とその対応結果。