This repository contains the necessary tools to build and test cfengine packages for various platforms.
Example build of Community Agent
A minimal example would be to build packages for cfengine community agent. This should be done in an isolated environment such as a dedicated host, virtual machine or linux container.
Install necessary distribution packages. For example on debian/ubuntu:
apt update -y
apt upgrade -y
apt install -y git autoconf automake m4 make bison flex binutils libtool gcc g++ libc-dev libpam0g-dev python3 psmisc libtokyocabinet-dev libssl-dev libpcre3-dev default-jre-headless build-essential fakeroot ntp dpkg-dev debhelper pkg-config nfs-common sudo apt-utils wget libncurses5 rsync libexpat1-dev libexpat1 curl
apt purge -y emacs emacs24 libltdl-dev libltdl7
Get the cfengine source code:
mkdir $HOME/cfengine
cd $HOME/cfengine
git clone --recursive --depth 1 https://github.com/cfengine/core
git clone --depth 1 https://github.com/cfengine/buildscripts
git clone --depth 1 https://github.com/cfengine/masterfiles
Set some environment variables:
export NO_CONFIGURE=1
export PROJECT=community
export BUILD_TYPE=DEBUG
export EXPLICIT_ROLE=agent
Execute the build steps and see that packages are generated:
./buildscripts/build-scripts/autogen
./buildscripts/build-scripts/clean-buildmachine
./buildscripts/build-scripts/build-environment-check
./buildscripts/build-scripts/install-dependencies
./buildscripts/build-scripts/configure
./buildscripts/build-scripts/compile
./buildscripts/build-scripts/package
ls -l cfengine-community/*.deb
General Build Machine Prerequisites
Due to sheer diversity of the environments, build machine is expected to provide strict minimum amount of software (don't forget --no-install-recommends on dpkg-based systems):
To access the build machine:
- SSH server
- Bundled one on Unixes
- FreeSSHd on Windows
- 'build' account with SSH key installed
To transfer files back and forth:
- rsync on Unixes
- 7z on Windows
To be able to install packages and run tests:
- passwordless sudo access for 'build' account
- sudo should not require TTY (remove 'Defaults requiretty' from /etc/sudoers)
To build everything:
- GCC (gcc)
- GNU make (make)
- libc development package (libc-dev, glibc-devel)
- bison (bison)
- flex (flex)
- fakeroot (but not fakeroot 1.12, it is horribly slow!)
To create packages:
- Native packaging manager
- rpm-build on RPM-based systems
- dpkg-dev, debhelper, fakeroot
- WiX on Windows
To build MySQL library (yeah!):
- g++ (gcc-c++, g++)
- ncurses (ncurses-devel, libncurses5-dev)
To build libvirt:
- pkg-config (pkg-config, pkgconfig)
Anything else is either preprocessed on buildbot slave or built and installed during build.
Documentation build pre-requisites
- texinfo
- texlive
- cm-super
- texlive-fonts-extra
Non-requisites
Build machines should not contain the following items, which may interfere with build process:
- CFEngine itself, either in source or binary form (build machines are short-living, so this is not a problem)
- Development packages for anything beside libc to avoid picking them up instead of bundled ones accidentally.
- MySQL and PostgreSQL servers, clients and libraries
The following packages should not be installed on build machines as well, to avoid accidentally regenerating files transferred from buildslave:
- automake
- autoconf
- libtool
Dependencies
File install-dependencies and the relevant subdirectories in deps-packaging are the source of this information.
Build dependencies
| CFEngine version | 3.15.x | 3.18.x | master |
|---|---|---|---|
| lcov | 1.14 | 1.15 | 1.15 |
| git | |||
| rsync |
Agent Dependencies
| CFEngine version | 3.15.x | 3.18.x | master | Notes |
|---|---|---|---|---|
| diffutils | - | 3.8 | 3.8 | |
| libacl | 2.3.1 | 2.3.1 | 2.3.1 | |
| libattr | 2.5.1 | 2.5.1 | 2.5.1 | |
| libcurl | 7.86.0 | 7.86.0 | 7.86.0 | |
| libgnurx | 2.5.1 | 2.5.1 | 2.5.1 | Windows Enterprise agent |
| libiconv | 1.17 | 1.17 | 1.17 | Needed by libxml2 |
| libxml2 | 2.9.12 | 2.9.14 | 2.9.14 | |
| libyaml | 0.2.5 | 0.2.5 | 0.2.5 | |
| LMDB | 0.9.29 | 0.9.29 | 0.9.29 | |
| OpenLDAP | 2.4.58 | 2.6.3 | 2.6.3 | Enterprise agent only |
| OpenSSL | 1.1.1q | 1.1.1q | 3.0.7 | |
| PCRE | 8.45 | 8.45 | 8.45 | |
| pthreads-w32 | 2-9-1 | 2-9-1 | 2-9-1 | Windows Enterprise agent |
| SASL2 | 2.1.28 | 2.1.28 | 2.1.28 | Solaris Enterprise agent |
| zlib | 1.2.13 | 1.2.13 | 1.2.13 | |
| libgcc | AIX and Solaris only |
Enterprise Hub dependencies:
| CFEngine version | 3.15.x | 3.18.x | master |
|---|---|---|---|
| Apache | 2.4.54 | 2.4.54 | 2.4.54 |
| APR | 1.7.0 | 1.7.0 | 1.7.0 |
| apr-util | 1.6.1 | 1.6.1 | 1.6.1 |
| Git | 2.38.1 | 2.38.1 | 2.38.1 |
| PHP | 7.4.32 | 8.0.24 | 8.1.12 |
| PostgreSQL | 12.12 | 13.8 | 15.1 |
| rsync | 3.2.7 | 3.2.7 | 3.2.7 |
- MinGW-w64 OUTDATED needed
for redmine#2932
- Requires change of buildslaves (autobuild)
Other dependencies (find out why they are needed!)
- autoconf 2.69