hostcontroldダウンロードhostcontroldソースコードのダウンロード

hostcontrold

パワービルダー

1.0.0

ダウンロード

hostcontrold

ホストコントロールデーモン。 Pingリクエスト（ICMP）で他のホストを監視し、WOL（Wake on LAN）パケットでそれらの一部を制御するデーモン。

特徴

主な目的は、いくつかの中央Linuxホストによって1つの/複数のLinuxホスト（SMBサーバーなど）を制御することです。これは、必要でないサーバーを自動的にシャットダウンすることにより、電源を節約するためです。

hostcontroldが実行中の中央ホストは、To To Host（サーバー）だけでなく、このサーバーのクライアントを制御するだけでなく、監視します。構成されたクライアントホストの1つがPingによって検出された場合、マジックWOLパケットを使用して、セントラルコントローラーがサーバーホストを起動します。これにより、一部のクライアントが稼働している場合にのみサーバーを実行できます。すべてのクライアントがシャットダウンした場合、指定されたタイムアウト期間後にサーバーもシャットダウンします。

すべての機能：

コア：
- ICMP Pingリクエストを使用したクライアント/サーバーホストの監視。
- pingでできるすべてのホストは、クライアント（Windows、Linux、OSX）として機能することができます。
- サーバーはWOLによって開始され、SSHを介してシャットダウンします。
- Linuxサーバーホストのみがサポートされています。
システム統合：
- デーモンを構成する単一のJSONファイル。
- SystemD統合のために準備されたユニットファイル。
- 複数のクライアントへの依存関係を持つ複数のサーバーを制御します。
サーバーディレクトリ：
- 各サーバーの状態は、コントロールディレクトリ内の単純なファイルによって観察できます。
- サーバーは、コントロールダイレクトリにいくつかの簡単なファイルを作成することで、手動で制御することもできます。

クイックスタートガイド

インストール

Central Control Linuxホストのリポジトリをクローンします。
ビルド依存関係をインストールしてください：
```
 sudo apt install make cmake g++ pkg-config libtool
```

ビルドとインストール：

 cd hostcontrold && mkdir build && cd build
cmake ..
sudo make -j4 install

構成

構成ファイルは/etc/hostcontrold.confにあります。作成された構成ファイルなしでデーモンを起動すると、デフォルトのファイルが生成されます。サーバーごとに、より多くのサーバーブロックと任意のクライアントを追加できます。

クライアントホストを準備します

ホストをpingableにします。
- Linuxは既にICMPリクエストに応答する必要があります。
- Windowsでは、受信IPv4 ICMPエコーリクエストを許可するようにファイアウォールを構成する必要があります。

Pingを使用して、ICMP要求に対するホスト応答が次のかどうかをテストできます。

 ping 192.168.0.6

サーバーホストを準備します

WOLパケットからスタートアップを許可します。
- BIOS/UEFIを構成し、必要に応じてオペレーティングシステムを構成します。
- ネットワークカードにスタンバイパワーの供給があることを確認してください。
- WOLは、完全な電力損失後少なくとも1回はホストが起動された場合にのみ機能します。
セントラルコントロールホストがサーバーホストをシャットダウンできるようにします。
- コントロールホストは、パスワードを使用せずにサーバーホストにSSHできる必要があります。したがって、アプリケーションを実行するユーザーは、サーバーホストを接続するために正しいSSHキーが必要です。
- 使用済みのユーザーがサーバーホストで正しく構成されていることを確認します。
- ユーザーはSudoを呼び出すことができる必要があります。これは、シャットダウンコマンドを呼び出すために使用されます。

アプリケーションユーザーがSSHを介してログインするためにユーザーclang使用する必要があるサーバーホストを準備するために使用できるコマンドの例：

 ssh-keygen
ssh-copy-id [email protected]

ユーザーの入力なしで次のコマンドが機能した場合、すべてが問題ないかどうかをテストできます。

 ssh [email protected]

デーモンを始めます

SystemDに新しいデーモンを知らせ、システムスタートアップでAutoStartを有効にし、デーモンを開始します。

 sudo systemctl daemon-reload
sudo systemctl enable hostcontrold
sudo systemctl start hostcontrold

構成を変更した後、 sudo systemctl restart hostcontrold 。

デーモンの使用のログを表示するには：

 journalctl -e -u hostcontrold

使用 /コントロールダイレクトリー

インストールと起動後、デーモンは実行して、構成されたすべてのホストを絶えず監視します。構成されたControl-Directoryのon / offファイルによって視覚化されたサーバーホストの状態を確認できます。ディレクトリに簡単なファイルを作成することで、特定の動作を強制できます。

ファイル名	コンテンツ	特徴
`force_on`	空の	サーバーの電源をオンにします
`force_off`	空の	サーバーの電源を下げたままにします

発達

情報の構築方法については、 Quick start guideセクションのInstallation手順を参照してください。

コード自体は、C ++ 14コードを備えた純粋なCmakeプロジェクトとして編成されています。コードで作業するよりも優先されるIDEはCLIONです。

Docker

開発手順全体は、準備されたDockerコンテナでも実行できます。これらは主に、さまざまなディストリビューション/ツールチェーンのGitHubアクションワークフローを使用してコードを構築およびテストするために使用されますが、ローカル開発にも使用できます。 GCC付きのUbuntuはデフォルトで使用されます。

 # Build the docker image.
./development/1_create.sh

# Create docker container and run it with the correct mounted volumes.
./development/2_run.sh

# Connect into the container.
./development/3_connect.sh

# Now you are logged-in the docker container.

cd /tmp/hostcontrold/

# Now you are in the source directory where you can compile and run tests e.g.
mkdir build
cd build
cmake ..
make -j4

# Leave the container with the following command when you are finished developing/testing.
exit

# Remove all signs of the docker container.
./development/5_remove.sh

単体テスト

ユニットテストには、 googletestフレームワークが使用されます。これは、Dockerコンテナに自動的にインストールされます。ホストに直接インストールするには、提供されたスクリプトを使用できます。

 sudo development/install_gtest.sh

ユニットテストバイナリは、cmake Target hostcontrold_testによって作成されます。テストを実行するには、Binary hostcontrold/unittest/hostcontrold_test直接実行するか、 ctestフレームワークを使用するCmakeターゲットtestを作成します。

将来の機能

Control-Directoryのファイルごとにシャットダウンタイムアウトを拡張します。
ビルド依存関係のインストールを自動化します。たぶん、コナンまたはansibleを使用してください。
シャットダウンコマンドを実行したユーザーは、 sudo必要としない場合があります。これを設定してください。
たぶん、全体のシャットダウンコマンドを構成することを許可します。これにより、非Linuxサーバーを使用できます。また、いくつかの特別なシャットダウンハンドリングを実行できます。