WindowsでのZabbix agent 2のビルド
概要
このページでは、Windows 10(64ビットまたは32ビット)でソースから Zabbix エージェント 2 をビルドする方法を説明します。
64ビットプラットフォームでは32ビット版と64ビット版の両方をビルドできますが、32ビットプラットフォームでは32ビット版のみビルドできます。
Zabbix エージェント 2 のビルドには、以下が必要です。
- MinGW ビルドツール
- Go プログラミング言語
- OpenSSL(Zabbix の暗号化機能用)
- PCRE2(Perl 互換正規表現。Zabbix の正規表現パターンマッチング機能用)
以下のいずれかの方法で Zabbix エージェント 2 をビルドできます。
- vcpkg を使用する - C++ パッケージマネージャーを使用して依存関係の管理を簡素化する自動化された方法です。
- 手動ビルド - エージェントをコンパイルする前に、すべての依存関係をインストールする必要がある手動の方法です。
ビルドプロセスを開始する前に、以下の点に注意してください。
vcpkgを使用したZabbixエージェント2のビルド
このセクションでは、依存関係の管理とC++プロジェクトとの統合を簡素化するパッケージマネージャーであるvcpkgを使用して、Zabbixエージェントをビルドする手順を説明します。
1. Build Tools for Visual Studio 2022をダウンロードしてインストールします。 インストール中に、vcpkgパッケージマネージャーを含むDesktop development with C++ワークロードを必ず選択してください。
2. Go(MSIインストーラーとして提供)をダウンロードしてインストールします。
インストール中に、インストール先としてC:\Zabbix\Goを必ず指定してください。
3. Microsoft Visual Cランタイムライブラリを使用するMinGWディストリビューションをダウンロードします。例:
- 64ビットビルドの場合:
x86_64-15.1.0-release-win32-seh-msvcrt-rt_v12-rev0.7z - 32ビットビルドの場合:
i686-15.1.0-release-win32-dwarf-msvcrt-rt_v12-rev0.7z
MinGWのバージョンは、最小要件を満たしている必要があります。
次に、C:\Zabbix\mingw64(32ビットビルドの場合はC:\Zabbix\mingw32)に展開します。
4. vcpkgを初期化し、Zabbixエージェント2のビルドに必要な依存関係をインストールします(完了までに時間がかかる場合があります)。
cd C:\Zabbix
set PATH=%PATH%;"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\vcpkg"
vcpkg new --application
vcpkg add port pcre2
vcpkg add port libiconv
vcpkg add port openssl
# 64ビットビルドの場合:
set PATH=C:\Zabbix\mingw64\bin;%PATH%
vcpkg install --triplet x64-mingw-static --x-install-root=x64
# 32ビットビルドの場合:
set PATH=C:\Zabbix\mingw32\bin;%PATH%
vcpkg install --triplet x86-mingw-static --x-install-root=x86
5. Zabbixソースアーカイブをダウンロードし、C:\Zabbix\zabbix-8.0.0に展開します。
6. Zabbixのビルドディレクトリ(C:\Zabbix\zabbix-8.0.0\build\mingw)に移動し、次のbuild.batスクリプトを作成します。
- 64ビットビルドの場合:
:: 現在のセッションのシステム`PATH`変数にMinGWとGoを追加します:
set PATH=C:\Zabbix\mingw64\bin;%PATH%
set PATH=C:\Zabbix\Go\bin;%PATH%
:: vcpkgのインストールパスを設定します:
set vcpkg="C:\Zabbix\x64\x64-mingw-static"
:: Crypt32ライブラリのリンカーフラグを設定します:
SET CGO_LDFLAGS="-lCrypt32"
:: ビルドプロセスを実行します:
mingw32-make GOFLAGS="-buildvcs=false" ARCH=AMD64 ^
PCRE2="%vcpkg%" ^
OPENSSL="%vcpkg%" ^
all
- 32ビットビルドの場合:
:: 現在のセッションのシステム`PATH`変数にMinGWとGoを追加します:
set PATH=C:\Zabbix\mingw32\bin;%PATH%
set PATH=C:\Zabbix\Go\bin;%PATH%
:: vcpkgのインストールパスを設定します:
set vcpkg="C:\Zabbix\x86\x86-mingw-static"
:: Crypt32ライブラリのリンカーフラグを設定します:
SET CGO_LDFLAGS="-lCrypt32"
:: ビルドプロセスを実行します:
mingw32-make GOFLAGS="-buildvcs=false" ARCH=x86 ^
PCRE2="%vcpkg%" ^
OPENSSL="%vcpkg%" ^
all
7. スクリプトを実行してZabbixエージェント2をコンパイルします。
build.bat
コンパイル後、Zabbixエージェント2のバイナリは、C:\Zabbix\zabbix-8.0.0\bin\win64(64ビットビルドの場合)またはC:\Zabbix\zabbix-8.0.0\bin\win32(32ビットビルドの場合)に配置されます。
Zabbixエージェント2の設定ファイルは、C:\Zabbix\zabbix-8.0.0\src\go\confに配置されます。
エージェントを実行するには、zabbix_agent2.exeとその設定ファイルを専用フォルダー(例:C:\Zabbix\agent2)にコピーしてから、エージェントを実行します。
mkdir C:\Zabbix\agent2
# 64ビットビルドの場合:
copy C:\Zabbix\zabbix-8.0.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\
# 32ビットビルドの場合:
copy C:\Zabbix\zabbix-8.0.0\bin\win32\zabbix_agent2.exe C:\Zabbix\agent2\
copy C:\Zabbix\zabbix-8.0.0\src\go\conf\zabbix_agent2.conf C:\Zabbix\agent2\
xcopy /E /I C:\Zabbix\zabbix-8.0.0\src\go\conf\zabbix_agent2.d C:\Zabbix\agent2\zabbix_agent2.d\
C:\Zabbix\agent2\zabbix_agent2.exe -c C:\Zabbix\agent2\zabbix_agent2.conf
必要に応じて、Zabbixエージェント2のロード可能なプラグインのコンパイルに進んでください。
Zabbix エージェント 2 のロード可能なプラグインのコンパイル
1. ご利用の Zabbix エージェント 2 のバージョンに一致する Zabbix plugin source をダウンロードし、C:\Zabbix に展開します。
プラグインをインストールする前に、README ファイルを確認してください。 そこには、特定の要件やインストール手順が記載されている場合があります。
2. 展開したプラグインディレクトリに移動し、プラグインをコンパイルします:
cd C:\Zabbix\zabbix-agent2-plugin-ember-plus-8.0.0
# 64 ビットビルドの場合:
mingw32-make ARCH=AMD64
# 32 ビットビルドの場合:
mingw32-make ARCH=x86
コンパイル後、Zabbix エージェント 2 のプラグインバイナリとその設定ファイルは、同じプラグインディレクトリに配置されます。
プラグインの実行ファイルは、Zabbix エージェント 2 から読み込める限り、任意の場所に配置できます。 たとえば PostgreSQL プラグインの場合は、プラグイン設定ファイル内でプラグインバイナリへのパスを指定します。
Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql
プラグイン設定ファイルへのパスは、Zabbix エージェント 2 の設定ファイルの Include パラメータで指定する必要があります。
Include=/path/to/plugin/configuration/file/postgresql.conf
プラグインの設定方法の詳細については、セットアップ を参照してください。
Zabbixエージェント 2を手動でビルドする
このZabbixエージェント 2のビルド方法は、ビルド環境を完全に制御する必要があるユーザー、または vcpkgの使用ができない制限された環境にいるユーザーに適しています。
このセクションでは、必要なビルドツールと依存関係をインストールしてからエージェントをコンパイルする、Zabbixエージェント 2の手動ビルド手順について説明します。
ビルドツールのセットアップ
1. MSYS2 をダウンロードしてインストールします(MSIインストーラーを利用できます)。
インストール中に、インストール先として C:\Zabbix\msys64 を指定してください。
2. Go をダウンロードしてインストールします(MSIインストーラーを利用できます。現在サポートされている Goのバージョンを参照してください)。
インストール中に、インストール先として C:\Zabbix\Go を指定してください。
3. Microsoft Visual C ランタイムライブラリを使用する MinGWディストリビューションをダウンロードします。例:
- 64ビットビルドの場合:
x86_64-15.1.0-release-win32-seh-msvcrt-rt_v12-rev0.7z - 32ビットビルドの場合:
i686-15.1.0-release-win32-dwarf-msvcrt-rt_v12-rev0.7z
MinGWのバージョンは、最小要件を満たしている必要があります。
その後、C:\Zabbix\mingw64(32ビットビルドの場合は C:\Zabbix\mingw32)に展開します。
OpenSSL のインストール
TLS サポートなしで Zabbix エージェントをコンパイルするには、PCRE2 のインストールセクションに進んでください。
1. 管理者権限で MSYS2 MSYS ターミナルを開き、次のコマンドを実行します。
pacman -S perl-Locale-Maketext-Simple
pacman -S nasm
pacman -S make
pacman -S cmake
2. OpenSSL ソースアーカイブをダウンロードし、C:\Zabbix\openssl-3.5.0 に展開します。
3. 展開した OpenSSL ディレクトリに移動し、次の build.sh スクリプトを作成します。
- 64 ビットビルドの場合:
#!/usr/bin/env bash
export PATH="/c/Zabbix/mingw64/bin:$PATH"
export d="/c/Zabbix/x64/OpenSSL-Win64-350-static"
perl Configure mingw64 no-shared no-capieng no-winstore no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method thread_scheme=winthreads --api=1.1.0 --prefix=$d --openssldir=$d
make
make install
- 32 ビットビルドの場合:
#!/usr/bin/env bash
export PATH="/c/Zabbix/mingw32/bin:$PATH"
export d="/c/Zabbix/x86/OpenSSL-Win64-350-static"
perl Configure mingw no-shared no-capieng no-winstore no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method thread_scheme=winthreads --api=1.1.0 --prefix=$d --openssldir=$d
make
make install
管理者以外のユーザーから C:\Zabbix\x64\OpenSSL-Win64-350-static ディレクトリへの書き込みアクセスを必ず取り消してください。
そうしないと、エージェントは権限のないユーザーが変更できるパスから SSL 設定を読み込むことになり、セキュリティ上の脆弱性につながる可能性があります。
no-sharedオプションを指定すると、libcrypto.lib と libssl.lib の OpenSSL 静的ライブラリが自己完結型になるため、Zabbix バイナリに OpenSSL が含まれ、外部 DLL が不要になります。 これは、OpenSSL ライブラリなしで Zabbix バイナリを他の Windows マシンにコピーできることを意味します。ただし、新しい OpenSSL のバグ修正版がリリースされた場合は、Zabbix エージェントを再コンパイルする必要があります。no-sharedオプションを指定しない場合、Zabbix は実行時に OpenSSL DLL に依存します。 これは、OpenSSL の更新時に Zabbix エージェントの再コンパイルが不要になる可能性があることを意味します。ただし、他のマシンにコピーする場合は、OpenSSL DLL もコピーする必要があります。
その他の OpenSSL 設定オプションについては、OpenSSL ドキュメントを参照してください。
4. スクリプトを実行して OpenSSL を設定およびインストールします(完了までに時間がかかる場合があります)。
cd /c/Zabbix/openssl-3.5.0
./build.sh
PCRE2のインストール
1. PCRE2のソースアーカイブをダウンロードし、C:\Zabbix\pcre2-10.45に展開します。
2. 管理者権限でMSYS2 MSYSターミナルを開きます。
次に、展開したPCRE2ディレクトリ内にbuildディレクトリを作成し、そこに移動します:
mkdir /c/Zabbix/pcre2-10.45/build
cd /c/Zabbix/pcre2-10.45/build
3. PCRE2を構成します:
# 64ビットビルドの場合:
export PATH="/c/Zabbix/mingw64/bin:$PATH"
cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-O2 -g" -DCMAKE_INSTALL_PREFIX="/c/Zabbix/x64/PCRE2" ..
# 32ビットビルドの場合:
export PATH="/c/Zabbix/mingw32/bin:$PATH"
cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-m32 -O2 -g" -DCMAKE_EXE_LINKER_FLAGS="-Wl,-mi386pe" -DCMAKE_INSTALL_PREFIX="/c/Zabbix/x86/PCRE2" ..
エラーが発生した場合は、CMakeのビルドプロセスを繰り返す前にCMakeキャッシュを削除することを推奨します。
キャッシュ(CMakeCachecache.txt)は、展開したPCRE2ディレクトリのbuildディレクトリ内にあります。
4. PCRE2をインストールします:
make install
Zabbixエージェント 2 のコンパイル
1. Zabbixソースアーカイブをダウンロードし、C:\Zabbix\zabbix-8.0.0に展開します。
rawソースリポジトリからソースアーカイブを生成する必要がある場合(カスタムパッチを適用する場合や、最新のソースコードからビルドする場合など)は、GoがインストールされたLinuxマシン上で、次のコマンドを実行します(Zabbixエージェント 2 の設定に必要です)。
git clone https://git.zabbix.com/scm/zbx/zabbix.git
cd zabbix
./bootstrap.sh
./configure
make dist
これによりソースアーカイブが作成されます。作成したアーカイブはWindowsマシンにコピーできます。
2. 管理者権限でコマンドプロンプトを開きます。 次に、Zabbixのビルドディレクトリに移動してZabbixエージェントをコンパイルします。OpenSSLおよびPCRE2がインストールされているディレクトリを正しく指定してください。
- 64ビットビルドの場合:
cd C:\Zabbix\zabbix-8.0.0\build\mingw
set PATH=C:\Zabbix\mingw64\bin;%PATH%
mklink /D C:\Zabbix\x64\OpenSSL-Win64-350-static\lib C:\Zabbix\x64\OpenSSL-Win64-350-static\lib64
# TLSサポートあり:
mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2" OPENSSL="C:\Zabbix\x64\OpenSSL-Win64-350-static"
# TLSサポートなし:
mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2"
- 32ビットビルドの場合:
cd C:\Zabbix\zabbix-8.0.0\build\mingw
set PATH=C:\Zabbix\mingw32\bin;%PATH%
# TLSサポートあり:
mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2" OPENSSL="C:\Zabbix\x86\OpenSSL-Win32-350-static"
# TLSサポートなし:
mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2"
コンパイル後、Zabbixエージェント 2 のバイナリはC:\Zabbix\zabbix-8.0.0\bin\win64に配置されます(32ビットビルドの場合はC:\Zabbix\zabbix-8.0.0\bin\win32)。
Zabbixエージェント 2 の設定ファイルはC:\Zabbix\zabbix-8.0.0\src\go\confに配置されます。
エージェントを実行するには、zabbix_agent2.exeバイナリとその設定ファイルを専用フォルダー(例: C:\Zabbix\agent2)にコピーしてから、エージェントを実行します。
mkdir C:\Zabbix\agent2
copy C:\Zabbix\zabbix-8.0.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\
copy C:\Zabbix\zabbix-8.0.0\src\go\conf\zabbix_agent2.conf C:\Zabbix\agent2\
xcopy /E /I C:\Zabbix\zabbix-8.0.0\src\go\conf\zabbix_agent2.d C:\Zabbix\agent2\zabbix_agent2.d\
C:\Zabbix\agent2\zabbix_agent2.exe -c C:\Zabbix\agent2\zabbix_agent2.conf
必要に応じて、Zabbixエージェント 2 のロード可能プラグインのコンパイルに進みます。