Anleitung docker container Freetz-Ng

Hier ist eine detaillierte Anleitung zur Nutzung des pfichtner-freetz Projekts auf Deutsch:

### Übersicht
Das pfichtner-freetz Projekt ist eine modifizierte Version der Freetz(-NG) Build-Umgebung, die es ermöglicht, verschiedene Images für AVM Fritz!Box Router in einer CI-Umgebung zu erstellen. Dies bietet Vorteile wie geringere Systembelastung und schnellere Startzeiten im Vergleich zu virtuellen Maschinen.

### Voraussetzungen
Um das Projekt zu nutzen, benötigen Sie Docker und Git auf Ihrem System. Stellen Sie sicher, dass Docker korrekt installiert und konfiguriert ist.

### Nutzungsmöglichkeiten

#### 1. Checkout in ein separates Volume
Mit dieser Methode werden die Dateien nicht im pfichtner/freetz Build-Container gespeichert, sondern in einem separaten Docker-Volume.

1. Docker-Container starten (öffnet eine Bash-Shell):

docker run --rm -it -v freetz-workspace:/workspace pfichtner/freetz

2. Repository klonen (nur einmal erforderlich):

git clone https://github.com/Freetz-NG/freetz-ng.git


#### 2. Checkout innerhalb des Containers
Bei dieser Methode gehen alle Daten verloren, wenn der Container gelöscht wird.

1. Docker-Container starten:

docker run -it pfichtner/freetz

2. Repository klonen (nur einmal erforderlich):

git clone https://github.com/Freetz-NG/freetz-ng.git

3. Nach dem Beenden des Containers kann dieser mit folgendem Befehl wieder gestartet werden:

docker start -i <containerid>


#### 3. Ein Verzeichnis vom Hostsystem mounten
Diese Methode speichert alle ausgecheckten und generierten Dateien auf dem Hostsystem.

1. In das Verzeichnis des ausgecheckten Repositories wechseln:

cd /Pfad/zum/repository

2. Docker-Container starten und aktuelles Verzeichnis mounten:

docker run --rm -it -v $PWD:/workspace pfichtner/freetz


### Umgebungsvariablen
Sie können verschiedene Umgebungsvariablen über die Docker -e Option setzen, zum Beispiel:

• BUILD_USER: Benutzername des nicht-root Benutzers
• BUILD_USER_UID: UID des BUILD_USER, normalerweise die UID Ihres aktuellen Benutzers
• USE_UID_FROM: UID des Dateisystems nutzen, zu dem die Datei/Verzeichnis gehört
• BUILD_USER_HOME: Home-Verzeichnis des BUILD_USER
• AUTOINSTALL_PREREQUISITES: Automatische Installation von fehlenden Voraussetzungen (Standard: y)

Beispielbefehl:

docker run --rm -i -e BUILD_USER=builduser -e BUILD_USER_UID=$(id -u) -e BUILD_USER_HOME=/home/builduser -w /home/builduser pfichtner/freetz

### Build-Prozess
Nach dem Start des Containers können Sie den Build-Prozess wie gewohnt durchführen:
1. Menükonfiguration starten:

make menuconfig

2. Build starten:

make


Diese Anleitung sollte Ihnen den Einstieg in die Nutzung des pfichtner-freetz Projekts erleichtern. Weitere Details finden Sie im des Projekts.