Server - Installation mit Docker / Podman

BFFH kann relativ simpel als Container installiert werden. Wir beschreiben hier exemplarisch die Installation mit Docker und mit Podman.Docker. Es gibt weitere Container-Dienste. Wir freuen uns hier über Zuarbeit in der Dokumentation.

Es gibt prinzipiell die Wege mit Docker Compose (hierzu erstellen wir eine docker-compose.yml Datei) oder nutzen den simplen docker run Befehl.

Das in beiden Fällen dafür nötige Docker-Image können wir dabei entweder aus dem Repository selbst erzeugen oder aus der BFFH Container Registry

Dieladen zentrale Container-Registry für bffh liegt in GitLab(pull).

Installation

Außerdem mitgibt Podman

es

verschiedene Testumgebungen zum Ausprobieren, welche mehr oder weniger gepflegt sind. Diese Beschreibungenthalten ist für ein Ubuntu-System erstellt und ist analog anzuwenden/anzupassen für andere Systeme wie Fedora, CentOS, Arch Linux, etc.

Podman installieren

sudo apt update && sudo apt upgrade
sudo apt install podman

bffh Benutzer anlegen

Ein gesonderter Nutzer wird den Container als Non-Root ausführen. Es ist ein Systembenutzer ohne eigenes Homeverzeichnis (-sdocker-compose.yml Parameter).
Dateien.

sudo useradd -m -s /bin/bash bffh

Installation mit Docker

Diese Beschreibung ist für ein Ubuntu-System erstellt und ist analog anzuwenden/anzupassen für andere Systeme wie Fedora, CentOS, Arch Linux, etc.

Docker installieren

Siehe auch https://phoenixnap.com/kb/docker-on-raspberry-pi

sudo apt update && sudo apt upgrade
sudo apt install ca-certificates curl gnupg lsb-release

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io

bffh Benutzer anlegen

Ein gesonderter Nutzer wird den Container als Non-Root ausführen. Es ist ein Systembenutzer ohne eigenes Homeverzeichnis (-s Parameter).

sudo useradd -m -s /bin/bash bffh

Docker Image erstellen mit Dockerfile

TODO

Docker Compose installieren

Siehe auch https://dev.to/elalemanyo/how-to-install-docker-and-docker-compose-on-raspberry-pi-1mo

sudo useradd -m -s /bin/bash bffh

BFFH Git Projekt klonen

Get Docker-Compose Files git clone https://gitlab.com/fabinfra/fabaccess/dockercompose.git fabaccess-server

The Dockerfile is in the root directory of the main repo docker-compose.yml is available in a seperate git repo

Edit config files in config folder to taste

Start Server with docker-compose up -d

To make it eaysier to apply youre changes in your config and keep the dockercompose uptodate, you should “fork” this respository.

Server Logs

Wir können auch die Logs einsehen, um zu prüfen, ob alles funktioniert:

docker-compose logs

Docker mit Certbot oder DNSRoboCert

Mit Hilfe von Certbort oder DNSRoboCert können wir automatisch und einfach SSL-Zertifikate für BFFH und für Mosquitto erstellen.

ToDo