Zum Inhalt springen
Trainingslager IT-Trainingslager

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, laden lib.sh und bestehen ci.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-count

Fortschritt 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 -l

Erwartet:

   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-langsam

substr($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-check

Fortschritt 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 -1

Erwartet:

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 -l

Erwartet:

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

  1. Warum beginnt jedes Skript in diesem Buch mit set -euo pipefail, und welche Fälle fängt es trotzdem nicht ab?
  2. Was ist der Unterschied zwischen "$@" und "$*"?
  3. Warum ist for f in $(find …) gefährlich, und was ist die sichere Form?
  4. Warum geht eine Variable verloren, die du in befehl | while read …; do …; done setzt?
  5. Warum baut man JSON mit jq -n --arg statt mit printf?
  6. Wie sorgt ein Skript dafür, dass es nie zweimal gleichzeitig läuft, und warum ist das besser als eine PID-Datei?
  7. Warum reagiert ein Skript in sleep 600 erst nach zehn Minuten auf TERM, und wie ändert man das?
  8. Nenne drei Unterschiede zwischen einem Skript in deinem Terminal und demselben Skript in cron.
  9. Warum braucht ssh host "befehl $x" oft zwei Lagen Quoting?
  10. Woran erkennst du mit einem Befehl, ob notes-check eine Datei, eine Funktion oder ein Alias ist?

Antworten

  1. -e bricht bei Fehlern ab, -u bei nicht gesetzten Variablen, pipefail macht Fehler in Pipes sichtbar. Nicht erfasst: Befehle in if, &&/||, $(…) in local x=$(…) und Funktionen, die in solchen Bedingungen laufen (Tag 1, 4, 11).
  2. "$@" liefert jedes Argument einzeln, "$*" alle als einen Text (Tag 2).
  3. Die Ausgabe zerfällt an Leerzeichen und Zeilenumbrüchen. Sicher: find … -print0 mit while IFS= read -r -d '' oder xargs -0, oder find -exec … {} + (Tag 9).
  4. Die Schleife läuft hinter einer Pipe in einer Unter-Shell. Abhilfe: done < <(befehl) (Tag 3, 12).
  5. jq schützt Anführungszeichen, Backslashes und Steuerzeichen im Text; printf baut bei " ungültiges JSON (Tag 2, 8).
  6. exec 9> lock; flock -n 9 – die Sperre endet automatisch mit dem Prozess, auch nach einem Absturz. Eine PID-Datei bleibt liegen (Tag 10).
  7. Bash führt Traps erst aus, wenn der laufende Befehl fertig ist. sleep 600 & wait $! lässt wait vom Signal unterbrechen (Tag 12).
  8. Anderer PATH, keine Variablen aus env.sh, /bin/sh statt Bash, kein Terminal, Ausgaben per Mail statt auf dem Bildschirm (Tag 13).
  9. Die Zeile wird zweimal gelesen: von deiner Shell und von der Shell auf dem Host. printf '%q' oder ein Skript über bash -s lösen das (Tag 14).
  10. 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.