pfichtner-freetz

This is my version of a Freetz(-NG) build environment. With this I am running builds to create various images (3270, 3370, 7570,7390, 7490, 7590) with various configs in a CI environment.

When and why to use it?

• You don't want to mess up your linux system with all those prerequisites needed to build Freetz(-NG)
• You don't wan't to download a full featured virtual machine image (which if there are new prerequisites you have them to integrate on your own which perhaps was the reason you started using the virtual machine image)
• The virtual machine image generates to much overhead (RAM/CPU/...)
• You need (love) fast startup times (milliseconds compared to seconds/minutes)

How to use it?

You could checkout inside a separate volume

With this approach the files are not stored inside the "pfichtner/freetz build container" but a separate volume:

# start docker container (will start /bin/bash)
docker run --rm -it -v freetz-workspace:/workspace pfichtner/freetz
# clone (checkout) the remote repo into the current directory (only needed once/the first time)
git clone https://github.com/Freetz-NG/freetz-ng.git

You could checkout inside the pfichtner/freetz container

But if you delete the container (e.g. when updating to a newer version of it) you'll lose everything you put meanwhile in this container e.g. (intermediate) build results! The first time start looks like:

# start docker container (will start /bin/bash)
docker run -it -v freetz-workspace:/workspace pfichtner/freetz
# clone (checkout) the remote repo into the current directory (only needed once/the first time)
git clone https://github.com/Freetz-NG/freetz-ng.git

After exiting the container the container is stopped. You can resume it via docker start -i <containerid> (you can determine the containerid by executing docker ps -a)

You could mount a directory on the host system to use inside the container

All files checked out and generated during the build resides on the host system.

To do this, "cd" into the directory with the checked out Freetz(-NG)-repository and use the current directory ($PWD) as volume for the container and then execute the build there. Here comes the complete workflow:

# necessary for the following clone
umask 0022
# clone (checkout) the remote repo
git clone https://github.com/Freetz-NG/freetz-ng.git
# cd into the cloned repo
cd freetz-ng
# start docker container (will start /bin/bash)
docker run --rm -it --platform linux/amd64 -v $PWD:/workspace pfichtner/freetz

(if you don't checkout Freetz(-NG) to the current directory replace $PWD with the path to the checked out repository) Please note that the filesystem where Freetz(-NG) has been checked out has to be case-sensitive!

In all three cases you'll get a shell (bash) where you can work like your are in "a normal bash" like before, e.g. you now call call make then make menuconfig or any other command you like. If you want to leave this shell, just type exit as usual.

Docker command/options explained

docker run start a new container

--rm remove (purge) that container after it terminates

-it run in interactive mode/run in terminal mode

-v $PWD:/workspace mount the current working directory of the host as /workspace inside the container

-v a-volume-name:/workspace use the existing "a-volume-name"-volume or create it if it does not exist and use it as /workspace inside the container

--platform linux/amd64 use x86_64 images, if running on a Mac with M1/2 (ARM) for instance

pfichtner/freetz the image to create the container from

Screencast

Here's a screencast where Freetz(-NG) is checked out and menuconfig and make are run in the container

If you dont' want an interactive shell (bash) but run command directly you can pass them using bash -c

docker run --rm -it -v $PWD:/workspace pfichtner/freetz /bin/bash -c "make menuconfig && make"

If you don't want or can't clone the Freetz(-NG) repository using your local machine you can do this also using inside docker container (but having the files outside of the container thus the machine you are running docker on)

mkdir ~/some-empty-directory-for-freetz
docker run --rm -v ~/some-empty-directory-for-freetz:/workspace pfichtner/freetz \
  /bin/bash -c "git clone https://github.com/Freetz-NG/freetz-ng.git . && make menuconfig && make"

And here's a screencast for this

Of course in a CI environment you don't want to do menuconfig since it's a fully automated build. That's where I am using oldconfig:

docker run --rm -v $PWD:/workspace pfichtner/freetz /bin/bash -c "make oldconfig && make"

Some hints if you're new to docker

• You can use docker on most linux/unix systems (and many other systems like Windows, too)
• Docker should be installable via the package manager of your distribution (dkpg/apt, rpm, yum, ...)
• When installing docker initially on your machine, the user you want to use docker for has to be member of the docker group ("docker" on ubuntu, could differ in other distros), so add the user to the "docker" group
• If you start an image (better said container) for the first time, the image is pulled from the remote docker repository ("dockerhub"). This could take a while but after that the image is cached on you machine and has not to be downloaded again
• If you want to update an image that already was downloaded you can use docker pull pfichtner/freetz to check for a newer image and update it

Alternative to docker (podman)

pfichtner/freetz also runs using podman (which has advantages due to being daemonless, so you don't have to add users to any groups)

podman run -u root --userns keep-id --rm -it -v $PWD:/workspace docker.io/pfichtner/freetz