2 Budowanie Zabbix agent 2 w systemie Windows

Przegląd

Ta strona pokazuje, jak zbudować Zabbix agent 2 ze źródeł w systemie Windows 10 (64-bitowym lub 32-bitowym).

Zarówno wersję 32-bitową, jak i 64-bitową można zbudować na platformie 64-bitowej, ale na platformie 32-bitowej można zbudować tylko wersję 32-bitową.

Do zbudowania Zabbix agent 2 wymagane są:

• narzędzia kompilacyjne MinGW
• język programowania Go
• OpenSSL (dla funkcji szyfrowania w Zabbix)
• PCRE2 (Perl Compatible Regular Expressions; dla funkcji dopasowywania wzorców wyrażeń regularnych w Zabbix)

Zabbix agent 2 można zbudować jedną z następujących metod:

• Użycie vcpkg — zautomatyzowane podejście, które upraszcza zarządzanie zależnościami za pomocą menedżera pakietów C++.
• Ręczna kompilacja — ręczne podejście, które wymaga zainstalowania wszystkich zależności przed skompilowaniem agenta.

Budowanie Zabbix agent 2 z vcpkg

Ta sekcja zawiera instrukcje dotyczące budowania Zabbix agent z użyciem vcpkg, menedżera pakietów, który upraszcza zarządzanie zależnościami i integrację z projektami C++.

1. Pobierz i zainstaluj Build Tools for Visual Studio 2022. Podczas instalacji upewnij się, że wybrano obciążenie Desktop development with C++, które zawiera menedżer pakietów vcpkg.

2. Pobierz i zainstaluj Go (dostępny jako instalator MSI). Podczas instalacji upewnij się, że jako folder instalacyjny wskazano C:\Zabbix\Go.

3. Pobierz dystrybucję MinGW, która korzysta z biblioteki uruchomieniowej Microsoft Visual C; na przykład:

• Dla kompilacji 64-bitowych: x86_64-15.1.0-release-win32-seh-msvcrt-rt_v12-rev0.7z
• Dla kompilacji 32-bitowych: i686-15.1.0-release-win32-dwarf-msvcrt-rt_v12-rev0.7z

Następnie rozpakuj ją do C:\Zabbix\mingw64 (lub C:\Zabbix\mingw32 dla kompilacji 32-bitowych).

4. Zainicjuj vcpkg i zainstaluj zależności wymagane do budowania Zabbix agent 2 (zwróć uwagę, że może to potrwać):

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

# For 64-bit builds:
set PATH=C:\Zabbix\mingw64\bin;%PATH%
vcpkg install --triplet x64-mingw-static --x-install-root=x64

# For 32-bit builds:
set PATH=C:\Zabbix\mingw32\bin;%PATH%
vcpkg install --triplet x86-mingw-static --x-install-root=x86

5. Pobierz archiwum źródłowe Zabbix i rozpakuj je do C:\Zabbix\zabbix-7.4.0.

6. Przejdź do katalogu kompilacji Zabbix (C:\Zabbix\zabbix-7.4.0\build\mingw) i utwórz następujący skrypt build.bat:

• Dla kompilacji 64-bitowych:

:: Add MinGW and Go to the system `PATH` variable for the current session:
set PATH=C:\Zabbix\mingw64\bin;%PATH%
set PATH=C:\Zabbix\Go\bin;%PATH%

:: Set vcpkg installation path:
set vcpkg="C:\Zabbix\x64\x64-mingw-static"

:: Set linker flags for Crypt32 library:
SET CGO_LDFLAGS="-lCrypt32"

:: Run the build process:
mingw32-make GOFLAGS="-buildvcs=false" ARCH=AMD64 ^
    PCRE2="%vcpkg%" ^
    OPENSSL="%vcpkg%" ^
    all

• Dla kompilacji 32-bitowych:

:: Add MinGW and Go to the system `PATH` variable for the current session:
set PATH=C:\Zabbix\mingw32\bin;%PATH%
set PATH=C:\Zabbix\Go\bin;%PATH%

:: Set vcpkg installation path:
set vcpkg="C:\Zabbix\x86\x86-mingw-static"

:: Set linker flags for Crypt32 library:
SET CGO_LDFLAGS="-lCrypt32"

:: Run the build process:
mingw32-make GOFLAGS="-buildvcs=false" ARCH=x86 ^
    PCRE2="%vcpkg%" ^
    OPENSSL="%vcpkg%" ^
    all

7. Skompiluj Zabbix agent 2, uruchamiając skrypt:

build.bat

