Packaging Project for Fledge

This repo contains the scripts used to create a Fledge package.

We have separated the package build from the main repository in order to provide a more flexible packaging and to maintain the smallest possible footprint of the main project, even in terms of source code and development.

Internal Structure

The repository contains the following set of files:

• Files named with make_ prefix, such as make_deb, make_rpm, are the shell scripts used to build the package. The script runs as per the architecture to build.
• The packages folder contains the list package types to build. It contains Debian and RPM, latter for RedHat/Centos RPM creation.
  • Inside the packages/Debian folder, we have the architecture folders, plus a common folder containing files that are common to all the architectures. The architectures that we provide at the moment are aarch64, armv7l and x86_64.
    • Inside the architecture folder we have the DEBIAN folder, which contains only control file
    • Inside the common folder we have the DEBIAN folder, which contains pre/post inst/rm, needed for the creation of the package.
  • After the first build, the packages/Debian will also contain a build/architecture folder. This folder contains a copy of what will be used to build the package (in a directory with the same name of the package) and the package itself.
    • In the build/architecture folder, folders and files that have a sequence number are a previous package build.
  • Inside the packages/RPM/SPECS folder, which contains RPM spec-based file, i.e. fledge.spec needed for the creation of the package.
    • In the packages/RPM/build/RPMS/x86_64 folder which contains the actual rpm package.
    • In the packages/RPM/build/BUILDROOT/fledge-1.7.0-1.x86_64 folder which contains the RPM package file structure

The make_deb Script

$ ./make_deb helpmake_deb [help|clean|cleanall]This script is used to create the Debian package of FledgeArguments: help - Display this help text clean - Remove all the old versions saved in format .XXXX cleanall - Remove all the versions, including the last one
$

Warning

Postgres dependencies will not be installed automatically. In order to use postgres storage engine, you will need manual installation of postgresql.

yes Y | sudo apt install postgresql

Building a Debian Package

First, make sure that Fledge is properly installed via make install somewhere on your environment (default is /usr/local/fledge). Finally, run the make_deb command and it will make as per arch:

$ ./make_debThe package root directory is : /home/fledge/fledge-pkgThe Fledge directory is : /usr/local/fledgeThe Fledge version is : 1.6.0The package will be built in : /home/fledge/fledge-pkg/packages/Debian/build/x86_64The architecture is set as : x86_64The package name is : fledge-1.6.0-x86_64Populating the package...Done.Building the new package...dpkg-deb: building package 'fledge' in 'fledge-1.6.0-x86_64.deb'.Building Complete.
$

The result will be:

$ ls -l packages/Debian/build/x86_64total 564drwxrwxr-x 4 fledge fledge 4096 Mar 23 17:35 fledge-1.6.0-x86_64-rw-r--r-- 1 fledge fledge 572742 Mar 23 17:35 fledge-1.6.0-x86_64.deb
$

If you execute the make_deb command again, you will see:

$ ./make_debThe package root directory is : /home/fledge/fledge-pkgThe Fledge directory is : /usr/local/fledgeThe Fledge version is : 1.6.0The package will be built in : /home/fledge/fledge-pkg/packages/Debian/build/x86_64The architecture is set as : x86_64The package name is : fledge-1.6.0-x86_64Saving the old working environment as fledge-1.6.0-x86_64.0001Populating the package...Done.Saving the old package as fledge-1.6.0-x86_64.deb.0001Building the new package...dpkg-deb: building package 'fledge' in 'fledge-1.6.0-x86_64.deb'.Building Complete.
$
$ ls -l packages/Debian/build/x86_64total 1128drwxrwxr-x 4 fledge fledge 4096 Mar 23 17:53 fledge-1.6.0-x86_64drwxrwxr-x 4 fledge fledge 4096 Mar 23 17:35 fledge-1.6.0-x86_64.0001-rw-r--r-- 1 fledge fledge 573080 Mar 23 17:54 fledge-1.6.0-x86_64.deb-rw-r--r-- 1 fledge fledge 572742 Mar 23 17:35 fledge-1.6.0-x86_64.deb.0001
$

... where the previous build is now marked with the suffix .0001.

The make_rpm Script

