Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: Das erste Skript

Ziel: Ein Skript anlegen, ausführbar machen und aus dem PATH starten, Exit-Codes verstehen, mit set -euo pipefail Fehler 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: 0 heiß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
hallo

Erwartet:

-rw-rw-r--
-rwxrwxr-x
Hallo, ubuntu! Heute ist Monday.
  • cat > hallo <<'EOF' … EOF ist ein Here-Document: Alles bis zur Zeile EOF landet in der Datei. Die Anführungszeichen um 'EOF' verhindern, dass die Shell $USER schon beim Schreiben ersetzt.
  • chmod +x macht die Datei ausführbar. Weil bin/ im PATH steht, reicht hallo.
  • $(date +%A) ist Command Substitution: Die Ausgabe von date wird Teil des Textes.
  • #!/usr/bin/env bash sucht bash im PATH statt 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 -e und set -u gibt es überall, pipefail ist seit POSIX 2024 Standard; ältere sh (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 aufraeumen

Erwartet (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: $dir ohne Anführungszeichen. Heißt der Ordner meine 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, hielte rm sie für eine Option. ./*.tmp macht daraus einen Pfad.
  • Ohne set -e käme noch SC2164 dazu: Scheitert cd, liefe rm im 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-ping

Erwartet:

#!/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/null

Erwartet:

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 ….