Po kompilacji plik binarny Zabbix agent 2 będzie znajdować się w C:\Zabbix\zabbix-7.4.0\bin\win64 (dla kompilacji 64-bitowych) lub C:\Zabbix\zabbix-7.4.0\bin\win32 (dla kompilacji 32-bitowych). Pliki konfiguracyjne Zabbix agent 2 znajdują się w C:\Zabbix\zabbix-7.4.0\src\go\conf.

Aby uruchomić agent, skopiuj zabbix_agent2.exe oraz jego pliki konfiguracyjne do dedykowanego folderu (np. C:\Zabbix\agent2), a następnie uruchom agent:

mkdir C:\Zabbix\agent2

# For 64-bit builds:
copy C:\Zabbix\zabbix-7.4.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\

# For 32-bit builds:
copy C:\Zabbix\zabbix-7.4.0\bin\win32\zabbix_agent2.exe C:\Zabbix\agent2\

copy C:\Zabbix\zabbix-7.4.0\src\go\conf\zabbix_agent2.win.conf C:\Zabbix\agent2\
xcopy /E /I C:\Zabbix\zabbix-7.4.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.win.conf

W razie potrzeby kontynuuj, kompilując ładowalne wtyczki dla Zabbix agent 2.

Kompilowanie ładowalnych wtyczek Zabbix agent 2

1. Pobierz źródła wtyczki Zabbix, które odpowiadają wersji Twojego Zabbix agent 2 (np. zabbix-agent2-plugin-postgresql-7.4.0.tar.gz), i rozpakuj je do C:\Zabbix.

2. Przejdź do rozpakowanego katalogu wtyczki i skompiluj wtyczkę:

cd C:\Zabbix\zabbix-agent2-plugin-ember-plus-7.4.0

# Dla kompilacji 64-bitowej:
mingw32-make ARCH=AMD64

# Dla kompilacji 32-bitowej:
mingw32-make ARCH=x86

Po kompilacji plik binarny wtyczki Zabbix agent 2 oraz jej plik konfiguracyjny będą znajdować się w tym samym katalogu wtyczki.

Plik wykonywalny wtyczki może znajdować się w dowolnym miejscu, o ile może być załadowany przez Zabbix agent 2. Określ ścieżkę do pliku binarnego wtyczki w pliku konfiguracyjnym wtyczki, np. w pliku postgresql.conf dla wtyczki PostgreSQL:

Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql

Ścieżka do pliku konfiguracyjnego wtyczki musi być podana w parametrze Include pliku konfiguracyjnego Zabbix agent 2:

Include=/path/to/plugin/configuration/file/postgresql.conf

Przejdź do sekcji konfiguracja, aby uzyskać więcej informacji na temat konfigurowania wtyczek.

Ręczne budowanie Zabbix agent 2

Ta sekcja zawiera instrukcje dotyczące ręcznego budowania Zabbix agent 2, obejmujące instalację wymaganych narzędzi i zależności kompilacyjnych, a następnie skompilowanie agenta.

Konfigurowanie narzędzi do budowania

1. Pobierz i zainstaluj MSYS2 (dostępny jako instalator MSI). Podczas instalacji upewnij się, że jako folder instalacyjny zostanie wskazany C:\Zabbix\msys64.

2. Pobierz i zainstaluj Go (dostępny jako instalator MSI; zobacz aktualnie obsługiwane wersje Go). Podczas instalacji upewnij się, że jako folder instalacyjny zostanie wskazany C:\Zabbix\Go.

3. Pobierz dystrybucję MinGW, która korzysta z biblioteki uruchomieniowej Microsoft Visual C; na przykład:

• Dla kompilacji 64-bitowych: x86_64-15.1.0-release-win32-seh-msvcrt-rt_v12-rev0.7z
• Dla kompilacji 32-bitowych: i686-15.1.0-release-win32-dwarf-msvcrt-rt_v12-rev0.7z

Następnie rozpakuj ją do C:\Zabbix\mingw64 (lub C:\Zabbix\mingw32 w przypadku kompilacji 32-bitowych).

Instalowanie OpenSSL

1. Otwórz terminal MSYS2 MSYS z uprawnieniami administratora i uruchom następujące polecenia:

pacman -S perl-Locale-Maketext-Simple
pacman -S nasm
pacman -S make
pacman -S cmake

2. Pobierz archiwum źródłowe OpenSSL i rozpakuj je do C:\Zabbix\openssl-3.5.0.

3. Przejdź do rozpakowanego katalogu OpenSSL i utwórz następujący skrypt build.sh:

• Dla kompilacji 64-bitowych:

#!/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

• Dla kompilacji 32-bitowych:

#!/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