$ ./make_rpm -h make_rpm [-h] [-c] [-a] [-s] [-b <branch>] This script is used to create the RPM package of Fledge Arguments: -h - Display this help text -c - Remove all the old versions saved in format .XXXX -a - Remove all the versions, including the last one -s - Skip Fledge building using the binaries already available -b - Branch to base package on
$

Building a RPM Package

make_rpm script automatically do Fledge clone repo with branch main (by default) and then sudo make install followed by some prerequisite

You may override the branch with -b or skip Fledge build with -s. For more info just see its help -h

Next, x86 is the only currently supported architecture for RedHat/Centos.

$ ./make_rpmThe package root directory is : /home/fledge/fledge-pkgThe Fledge directory is : /home/fledge/FledgeThe Fledge version is : 1.7.0The package will be built in : /home/fledge/fledge-pkg/packages/RPM/build/RPMS/x86_64The package name is : fledge-1.7.0-1.x86_64Populating the package and updating version in control file...Done.Prepare data directoryBuilding the new package...Processing files: fledge-1.7.0-1.x86_64Provides: fledge = 1.7.0-1 fledge(x86-64) = 1.7.0-1Requires(interp): /bin/sh /bin/sh /bin/shRequires(rpmlib): rpmlib(FileDigests) <= 4.6.0-1 rpmlib(PayloadFilesHavePrefix) <= 4.0-1 rpmlib(CompressedFileNames) <= 3.0.4-1Requires(pre): /bin/shRequires(post): /bin/shRequires(preun): /bin/shChecking for unpackaged file(s): /usr/lib/rpm/check-files /home/fledge/fledge-pkg/packages/RPM/build/BUILDROOT/fledge-1.7.0-1.x86_64Wrote: /home/fledge/fledge-pkg/packages/RPM/build/RPMS/x86_64/fledge-1.7.0-1.x86_64.rpmBuilding Complete.
$

The result will be:

$ ls -l packages/RPM/build/RPMS/x86_64total 6444-rw-rw-r-- 1 fledge fledge 9715306 Sep 27 02:08 fledge-1.7.0-1.x86_64.rpm
$

If you execute the make_rpm command again, you will see:

$ ./make_rpmThe package root directory is : /home/fledge/fledge-pkgThe Fledge directory is : /home/fledge/FledgeThe Fledge version is : 1.7.0The package will be built in : /home/fledge/fledge-pkg/packages/RPM/build/RPMS/x86_64The package name is : fledge-1.7.0-1.x86_64Saving the old working environment as fledge-1.7.0-1.x86_64.0001Populating the package and updating version in control file...Done.Prepare data directorySaving the old package as fledge-1.7.0-1.x86_64.rpm.0001Building the new package...Processing files: fledge-1.7.0-1.x86_64Provides: fledge = 1.7.0-1 fledge(x86-64) = 1.7.0-1Requires(interp): /bin/sh /bin/sh /bin/shRequires(rpmlib): rpmlib(FileDigests) <= 4.6.0-1 rpmlib(PayloadFilesHavePrefix) <= 4.0-1 rpmlib(CompressedFileNames) <= 3.0.4-1Requires(pre): /bin/shRequires(post): /bin/shRequires(preun): /bin/shChecking for unpackaged file(s): /usr/lib/rpm/check-files /home/fledge/fledge-pkg/packages/RPM/build/BUILDROOT/fledge-1.7.0-1.x86_64Wrote: /home/fledge/fledge-pkg/packages/RPM/build/RPMS/x86_64/fledge-1.7.0-1.x86_64.rpmBuilding Complete.
$ ls -l packages/RPM/build/RPMS/x86_64total 12888-rw-rw-r-- 1 fledge fledge 9715306 Sep 27 02:10 fledge-1.7.0-1.x86_64.rpm-rw-rw-r-- 1 fledge fledge 9715326 Sep 27 02:08 fledge-1.7.0-1.x86_64.rpm.0001
$

... where the previous build is now marked with the suffix .0001.

Cleaning the Package Folder

1. Debian

Use the clean option to remove all the old packages and the files used to make the package. Use the cleanall option to remove all the packages and the files used to make the package.

2. RPM

Use the -a option to remove all the RPM packages and the files used to make the package. Use the -c option to remove all the old versions of RPM packages and the files used to make the package.

Packaging for Plugins

Please refer to documentation here