Zeus IoT オープンソースプロジェクトのインストールと使用ガイド

Zeus IoT は Zabbix をベースにした世界初のオープンソース IoT 分散収集プラットフォームで、数百万の IoT デバイスからデータを収集、分析、保存する機能を持っています。プロジェクトリンク: https://gitcode.com/gh_mirrors/ze/zeus-iot

1. プロジェクトのディレクトリ構造と説明

Zeus IoT のディレクトリ構造は次の通りです。

.
├── docker-compose.yml        # Docker Compose 設定ファイル
├── docs                      # ドキュメントディレクトリ
│   ├── centos                # CentOS 専用インストールスクリプト
│   └── ubuntu               # Ubuntu 専用インストールスクリプト
├── src                       # プロジェクトソースコードディレクトリ
│   ├── main                 # メインプログラムディレクトリ
│   │   ├── java             # Java コード
│   │   └── resources        # 設定ファイルやその他のリソース
│   └── test                 # テストコードディレクトリ
├── README.md                 # プロジェクト概要
└── pom.xml                   # Maven プロジェクト設定ファイル

src/main/java にはコアビジネスロジックが格納され、src/main/resources には設定ファイルやその他のリソースが含まれています。また、docker-compose.yml は Docker 容器化されたデプロイのために使用されます。

2. プロジェクトの起動方法

Zeus IoT の起動手順は以下の通りです。

• ローカル環境でのデプロイでは、Maven や Gradle を使用してプロジェクトをビルドし、メインクラスを実行することでサービスを起動できます。
• コンテナ環境では、Docker Compose を使用して docker-compose.yml ファイルからすべての必要なサービス（データベース、Web アプリケーション、および関連依存）を起動します。

起動コマンド例（プロジェクトがすでにビルド済みの場合）：

# ローカルでの起動 (Java)
java -jar path/to/zeus-iot.jar

# Docker Compose での起動
docker-compose up -d

環境要件を満たしていることを確認し、適切な環境変数や依存関係が正しく設定されているか確認してください。

3. 設定ファイルの紹介

Zeus IoT の主な設定ファイルは src/main/resources にあり、次のような重要なファイルが含まれます。

• application.properties: アプリケーションの基本設定（データベース接続、サーバーポート、ログレベルなど）。
• database.properties: データベース設定（ユーザー名、パスワード、URL、接続プールパラメータなど）。
• zabbix.properties: Zabbix 関連設定（Zabbix API URL、認証情報など）。
• camel.properties: Apache Camel 関連設定（ルート規則やプロトコル接続など）。

これらの設定ファイルは、異なるデプロイ環境に応じてカスタマイズ可能です。例えば、application.properties の server.port を変更して Web サーバーがリッスンするポート番号を指定したり、database.properties のデータベース接続情報を変更して自身のデータベースインスタンスに接続することができます。

実際に使用する際には、ハードウェアやソフトウェアの依存関係が満たされていることを確認し、公式ドキュメントに従って操作することをお勧めします。詳細はプロジェクトの公式ドキュメントまたはリポジトリ内の README.md ファイルをご覧ください。