Debian
Wazuh provides an automated way of building DEB packages using docker so there is no need for any other dependency.
To create an Debian package follow these steps:
Requirements
Docker
Git
Download our wazuh-packages repository from GitHub and go to the debs directory.
$ git clone https://github.com/wazuh/wazuh-packages && cd wazuh-packages/debs && git checkout v4.7.5
Execute the generate_debian_package.sh
script, with the different options you desire. This script will build a Docker image with all the necessary tools to create the DEB and run a container that will build it:
# ./generate_debian_package.sh -h
Usage: ./generate_debian_package.sh [OPTIONS]
-b, --branch <branch> [Required] Select Git branch.
--packages-branch <branch> [Required] Select Git branch or tag from wazuh-packages repository.
-t, --target <target> [Required] Target package to build: manager or agent.
-a, --architecture <arch> [Optional] Target architecture of the package [amd64/i386/ppc64le/arm64/armhf].
-j, --jobs <number> [Optional] Change number of parallel jobs when compiling the manager or agent. By default: 2.
-r, --revision <rev> [Optional] Package revision. By default: 1.
-s, --store <path> [Optional] Set the destination path of package. By default, an output folder will be created.
-p, --path <path> [Optional] Installation path for the package. By default: /var/ossec.
-d, --debug [Optional] Build the binaries with debug symbols. By default: no.
-c, --checksum <path> [Optional] Generate checksum on the desired path (by default, if no path is specified it will be generated on the same directory than the package).
--dont-build-docker [Optional] Locally built docker image will be used instead of generating a new one.
--sources <path> [Optional] Absolute path containing Wazuh source code. This option will use local source code instead of downloading it from GitHub.
--dev [Optional] Use the SPECS files stored in the host instead of downloading them from GitHub.
--future [Optional] Build test future package x.30.0 Used for development purposes.
-h, --help Show this help.
Below, you will find some examples of how to build a DEB package.
# ./generate_debian_package.sh -b v4.7.5 --packages-branch v4.7.5 -s /tmp -t manager -a amd64 -r my_rev.
This will generate a 4.7.5 Wazuh manager package DEB with revision my_rev
for amd64
systems.
# ./generate_debian_package.sh -b v4.7.5 --packages-branch v4.7.5 -s /tmp -t api -a i386 -r my_rev
This will generate a 4.7.5 Wazuh api package DEB with revision my_rev
for i386
systems and store it in /tmp
.
# ./generate_debian_package.sh -b v4.7.5 --packages-branch v4.7.5 -t agent -a amd64 -p /opt/ossec
This will generate a 4.7.5 Wazuh agent DEB package with /opt/ossec
as installation directory for amd64
systems.