• Opcja no-shared sprawia, że biblioteki statyczne OpenSSL libcrypto.lib i libssl.lib są samodzielne, dzięki czemu pliki binarne Zabbix zawierają OpenSSL bez potrzeby używania zewnętrznych plików DLL. Oznacza to, że pliki binarne Zabbix można skopiować na inne komputery z systemem Windows bez bibliotek OpenSSL; jednak po wydaniu nowej wersji poprawkowej OpenSSL agent Zabbix będzie trzeba ponownie skompilować.
• Bez opcji no-shared Zabbix w czasie działania korzysta z bibliotek DLL OpenSSL. Oznacza to, że aktualizacje OpenSSL mogą nie wymagać ponownej kompilacji agenta Zabbix; jednak podczas kopiowania go na inne komputery należy również skopiować biblioteki DLL OpenSSL.

Więcej informacji o innych opcjach konfiguracji OpenSSL można znaleźć w dokumentacji OpenSSL.

4. Skonfiguruj i zainstaluj OpenSSL, wykonując skrypt (zauważ, że może to potrwać pewien czas):

cd /c/Zabbix/openssl-3.5.0
./build.sh

Instalowanie PCRE2

1. Pobierz archiwum źródłowe PCRE2 i rozpakuj je do C:\Zabbix\pcre2-10.45.

2. Otwórz terminal MSYS2 MSYS z uprawnieniami administratora. Następnie utwórz katalog build w rozpakowanym katalogu PCRE2 i przejdź do niego:

mkdir /c/Zabbix/pcre2-10.45/build
cd /c/Zabbix/pcre2-10.45/build

3. Skonfiguruj PCRE2:

# Dla kompilacji 64-bitowej:
export PATH="/c/Zabbix/mingw64/bin:$PATH"
cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-O2 -g" -DCMAKE_INSTALL_PREFIX="/c/Zabbix/x64/PCRE2" ..

# Dla kompilacji 32-bitowej:
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" ..

4. Zainstaluj PCRE2:

make install

Kompilacja Zabbix agent 2

1. Pobierz archiwum źródłowe Zabbix i rozpakuj je do C:\Zabbix\zabbix-7.4.0.

Jeśli musisz wygenerować archiwum źródłowe z surowego repozytorium źródeł (np. aby zastosować własne poprawki lub zbudować z najnowszego kodu źródłowego), uruchom następujące polecenia na komputerze z systemem Linux i zainstalowanym Go (wymaganym do konfiguracji Zabbix agent 2):

git clone https://git.zabbix.com/scm/zbx/zabbix.git
cd zabbix
./bootstrap.sh
./configure --enable-agent2 --enable-ipv6 --prefix=`pwd`
make dist

Spowoduje to utworzenie archiwum źródłowego, które następnie można skopiować na komputer z systemem Windows.

2. Otwórz Wiersz polecenia z uprawnieniami administratora. Następnie przejdź do katalogu kompilacji Zabbix i skompiluj Zabbix agent; upewnij się, że poprawnie wskazujesz katalogi, w których zainstalowano OpenSSL i PCRE2:

• Dla kompilacji 64-bitowej:

cd C:\Zabbix\zabbix-7.4.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

# Z obsługą TLS:
mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2" OPENSSL="C:\Zabbix\x64\OpenSSL-Win64-350-static"

# Bez obsługi TLS:
mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2"

• Dla kompilacji 32-bitowej:

cd C:\Zabbix\zabbix-7.4.0\build\mingw
set PATH=C:\Zabbix\mingw32\bin;%PATH%

# Z obsługą TLS:
mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2" OPENSSL="C:\Zabbix\x86\OpenSSL-Win64-350-static"

# Bez obsługi TLS:
mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2"

Po kompilacji plik binarny Zabbix agent 2 będzie znajdować się w C:\Zabbix\zabbix-7.4.0\bin\win64 (lub w C:\Zabbix\zabbix-7.4.0\bin\win32 w przypadku kompilacji 32-bitowej). Pliki konfiguracyjne Zabbix agent 2 znajdują się w C:\Zabbix\zabbix-7.4.0\src\go\conf.

Aby uruchomić agent, skopiuj plik binarny zabbix_agent2.exe oraz jego pliki konfiguracyjne do dedykowanego folderu (np. C:\Zabbix\agent2), a następnie uruchom agenta:

mkdir C:\Zabbix\agent2
copy C:\Zabbix\zabbix-7.4.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\
copy C:\Zabbix\zabbix-7.4.0\src\go\conf\zabbix_agent2.win.conf C:\Zabbix\agent2\
xcopy /E /I C:\Zabbix\zabbix-7.4.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.win.conf

W razie potrzeby przejdź do kompilacji ładowalnych wtyczek Zabbix agent 2.