Tag 0: Das Trainingsgelände
Ziel: Die Labor-VM anlegen, Docker und die Werkzeuge installieren, den Begleitcode holen, notes starten und den Werkzeugkasten vorbereiten. · Dauer: ca. 45 min · Voraussetzung: keine
Briefing
- Gearbeitet wird in der Ubuntu-26.04-VM
sh, als Userubuntuin~/sh-lab. - notes ist die Anwendung, die deine Skripte betreuen: notes-api (Go) speichert Notizen in Postgres, davor steht nginx und schreibt jede Anfrage in ein Zugriffslog.
- Dein Werkzeugkasten liegt in
~/sh-lab/werkzeug:bin/für Skripte,lib/für gemeinsame Funktionen,tests/für Tests.env.shsetztbin/an den Anfang vonPATH. - Werkzeuge: ShellCheck findet Fehler in Skripten, shfmt formatiert sie, bats testet sie, jq liest JSON.
du ─ssh─► VM sh: curl 127.0.0.1:8080 ─► nginx ─► notes-api ─► Postgres
└─► ~/sh-lab/notes/logs/access.log
~/sh-lab/werkzeug/{bin,lib,tests}
Drill 1: Die Labor-VM
Auf dem Laptop (Multipass von
multipass.run):
multipass launch 26.04 --name sh --cpus 2 --memory 4G --disk 20G
multipass exec sh -- bash -c "echo '$(cat ~/.ssh/id_ed25519.pub)' \
>> ~/.ssh/authorized_keys"
multipass info sh | grep IPv4
ssh ubuntu@<IP aus der Ausgabe>
Ab hier läuft alles in der VM:
bash --version | head -1
echo "$SHELL"
readlink -f /bin/shErwartet:
GNU bash, version 5.3.9(1)-release (x86_64-pc-linux-gnu)
/bin/bash
/usr/bin/dash
Deine Login-Shell ist Bash. /bin/sh ist auf Ubuntu aber
dash, eine kleine, streng POSIX-konforme Shell. Ein
Skript, das mit #!/bin/sh beginnt, läuft also nicht in Bash
– dazu mehr an Tag 1. Auf einem Mac mit Apple Silicon steht
aarch64 statt x86_64.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Docker und Werkzeuge
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
https://download.docker.com/linux/ubuntu $(. /etc/os-release; echo $VERSION_CODENAME) \
stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
sudo apt-get update -qq
sudo apt-get install -y -qq docker-ce docker-ce-cli containerd.io \
docker-compose-plugin jq git xz-utils >/dev/null
sudo usermod -aG docker ubuntuShellCheck und shfmt kommen als einzelne Programme von GitHub, bats
per git:
case "$(uname -m)" in
x86_64) SC=x86_64; SF=amd64 ;;
aarch64) SC=aarch64; SF=arm64 ;;
esac
cd /tmp
U=https://github.com/koalaman/shellcheck/releases/download/v0.11.0
curl -fsSL $U/shellcheck-v0.11.0.linux.$SC.tar.xz | tar -xJ
sudo install -m 0755 shellcheck-v0.11.0/shellcheck /usr/local/bin/
sudo curl -fsSL -o /usr/local/bin/shfmt \
https://github.com/mvdan/sh/releases/download/v3.14.1/shfmt_v3.14.1_linux_$SF
sudo chmod 0755 /usr/local/bin/shfmt
git clone -q --depth 1 --branch v1.14.0 https://github.com/bats-core/bats-core.git \
/tmp/bats 2>/dev/null
sudo /tmp/bats/install.sh /usr/local >/dev/nullMelde dich ab (exit) und wieder an, damit die Gruppe
docker gilt:
docker --version
docker compose version
shellcheck --version | sed -n 2p
shfmt --version
bats --version
jq --versionErwartet:
Docker version 29.9.2, build a82e528
Docker Compose version v5.6.1
version: 0.11.0
v3.14.1
Bats 1.14.0
jq-1.8.1
Das case oben ist schon ein Stück Shell-Skript: Es wählt
je nach Prozessor den passenden Dateinamen. An Tag 3 schreibst du solche
Verzweigungen selbst.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Begleitcode und Umgebung
mkdir -p ~/sh-lab/setup
git clone -q https://github.com/thomaszachmann/shell-scripting-zum-anfassen.git \
~/sh-lab/code
cp ~/sh-lab/code/setup/env.sh ~/sh-lab/setup/
cat ~/sh-lab/setup/env.sh
source ~/sh-lab/setup/env.sh
echo "$PATH" | cut -d: -f1Erwartet:
# setup/env.sh – zu Beginn jedes Trainingstags einlesen: source ~/sh-lab/setup/env.sh
export LAB="$HOME/sh-lab"
export NOTES_URL="http://127.0.0.1:8080" # notes hinter nginx
export NOTES_API_KEY="lab-api-key-123" # nur Labor
export NOTES_LOG="$LAB/notes/logs/access.log" # Zugriffslog von nginx
case ":$PATH:" in
*":$LAB/werkzeug/bin:"*) ;;
*) export PATH="$LAB/werkzeug/bin:$PATH" ;; # eigene Skripte zuerst
esac
true
/home/ubuntu/sh-lab/werkzeug/bin
source führt die Datei in deiner laufenden Shell aus –
die Variablen bleiben danach gesetzt. Ein normaler Aufruf
(bash env.sh) liefe in einer neuen Shell, und alles wäre
danach wieder weg. Das case sorgt dafür, dass
bin/ nicht bei jedem source noch einmal in
PATH landet.
Fortschritt speichern? Kostenlos registrieren
Drill 4: notes starten
cd ~/sh-lab/code/notes/notes-api
docker build -q --build-arg VERSION=0.4.0 -t notes-api:0.4.0 . | cut -c1-19
cp -R ~/sh-lab/code/notes-stack ~/sh-lab/notes && cd ~/sh-lab/notes
docker compose up -d --wait 2>&1 | grep -E 'Healthy|Started' | tail -2
curl -s $NOTES_URL/healthz; echo
curl -s -X POST -H "X-API-Key: $NOTES_API_KEY" \
-H 'Content-Type: application/json' -d '{"text":"erste Notiz"}' $NOTES_URL/notes
echo
tail -2 "$NOTES_LOG"Erwartet (gekürzt, beim ersten Mal einige Minuten):
sha256:f453f6401d46
Container notes-db-1 Healthy
Container notes-notes-api-1 Healthy
ok
{"id":"…","text":"erste Notiz"}
172.19.0.1 [02/Nov/2026:11:56:21 +0000] "GET /healthz HTTP/1.1" 200 3 0.002 curl/8.18.0
172.19.0.1 [02/Nov/2026:11:56:21 +0000] "POST /notes HTTP/1.1" 201 67 0.009 curl/8.18.0
Jede Zeile im Log ist eine Anfrage: Absender, Zeit, Anfrage, Status, Bytes, Dauer in Sekunden und Programm. Ab Tag 6 wertest du genau diese Zeilen aus.
Achtung: Auf Ubuntu 26.04 blockiert das AppArmor-Profil
docker-defaultden Postgres-Container. Deshalb steht incompose.yamlfürdbdie Zeileapparmor=unconfined– nur im Labor.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Der Werkzeugkasten
mkdir -p ~/sh-lab/werkzeug/{bin,lib,tests}
ls ~/sh-lab/werkzeug
type -a ls cdErwartet:
bin
lib
tests
ls is aliased to `ls --color=auto'
ls is /usr/bin/ls
ls is /bin/ls
cd is a shell builtin
{bin,lib,tests}ist Brace Expansion: Bash macht daraus drei Wörter, bevormkdirstartet.type -azeigt, was hinter einem Namen steckt: ein Alias, ein Programm imPATHoder ein Builtin, das die Shell selbst ausführt.lsgibt es zweimal, weil/binauf Ubuntu nur ein Link auf/usr/binist. Den Alias kennt nur deine interaktive Shell, in einem Skript fehlt er.cdmuss ein Builtin sein – ein eigenes Programm könnte das Verzeichnis deiner Shell nicht ändern.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
docker compose -f ~/sh-lab/notes/compose.yaml ps --format '{{.Service}}' | sortErwartet: drei laufende Dienste (migrate ist fertig und beendet).
db
notes-api
proxy
curl -s -o /dev/null -w '%{http_code}\n' $NOTES_URL/notesErwartet:
200
command -v shellcheck shfmt bats jqErwartet:
/usr/local/bin/shellcheck
/usr/local/bin/shfmt
/usr/local/bin/bats
/usr/bin/jq
Challenge
Finde alle Befehle, deren Name nur aus Kleinbuchstaben besteht und
auf sh endet – also Shells wie bash,
dash und sh.
Hinweis: compgen -c listet alle
Befehle, die die Shell kennt.
Lösung
compgen -c | grep -E '^[a-z]*sh$' | sort -uErwartet (je nach installierten Paketen):
bash
capsh
chsh
dash
hash
instmodsh
podmansh
rbash
sh
ssh
tclsh
rbash ist eine eingeschränkte Bash, hash
ein Builtin, ssh und chsh sind gar keine
Shells. Auch das gehört dazu: Ein Muster findet, was passt, nicht was
gemeint ist.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Ein Werkzeugkasten, viele Server: Skripte gehören in ein Git-Repository und werden von dort verteilt, nicht auf jedem Server einzeln gepflegt (Tag 14).
- Feste Versionen: ShellCheck, shfmt und bats laufen in der CI mit denselben Versionen wie lokal – sonst meldet die CI Fehler, die lokal niemand sieht.
- Bash ist nicht überall: Alpine-Container und
BusyBox haben nur
sh. Wer dort Skripte braucht, schreibt sie POSIX-konform oder installiertbashausdrücklich.