アプリケーション管理
ゲートウェイは、PLCデータ収集に加えて複数の補助ツール（ダッシュボード、データフロー、モニタリングなど）を同時に運用できます。この画面では、それらツールの状態を一目で確認し、開始/停止/再起動、および新規アプリのデプロイまでを処理します。
この画面は host docker のコンテナを表示します（/var/run/docker.sock マウントを使用）。
plantpulse-edge 自身はself-exclude — リストに表示されず、start/stop/delete/
inspect/logs/stats/deploy のすべての操作が IllegalStateException で拒否されます（自身を停止または
削除できないようにするため）。
plantpulse-edge の再起動は SSH で systemctl restart plantpulse-edge.service
またはステータスバーの「再起動」ボタン（signal file 経由）で行います。
1. 画面を開く
メイン画面の**[アプリケーション]**カードをクリックするか、アドレスバーに直接 /ui/apps を入力します。
┌────────────────────────────────────────────────────────────┐
│ ⊙ 애플리케이션 — 엣지에 배포된 컨테이너 · 시작/중지/재시작 │
│ [↻ 새로고침] [+ 새 앱 배포] │
├────────────────────────────────────────────────────────────┤
│ ℹ 이 화면에서는 엣지에 설치된 애플리케이션의 현재 상태를 │
│ 한눈에 확인하고, 필요할 때 시작·중지·재시작 할 수 있습니다.│
├────────────────────────────────────────────────────────────┤
│ [앱 카드] [앱 카드] [앱 카드] │
│ [앱 카드] [앱 카드] ... │
└────────────────────────────────────────────────────────────┘
以前のバージョンの ← 戻る ボタンは削除されました — トップバーのアイコンまたはロゴをクリックして他の画面に移動します。
2. 上部アクション
| ボタン | 動作 |
|---|---|
↻ 更新（fa-sync） | apps.refresh() — 即座にカードを再描画 |
+ 新規アプリのデプロイ（fa-plus） | apps.openDeploy() — 新規コンテナ定義 + 登録モーダル（カスタムイメージ / ポートマッピング / 環境変数） |
画面右上の小さなグレーのラベル（#apps_status_label）に最終更新時刻が時々表示され、自動ポーリングが動作していることを知らせます。
3. カードの構造
各アプリは角丸カード（20px ラディウス + グレー枠線）で表示され、ホバー時に少し浮き上がります。
| カード項目 | 意味 |
|---|---|
| 左側の大きなアイコン（四角形、light blue 背景） | アプリ種類 — コンテナイメージに基づく |
| アプリ名 | ドッカーコンテナ名（例：pp-grafana、pp-node-red） |
| ステータスバッジ（丸いカプセル） | running（緑）/ exited dead restarting（赤）/ paused（オレンジ）/ created（グレー） |
| イメージ | mono フォント + グレーボックス。使用中のドッカーイメージ（例：grafana/grafana:10.3） |
| ポート | クリック → 新規ウィンドウでアプリ画面を自動オープン（例：3000 → http://게이트웨이:3000/） |
| 作成 | コンテナが作成された時刻 |
| リソース | CPU / メモリ（実行中のアプリのみ、docker stats 結果） |
| アクション領域（カード下部） | [開始] [停止] [再起動] [ログ] ボタン — 状態に応じて有効/無効 |
画面は10 秒ごとに自動更新 — バックエンド /apps/list 呼び出し後に再描画します。
よく見られる補助アプリ
| ツール | 役割 |
|---|---|
| Grafana | 時系列グラフ / 運用ダッシュボード |
| Node-RED | ノーコードデータフロー / 自動化 |
| HiveMQ (MQTT ブローカー) | メッセージ中継（Sparkplug B 発行元） |
| Cassandra | 時系列ストア |
| Portainer | ドッカーコンテナの視覚的管理ツール |
| Uptime Kuma | シンプルな可用性モニター（死活監視） |
| File Browser | Web ファイルマネージャー |
インストールされているアプリは環境ごとに異なります。どのアプリが表示されるかは、システム管理者が IIoT プラットフォームからリモートデプロイした結果です。
よく行う操作
補助アプリの画面を開く
カードのポート番号をクリックすると、そのアプリの画面が新しいウィンドウで開きます。
- 通常は
http://게이트웨이IP:포트/形式で自動接続 - アプリごとに独自のログインが必要な場合があります（例：Grafana、Portainer）
補助アプリの開始 / 停止 / 再起動
| 操作 | 方法 | 備考 |
|---|---|---|
| 開始 | カードの [開始] ボタン | 停止状態のときにのみ有効 |
| 停止 | カードの [停止] ボタン | 実行中 / 一時停止時にのみ有効 |
| 再起動 | [再起動] ボタン | 常に使用可能 |
確認ダイアログが一度表示されるので、誤ってクリックしても [キャンセル] できます。
補助アプリのログを表示
カードの**[ログ]**ボタン → 最後の 200 行を黒い画面に表示します。アプリが起動しない場合の原因特定 / システム管理者への引き渡しに使用してください。
更新
左上の [更新] ボタンをクリックして即座に更新できます（自動 10 秒更新とは別）。
ゲートウェイ自体の管理（ステータスバーのクイックアクション）
画面左下のステータスバーの 7 つのアイコンで、ゲートウェイ OS / アプリケーション自体を制御します — 全ページ共通です。
詳細な動作 / 所要時間 / 注意事項は、別ドキュメントステータスバーのクイックアクションにまとめられています。
| アイコン | 動作 | 備考 |
|---|---|---|
🎬（fa-projector）システム再起動 | OS 再起動 | 約 3〜5 分 — 全 PLC 収集が停止 |
🔁（fa-repeat-1-alt）アプリケーション再起動 | Tomcat / ゲートウェイ SW のみ再起動 | 1 分以内 |
🗑（fa-trash）一時ファイルのクリーンアップ | 一時 / キャッシュ整理 | ディスク不足時 |
⏱（fa-stopwatch）バックアップ | 設定 + DB バックアップ | バックアップ / 復元 |
📄（fa-file-alt）ログダウンロード | 診断ログ zip | 問題報告時に添付 |
🔌（fa-microchip）OS およびファームウェアアップグレード | ファームウェア更新 | 慎重に |
☁（fa-cloud-download）S/W アップグレード | ゲートウェイ SW 更新（product.kopens.io） | 右上のバッジ*アップグレード可能！*が表示されているときのみ有効 |
再起動 / アップグレード中はPLC 値の収集が一時停止されます。稼働時間外に実施することを推奨します。
ゲートウェイ自体のインストール
システム管理者向け — 新規環境に初めてインストールする場合。
通常のインストールはシステム管理者が事前に行っていますが、新規環境に初めてインストールする場合は、次の 1 ライナーコマンドで一括インストールできます。
bash < <(curl -s http://product.kopens.io/plantpulse-edge/install.sh)
内部的に JDK / Tomcat / Cassandra / ゲートウェイのすべてをインストールします。
詳細なビルド / デプロイ / 環境設定手順が必要な場合は、app.properties リファレンスと上級 — 開発者ノートを参照してください。
よくある質問
Q. アプリケーションが“停止”状態なのに開始できません
PC リソース不足（メモリ不足など）またはポート競合の可能性があります。
- メイン画面でメモリ / ディスクゲージを確認
- [設定] → [一時ファイルのクリーンアップ] を試す
- それでも解決しない場合は [ログ] ボタンでエラーメッセージを確認し、システム管理者に引き渡す
Q. ゲートウェイを再起動すると PLC 接続 / タグは消えますか?
いいえ。設定は安全に保存されており、再起動後に自動で復元され、「自動開始」に設定した PLC は自動的に収集を再開します。
Q. 補助アプリはゲートウェイと分離して別の PC に配置できますか?
可能ですが、推奨構成は同じ PC です。システム管理者と相談してください。