Anhang B: Abschlussprüfung
Ziel: Ohne Anleitung zeigen, dass du robuste Bash-Skripte schreibst: neue Werkzeuge mit Fehlerbehandlung, eine Auswertung mit awk, eine Prüfung fürs Monitoring, Tests und einen Timer. · Dauer: ca. 90 min · Voraussetzung: Tag 15
Spielregeln
- Jede Übung beschreibt nur das Ziel. Den Weg findest du selbst; die Tage in Klammern helfen beim Nachschlagen.
- Jede Übung endet mit einem Prüfblock: einzelne Befehle mit dem, was sie zeigen müssen. Erst wenn alle stimmen, gilt die Übung.
- Neue Werkzeuge kommen nach
~/sh-lab/werkzeug/bin, ladenlib.shund bestehenci.sh– ShellCheck, shfmt und alle Tests.
source ~/sh-lab/setup/env.sh
mkdir -p ~/sh-lab/anhb && cd ~/sh-lab/werkzeugÜbung 1: Wie viele Notizen?
Schreib notes-count: Es gibt die Anzahl der Notizen aus.
Ist notes nicht erreichbar, endet es mit Exit-Code 1 und einer Meldung
auf stderr. (Tag 4, Tag 8)
Prüfblock:
[[ $(notes-count) == $(curl -s "$NOTES_URL/notes" | jq length) ]] && echo "Zahl stimmt"
NOTES_URL=http://127.0.0.1:9 notes-count 2>/dev/null; echo "Exit: $?"Erwartet:
Zahl stimmt
Exit: 1
Lösung
cat > bin/notes-count <<'EOF'
#!/usr/bin/env bash
# notes-count – gibt die Anzahl der Notizen aus
set -euo pipefail
source "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")/../lib/lib.sh"
need curl jq
url=$(notes_url)
curl -fsS --max-time 3 "$url/notes" 2>/dev/null | jq length ||
die "nicht erreichbar: $url"
EOF
chmod +x bin/notes-countFortschritt speichern? Kostenlos registrieren
Übung 2: Die langsamsten Anfragen
Schreib notes-langsam [anzahl] [logdatei]: Es listet die
langsamsten Anfragen mit Dauer in Millisekunden, Methode und Pfad, die
langsamste zuerst. Standard: 5 Anfragen aus $NOTES_LOG.
(Tag 6, Tag 7)
Prüfblock:
notes-langsam 2 tests/fixtures/access.log
notes-langsam | wc -lErwartet:
50.0 ms GET /notes
10.0 ms POST /notes
5
Lösung
cat > bin/notes-langsam <<'EOF'
#!/usr/bin/env bash
# notes-langsam – die langsamsten Anfragen: notes-langsam [anzahl] [logdatei]
set -euo pipefail
source "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")/../lib/lib.sh"
anzahl="${1:-5}"
log="${2:-${NOTES_LOG:?fehlt – source ~/sh-lab/setup/env.sh}}"
[[ $anzahl =~ ^[1-9][0-9]*$ ]] || die "anzahl muss eine Zahl ≥ 1 sein" 2
[[ -r $log ]] || die "nicht lesbar: $log"
awk '{printf "%7.1f ms %s %s\n", $9 * 1000, substr($4, 2), $5}' "$log" |
sort -rn | head -n "$anzahl"
EOF
chmod +x bin/notes-langsamsubstr($4, 2) entfernt das Anführungszeichen vor der
Methode. shfmt will Operatoren wie | und || am
Ende einer umbrochenen Zeile – sonst meldet
ci.sh einen Unterschied. sort -rn sortiert
nach der Zahl am Zeilenanfang – auch mit führenden Leerzeichen.
Fortschritt speichern? Kostenlos registrieren
Übung 3: Ist das Backup frisch?
Schreib notes-backup-check [-d ziel] stunden: Exit-Code
0 und ok: <datei>, wenn es im Backup-Ordner (Standard
~/sh-lab/backups) ein Backup gibt, das jünger als die
angegebenen Stunden ist; sonst eine Meldung und Exit-Code 1. Falsche
Bedienung endet mit 2. (Tag 5, Tag 9, Tag 10)
Prüfblock:
notes-backup-check 24 | cut -c1-10
mkdir -p /tmp/alte-backups && touch -d '3 days ago' /tmp/alte-backups/notes-alt.sql.gz
notes-backup-check -d /tmp/alte-backups 24 2>/dev/null; echo "Exit: $?"
notes-backup-check viele 2>/dev/null; echo "Exit: $?"Erwartet:
ok: notes-
Exit: 1
Exit: 2
Lösung
cat > bin/notes-backup-check <<'EOF'
#!/usr/bin/env bash
# notes-backup-check – gibt es ein frisches Backup? notes-backup-check [-d ziel] stunden
set -euo pipefail
source "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")/../lib/lib.sh"
ziel="$HOME/sh-lab/backups"
if [[ ${1:-} == -d ]]; then
ziel="${2:?-d braucht einen Ordner}"
shift 2
fi
if (($# != 1)) || [[ ! $1 =~ ^[0-9]+$ ]]; then
die "Aufruf: $PROG [-d ziel] stunden" 2
fi
[[ -d $ziel ]] || die "kein Ordner: $ziel"
neu=$(find "$ziel" -maxdepth 1 -name 'notes-*.sql.gz' -mmin "-$(($1 * 60))" \
-printf '%f\n' | sort -r | head -1)
[[ -n $neu ]] || die "kein Backup jünger als $1 h in $ziel"
echo "ok: $neu"
EOF
chmod +x bin/notes-backup-checkFortschritt speichern? Kostenlos registrieren
Übung 4: Tests für die Prüfung
Schreib tests/notes-backup-check.bats mit drei Tests,
die ohne echte Backups auskommen: frisches Backup → 0, nur altes Backup
→ 1, Text statt Zahl → 2. (Tag 11)
Prüfblock:
bats --tap tests/notes-backup-check.bats | grep -c '^ok'
./ci.sh | tail -1Erwartet:
3
ci: alles grün
Lösung
cat > tests/notes-backup-check.bats <<'EOF'
#!/usr/bin/env bats
# Tests für bin/notes-backup-check, mit einem eigenen Ordner je Test
setup() {
PATH="$BATS_TEST_DIRNAME/../bin:$PATH"
ziel="$BATS_TEST_TMPDIR/backups"
mkdir -p "$ziel"
}
@test "frisches Backup ist ok" {
touch "$ziel/notes-20260101-000000.sql.gz"
run notes-backup-check -d "$ziel" 1
[ "$status" -eq 0 ]
[ "$output" = "ok: notes-20260101-000000.sql.gz" ]
}
@test "nur altes Backup ist ein Fehler" {
touch -d '2 days ago' "$ziel/notes-alt.sql.gz"
run notes-backup-check -d "$ziel" 24
[ "$status" -eq 1 ]
}
@test "Text statt Zahl ist falsche Bedienung" {
run notes-backup-check -d "$ziel" viele
[ "$status" -eq 2 ]
}
EOF$BATS_TEST_TMPDIR ist ein eigener, leerer Ordner für
jeden Test; bats räumt ihn danach weg.
Fortschritt speichern? Kostenlos registrieren
Übung 5: Stündlich prüfen
Richte einen systemd-Timer ein, der jede Stunde
notes-backup-check 26 ausführt. Ein fehlendes Backup soll
als gescheiterte Einheit sichtbar werden. Committe alle neuen Dateien
des Werkzeugkastens. (Tag 11, Tag 13)
Prüfblock:
systemctl --user is-enabled notes-backup-check.timer
systemctl --user start notes-backup-check.service
systemctl --user show notes-backup-check.service -p Result
git status --short | wc -lErwartet:
enabled
Result=success
0
Lösung
cat > ~/.config/systemd/user/notes-backup-check.service <<'EOF'
[Unit]
Description=Prüft, ob es ein frisches Backup von notes gibt
[Service]
Type=oneshot
ExecStart=%h/sh-lab/werkzeug/bin/notes-backup-check 26
EOF
cat > ~/.config/systemd/user/notes-backup-check.timer <<'EOF'
[Unit]
Description=Backup-Prüfung jede Stunde
[Timer]
OnCalendar=hourly
Persistent=true
[Install]
WantedBy=timers.target
EOF
systemctl --user daemon-reload
systemctl --user enable --now notes-backup-check.timer 2>/dev/null
git add -A && git commit -qm "Abschlussprüfung: count, langsam, backup-check"26 Stunden statt 24: Das nächtliche Backup darf sich ein wenig verspäten, ohne dass gleich Alarm entsteht.
Fortschritt speichern? Kostenlos registrieren
Wissenstest
- Warum beginnt jedes Skript in diesem Buch mit
set -euo pipefail, und welche Fälle fängt es trotzdem nicht ab? - Was ist der Unterschied zwischen
"$@"und"$*"? - Warum ist
for f in $(find …)gefährlich, und was ist die sichere Form? - Warum geht eine Variable verloren, die du in
befehl | while read …; do …; donesetzt? - Warum baut man JSON mit
jq -n --argstatt mitprintf? - Wie sorgt ein Skript dafür, dass es nie zweimal gleichzeitig läuft, und warum ist das besser als eine PID-Datei?
- Warum reagiert ein Skript in
sleep 600erst nach zehn Minuten aufTERM, und wie ändert man das? - Nenne drei Unterschiede zwischen einem Skript in deinem Terminal und demselben Skript in cron.
- Warum braucht
ssh host "befehl $x"oft zwei Lagen Quoting? - Woran erkennst du mit einem Befehl, ob
notes-checkeine Datei, eine Funktion oder ein Alias ist?
Antworten
-ebricht bei Fehlern ab,-ubei nicht gesetzten Variablen,pipefailmacht Fehler in Pipes sichtbar. Nicht erfasst: Befehle inif,&&/||,$(…)inlocal x=$(…)und Funktionen, die in solchen Bedingungen laufen (Tag 1, 4, 11)."$@"liefert jedes Argument einzeln,"$*"alle als einen Text (Tag 2).- Die Ausgabe zerfällt an Leerzeichen und Zeilenumbrüchen. Sicher:
find … -print0mitwhile IFS= read -r -d ''oderxargs -0, oderfind -exec … {} +(Tag 9). - Die Schleife läuft hinter einer Pipe in einer Unter-Shell. Abhilfe:
done < <(befehl)(Tag 3, 12). - jq schützt Anführungszeichen, Backslashes und Steuerzeichen im Text;
printfbaut bei"ungültiges JSON (Tag 2, 8). exec 9> lock; flock -n 9– die Sperre endet automatisch mit dem Prozess, auch nach einem Absturz. Eine PID-Datei bleibt liegen (Tag 10).- Bash führt Traps erst aus, wenn der laufende Befehl fertig ist.
sleep 600 & wait $!lässtwaitvom Signal unterbrechen (Tag 12). - Anderer
PATH, keine Variablen ausenv.sh,/bin/shstatt Bash, kein Terminal, Ausgaben per Mail statt auf dem Bildschirm (Tag 13). - Die Zeile wird zweimal gelesen: von deiner Shell und von der Shell
auf dem Host.
printf '%q'oder ein Skript überbash -slösen das (Tag 14). type -a notes-check(Tag 0, 15).
Wie geht es weiter?
- Docker Compose zum Anfassen: der notes-Stack, den deine Skripte betreut haben, von Grund auf.
- Container-Tools zum Anfassen: ShellCheck und hadolint in der Image-Pipeline.
- Kubernetes zum Anfassen: Wo Skripte als Jobs und CronJobs im Cluster laufen.
- Weiter mit Bash: Das Bash-Handbuch
(
man bash) ist lang, aber vollständig. Für größere Werkzeuge lohnt ein Blick auf Python – wenn ein Skript mehr als ein paar hundert Zeilen braucht, ist es meist Zeit dafür.