Tag 1: Das erste Skript
Ziel: Ein Skript anlegen, ausführbar machen und aus dem
PATHstarten, Exit-Codes verstehen, mitset -euo pipefailFehler nicht übersehen und ShellCheck von Anfang an benutzen. · Dauer: ca. 60 min · Voraussetzung: Tag 0
Briefing
- Ein Skript ist eine Textdatei mit Befehlen. Die erste Zeile, der
Shebang (
#!/usr/bin/env bash), sagt dem System, welches Programm sie ausführt. - Jeder Befehl endet mit einem Exit-Code:
0heißt Erfolg, alles andere Fehler.$?enthält den Code des letzten Befehls.&&und||verknüpfen Befehle danach. - Ohne Vorkehrung läuft ein Skript nach einem Fehler einfach weiter.
set -euo pipefailändert das. - ShellCheck liest ein Skript und findet typische Fehler, bevor sie passieren.
notes-ping ─► curl /healthz ─► Exit-Code 0 (ok) oder ≠ 0 (Fehler)
└─► $? · && · || · set -e
Drill 1: Hallo, Skript
source ~/sh-lab/setup/env.sh
mkdir -p ~/sh-lab/tag01 && cd ~/sh-lab/werkzeug/bin
cat > hallo <<'EOF'
#!/usr/bin/env bash
# hallo – das erste Skript im Werkzeugkasten
echo "Hallo, $USER! Heute ist $(date +%A)."
EOF
ls -l hallo | cut -c1-10
chmod +x hallo
ls -l hallo | cut -c1-10
halloErwartet:
-rw-rw-r--
-rwxrwxr-x
Hallo, ubuntu! Heute ist Monday.
cat > hallo <<'EOF' … EOFist ein Here-Document: Alles bis zur ZeileEOFlandet in der Datei. Die Anführungszeichen um'EOF'verhindern, dass die Shell$USERschon beim Schreiben ersetzt.chmod +xmacht die Datei ausführbar. Weilbin/imPATHsteht, reichthallo.$(date +%A)ist Command Substitution: Die Ausgabe vondatewird Teil des Textes.#!/usr/bin/env bashsuchtbashimPATHstatt einen festen Pfad anzunehmen.
bash ~/sh-lab/werkzeug/bin/hallo
bash -c '[[ 1 -eq 1 ]] && echo "bash kann [["'
sh -c '[[ 1 -eq 1 ]] && echo "sh kann [["'Erwartet:
Hallo, ubuntu! Heute ist Monday.
bash kann [[
sh: 1: [[: not found
Mit bash datei startest du ein Skript auch ohne
chmod +x – dann ist der Shebang egal. Mit
sh datei liefe es in dash, und dash kennt viele
Bash-Erweiterungen wie [[ ]] nicht.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Exit-Codes
true; echo "true: $?"
false; echo "false: $?"
ls /gibtsnicht 2>/dev/null; echo "ls: $?"
gibtsnicht 2>/dev/null; echo "unbekannt: $?"
curl -fsS --max-time 3 $NOTES_URL/gibtsnicht >/dev/null 2>&1; echo "curl 404: $?"Erwartet:
true: 0
false: 1
ls: 2
unbekannt: 127
curl 404: 22
Jedes Programm hat eigene Codes: ls meldet 2 für „nicht
gefunden”, die Shell 127 für einen unbekannten Befehl,
curl -f 22 für einen HTTP-Fehler. man curl
listet alle.
true && echo "lief, weil true klappte"
false && echo "das erscheint nie"
false || echo "lief, weil false scheiterte"Erwartet:
lief, weil true klappte
lief, weil false scheiterte
Fortschritt speichern? Kostenlos registrieren
Drill 3: notes-ping
Das erste echte Werkzeug: Antwortet notes?
cd ~/sh-lab/werkzeug/bin
cat > notes-ping <<'EOF'
#!/usr/bin/env bash
# notes-ping – prüft, ob notes antwortet. Exit-Code 0 = ok
curl -fsS --max-time 3 "$NOTES_URL/healthz" >/dev/null
EOF
chmod +x notes-ping
notes-ping; echo "Exit: $?"
docker compose -f ~/sh-lab/notes/compose.yaml stop proxy 2>&1 | tail -1
notes-ping; echo "Exit: $?"
docker compose -f ~/sh-lab/notes/compose.yaml start proxy 2>&1 | tail -1
until notes-ping 2>/dev/null; do sleep 1; done; echo "wieder da"Erwartet:
Exit: 0
Container notes-proxy-1 Stopped
curl: (7) Failed to connect to 127.0.0.1 port 8080 after 0 ms: Could not connect …
Exit: 7
Container notes-proxy-1 Started
wieder da
Ein Skript endet mit dem Exit-Code seines letzten Befehls – hier dem
von curl. Ohne eine einzige Zeile Fehlerbehandlung ist
notes-ping schon brauchbar: in until, in
&&-Ketten, später in cron. -f macht
HTTP-Fehler zu Exit-Codes, -sS schweigt außer bei
Fehlern.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Strenger Modus
cd ~/sh-lab/tag01
cat > locker <<'EOF'
#!/usr/bin/env bash
cp /gibtsnicht /tmp/kopie
echo "kopiert nach ${ZIEL}/kopie"
grep -c notiz /gibtsnicht | sort
echo "Ende erreicht"
EOF
bash locker; echo "Exit: $?"Erwartet:
cp: cannot stat '/gibtsnicht': No such file or directory
kopiert nach /kopie
grep: /gibtsnicht: No such file or directory
Ende erreicht
Exit: 0
Drei Fehler – und das Skript meldet Erfolg. Jetzt dieselben Zeilen mit dem strengen Modus:
sed '1a set -euo pipefail' locker > streng
head -2 streng
bash streng; echo "Exit: $?"Erwartet:
#!/usr/bin/env bash
set -euo pipefail
cp: cannot stat '/gibtsnicht': No such file or directory
Exit: 1
| Option | Wirkung |
|---|---|
-e |
Abbruch, sobald ein Befehl scheitert |
-u |
Abbruch bei einer nicht gesetzten Variable wie
$ZIEL |
-o pipefail |
Eine Pipe scheitert, wenn ein Teil scheitert – nicht nur der letzte |
Probier die beiden anderen Fehler einzeln:
bash -euc 'echo "${ZIEL}/kopie"'; echo "Exit: $?"
bash -ec 'grep -c x /gibtsnicht 2>/dev/null | sort; echo weiter'; echo "Exit: $?"
bash -ec 'set -o pipefail; grep -c x /gibtsnicht 2>/dev/null | sort; echo weiter'
echo "Exit: $?"Erwartet:
bash: line 1: ZIEL: unbound variable
Exit: 1
weiter
Exit: 0
Exit: 2
Ohne pipefail zählt nur sort – und das
klappt immer. Ab jetzt beginnt jedes Skript in diesem Buch mit
set -euo pipefail.
POSIX:
set -eundset -ugibt es überall,pipefailist seit POSIX 2024 Standard; älteresh(auch dash vor 0.5.13) kennen es nicht.
Fortschritt speichern? Kostenlos registrieren
Drill 5: ShellCheck
cat > aufraeumen <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
dir=$1
cd $dir
rm -f *.tmp
echo Fertig in $dir
EOF
shellcheck aufraeumenErwartet (gekürzt):
In aufraeumen line 4:
cd $dir
^--^ SC2086 (info): Double quote to prevent globbing and word splitting.
Did you mean:
cd "$dir"
In aufraeumen line 5:
rm -f *.tmp
^-- SC2035 (info): Use ./*glob* or -- *glob* so names with dashes won't …
In aufraeumen line 6:
echo Fertig in $dir
^--^ SC2086 (info): Double quote to prevent globbing and word …
…
- SC2086:
$dirohne Anführungszeichen. Heißt der Ordnermeine daten, macht die Shell daraus zwei Wörter. Das ist der häufigste Fehler in Shell-Skripten (Tag 2). - SC2035: Hieße eine Datei
-rf.tmp, hieltermsie für eine Option../*.tmpmacht daraus einen Pfad. - Ohne
set -ekäme noch SC2164 dazu: Scheitertcd, liefermim falschen Ordner. ShellCheck sieht, dass der strenge Modus das schon abfängt.
Jede Meldung hat eine Seite unter
shellcheck.net/wiki/SCxxxx. Die korrigierte Fassung:
cat > aufraeumen <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
dir=$1
cd "$dir" || exit 1
rm -f ./*.tmp
echo "Fertig in $dir"
EOF
shellcheck aufraeumen && echo "ShellCheck: sauber"
mkdir -p "/tmp/meine daten" && touch "/tmp/meine daten/a.tmp" "/tmp/meine daten/b.txt"
bash aufraeumen "/tmp/meine daten" && ls "/tmp/meine daten"Erwartet:
ShellCheck: sauber
Fertig in /tmp/meine daten
b.txt
cd … || exit 1 schadet trotzdem nicht: Es macht die
Absicht sichtbar, auch für Leser, die set -e übersehen.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
notes-ping && echo "notes antwortet"Erwartet:
notes antwortet
shellcheck ~/sh-lab/werkzeug/bin/* && echo "alles sauber"Erwartet:
alles sauber
head -1 ~/sh-lab/werkzeug/bin/notes-pingErwartet:
#!/usr/bin/env bash
Challenge
notes-ping soll mit dem strengen Modus laufen und etwas
sagen: notes ok auf stdout, bei einem Fehler
notes nicht erreichbar: <URL> auf
stderr und Exit-Code 1.
Hinweis: >&2 leitet eine Ausgabe
auf stderr. Eine Gruppe { …; …; } fasst mehrere Befehle
hinter || zusammen.
Lösung
cd ~/sh-lab/werkzeug/bin
cat > notes-ping <<'EOF'
#!/usr/bin/env bash
# notes-ping – prüft, ob notes antwortet. Exit-Code 0 = ok
set -euo pipefail
curl -fsS --max-time 3 "$NOTES_URL/healthz" >/dev/null 2>&1 \
|| { echo "notes nicht erreichbar: $NOTES_URL" >&2; exit 1; }
echo "notes ok"
EOF
shellcheck notes-ping && notes-ping
NOTES_URL=http://127.0.0.1:9 notes-ping 2>/dev/null; echo "Exit: $?"
NOTES_URL=http://127.0.0.1:9 notes-ping >/dev/nullErwartet:
notes ok
Exit: 1
notes nicht erreichbar: http://127.0.0.1:9
VAR=wert befehl setzt eine Variable nur für diesen einen
Aufruf. Die zweite Zeile verwirft stderr und zeigt nur den Exit-Code,
die dritte verwirft stdout – übrig bleibt die Fehlermeldung.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Exit-Codes sind die Schnittstelle: Monitoring, cron, CI und Kubernetes-Probes werten nur sie aus. Ein Skript, das bei Fehlern 0 liefert, ist gefährlicher als gar keins.
- Fehler auf stderr: Nur dann lassen sich Ausgabe und
Diagnose trennen, etwa
skript > daten.txt 2>> fehler.log. - ShellCheck in der CI: Ein Pull Request mit
ShellCheck-Warnungen kommt nicht durch (Tag 11). Ausnahmen werden im
Code begründet:
# shellcheck disable=SC2086 # weil ….