This repository contains the necessary tools to build and test cfengine packages for various platforms.
By experimentation I have found that building hub packages, which includes php dependency requires more than 1.6G of RAM/swap. 2.6G worked for me, less might work as well.
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 libpcre2-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
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.
- texinfo
- texlive
- cm-super
- texlive-fonts-extra
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
File install-dependencies and the relevant subdirectories in deps-packaging are the source of this information.
| CFEngine version | 3.21.x | 3.24.x | master | Notes |
|---|---|---|---|---|
| diffutils | 3.10 | 3.10 | 3.10 | |
| libacl | 2.3.2 | 2.3.2 | 2.3.2 | |
| libattr | 2.5.2 | 2.5.2 | 2.5.2 | |
| libcurl | 8.10.1 | 8.10.1 | 8.10.1 | |
| 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.13.4 | 2.13.4 | 2.13.4 | |
| libyaml | 0.2.5 | 0.2.5 | 0.2.5 | |
| LMDB | 0.9.33 | 0.9.33 | 0.9.33 | |
| OpenLDAP | 2.6.8 | 2.6.8 | 2.6.8 | Enterprise agent only |
| OpenSSL | 3.0.15 | 3.3.2 | 3.3.2 | |
| PCRE | 8.45 | - | - | |
| PCRE2 | - | 10.44 | 10.44 | |
| 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.3.1 | 1.3.1 | 1.3.1 | |
| libgcc | AIX and Solaris only |
| CFEngine version | 3.21.x | 3.24.x | master |
|---|---|---|---|
| Apache | 2.4.62 | 2.4.62 | 2.4.62 |
| APR | 1.7.5 | 1.7.5 | 1.7.5 |
| apr-util | 1.6.3 | 1.6.3 | 1.6.3 |
| Git | 2.47.0 | 2.47.0 | 2.47.0 |
| libexpat | - | 2.6.3 | 2.6.3 |
| PHP | 8.3.12 | 8.3.12 | 8.3.12 |
| PostgreSQL | 15.8 | 16.4 | 17.0 |
| rsync | 3.3.0 | 3.3.0 | 3.3.0 |
- MinGW-w64 OUTDATED needed
for redmine#2932
- Requires change of buildslaves (autobuild)