A Debian-based Cross-Compile Environment running in Docker.
Workflows :
- Summary
- Create a container
- Open a shell in the container
- Install linux tools
- Building the image from scratch
- License & Acknowledgements
docker run -d --name debian-xcenv --hostname debian-xcenv -v ./exercises:/root/exercises --network=host --tty=true ghcr.io/fred-corp/debian-xcenvYAML Example :
services:
debian-xcenv:
image: ghcr.io/fred-corp/debian-xcenv:latest
container_name: debian-xcenv
hostname: debian-xcenv
restart: unless-stopped
privileged: true
tty: true
stdin_open: true
8000
network_mode: host
ipc: host
pid: host
volumes:
- "./exercices:/root/exercises"Then, create the container with docker-compose :
docker-compose up -dNote : You can also specify the architecture of the container by adding
:arm64or:amd64to the image name.
Note : This commands will mount theexercicesfolder in the current directory to/root/exercisesin the container. You can change this path to your needs.
You can open a shell in the container using the following command :
docker exec -it -e "TERM=xterm-256color" debian-xcenv /bin/zshDepending on your target, you'll need different linux tools.
If you're building for Raspberry Pi, you'll need to install the following tools and files :
From the amazing guide from Jeff Geerling
git clone --depth=1 https://github.com/raspberrypi/linux ./rpi-linuxcd rpi-linuxKERNEL=kernel8Create the .config file for the kernel:
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- bcm2711_defconfigThen, you can build the kernel:
make -j$(nproc --all) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- Image modules dtbsIf you're building for Beaglebone Black, you'll need to install the following tools and files :
From the amazing guide from Quentin Delhaye
wget https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-aarch64-arm-none-linux-gnueabihf.tar.xzmkdir -p /opt/arm-gnu-toolchain-13.2.rel1-aarch64-arm-none-linux-gnueabihfchown $LOGNAME:$LOGNAME /opt/arm-gnu-toolchain-13.2.rel1-aarch64-arm-none-linux-gnueabihftar -xf arm-gnu-toolchain-13.2.rel1-aarch64-arm-none-linux-gnueabihf.tar.xz -C /opt/arm-gnu-toolchain-13.2.rel1-aarch64-arm-none-linux-gnueabihfecho "PATH=/opt/arm-gnu-toolchain-13.2.rel1-aarch64-arm-none-linux-gnueabihf/arm-gnu-toolchain-13.2.Rel1-aarch64-arm-none-linux-gnueabihf/bin/:$PATH" >> ~/.zshrcsource ~/.zshrcwget https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xzmkdir -p /opt/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihfchown $LOGNAME:$LOGNAME /opt/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihftar -xf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz -C /opt/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihfecho "PATH=/opt/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-linux-gnueabihf/bin/:$PATH" >> ~/.zshrcsource ~/.zshrcarm-none-linux-gnueabihf-gcc -vNote : You can then follow the rest of Quentin Delhaye's guide to build the kernel; steps should look like this :
Clone the kernel source code (4.19 branch only) :
git clone -b 4.19 --depth=1 https://github.com/beagleboard/linux.git ./bbb-linuxcd bbb-linuxAdd a .config file for the kernel (you can do so by following this step), then compile :
make -j$(nproc --all) CROSS_COMPILE=arm-none-linux-gnueabihf- ARCH=armIf you want to build the image from scratch, you can do so by running the following command in the root of the repository:
docker-compose buildThen, you can run the image using the following command:
docker-compose up -dMade with ❤️, lots of ☕️, and lack of 🛌
