Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 2: Variablen, Quoting, Parameter-Expansion

Ziel: Variablen setzen und weitergeben, verstehen, was die Shell mit einer Zeile macht, bevor ein Befehl startet, richtig quoten und mit Parameter-Expansion Texte zerlegen. Am Ende legt notes-add Notizen an. · Dauer: ca. 75 min · Voraussetzung: Tag 1

Briefing

  • name=wert setzt eine Variable – ohne Leerzeichen um =. $name oder ${name} liest sie. export gibt sie an gestartete Programme weiter.
  • Vor jedem Befehl zerlegt die Shell die Zeile: Sie ersetzt Variablen, teilt das Ergebnis an Leerzeichen in Wörter (Word Splitting) und setzt Dateinamen für * ein (Globbing). Doppelte Anführungszeichen verhindern beides.
  • Parameter-Expansion (${…}) kann mehr als lesen: Standardwerte, Länge, Teile abschneiden, ersetzen.
  • Faustregel: Jede Variable in doppelte Anführungszeichen, außer du willst ausdrücklich Splitting oder Globbing.
 Zeile ─► Variablen ersetzen ─► Word Splitting ─► Globbing ─► Befehl startet
            "$x" schützt vor beidem ──┘               └── '…' ersetzt gar nichts

Drill 1: Variablen und export

source ~/sh-lab/setup/env.sh
mkdir -p ~/sh-lab/tag02 && cd ~/sh-lab/tag02
titel="Meine Notiz"
echo "$titel"
titel = "falsch" 2>&1 | head -1
bash -c 'echo "Kind sieht: ${titel:-nichts}"'
export titel
bash -c 'echo "Kind sieht: ${titel:-nichts}"'
FARBE=blau bash -c 'echo "nur für diesen Aufruf: $FARBE"'; echo "danach: ${FARBE:-leer}"

Erwartet:

Meine Notiz
titel: command not found
Kind sieht: nichts
Kind sieht: Meine Notiz
nur für diesen Aufruf: blau
danach: leer
  • titel = "falsch" startet den Befehl titel mit den Argumenten = und falsch.
  • Eine Variable ohne export lebt nur in deiner Shell. Skripte und Programme, die du startest, sehen sie nicht – deshalb setzt env.sh alles mit export.
  • ${titel:-nichts} liefert nichts, wenn titel leer oder nicht gesetzt ist.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Word Splitting und Globbing

Ein kleines Hilfsskript zeigt, welche Argumente ein Befehl wirklich bekommt:

cat > ~/sh-lab/werkzeug/bin/args <<'EOF'
#!/usr/bin/env bash
# args – zeigt jedes Argument in eckigen Klammern
set -euo pipefail
echo "$# Argumente:"
for a in "$@"; do printf '  [%s]\n' "$a"; done
EOF
chmod +x ~/sh-lab/werkzeug/bin/args
text="zwei   Wörter"
args $text
args "$text"
args '$text'

Erwartet:

2 Argumente:
  [zwei]
  [Wörter]
1 Argumente:
  [zwei   Wörter]
1 Argumente:
  [$text]

Ohne Anführungszeichen teilt die Shell den Inhalt an Leerzeichen – und die drei Leerzeichen sind weg. Doppelte Anführungszeichen erhalten den Wert, einfache verhindern sogar das Ersetzen. Und Globbing:

touch a.txt b.txt
stern="*.txt"
args $stern
args "$stern"
leer="*.gibtsnicht"
args $leer

Erwartet:

2 Argumente:
  [a.txt]
  [b.txt]
1 Argumente:
  [*.txt]
1 Argumente:
  [*.gibtsnicht]

Passt ein Muster auf keine Datei, bleibt es stehen, wie es ist. Ein Skript, das rm $muster aufruft, bekäme dann einen Dateinamen mit Stern.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Die Argumente eines Skripts

cat > zeige <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
echo "Skript: $0, Anzahl: $#, erstes: ${1:-}"
echo "--- \$@ in Anführungszeichen:"; args "$@"
echo "--- \$* in Anführungszeichen:"; args "$*"
EOF
bash zeige "erste Notiz" zweite

Erwartet:

Skript: zeige, Anzahl: 2, erstes: erste Notiz
--- $@ in Anführungszeichen:
2 Argumente:
  [erste Notiz]
  [zweite]
--- $* in Anführungszeichen:
1 Argumente:
  [erste Notiz zweite]
Ausdruck Bedeutung
$0 Name des Skripts
$1 … $9, ${10} einzelne Argumente
$# Anzahl
"$@" alle Argumente, jedes für sich – fast immer die richtige Wahl
"$*" alle Argumente als ein Text, getrennt durch Leerzeichen

${1:-} statt $1: Mit set -u bricht das Skript sonst ab, wenn kein Argument da ist.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Parameter-Expansion

url="http://127.0.0.1:8080/notes?limit=5"
datei="/var/backups/notes-2026-11-02.sql.gz"
echo "Länge:        ${#url}"
echo "ohne Schema:  ${url#*://}"
echo "nur Pfad:     /${url#*://*/}"
echo "ohne Query:   ${url%%\?*}"
echo "Dateiname:    ${datei##*/}"
echo "Ordner:       ${datei%/*}"
echo "ohne .gz:     ${datei%.gz}"
echo "Stamm:        $(basename "${datei%%.*}")"
echo "ersetzt:      ${datei//-/_}"
echo "groß:         ${USER^^}"
echo "Teilstück:    ${datei:13:5}"

Erwartet:

Länge:        35
ohne Schema:  127.0.0.1:8080/notes?limit=5
nur Pfad:     /notes?limit=5
ohne Query:   http://127.0.0.1:8080/notes
Dateiname:    notes-2026-11-02.sql.gz
Ordner:       /var/backups
ohne .gz:     /var/backups/notes-2026-11-02.sql
Stamm:        notes-2026-11-02
ersetzt:      /var/backups/notes_2026_11_02.sql.gz
groß:         UBUNTU
Teilstück:    notes

Merkhilfe: # steht auf der Tastatur links von % – # schneidet vorne ab, % hinten. Einfach (#, %) nimmt das kürzeste passende Stück, doppelt (##, %%) das längste. Das alles läuft in der Shell selbst, ohne ein Programm wie sed zu starten.

POSIX: ${#x}, ${x#…}, ${x%…} und ${x:-…} sind portabel. Ersetzen (${x//a/b}), Groß-/Kleinschreibung (${x^^}) und Teilstücke (${x:13:5}) sind Bash-Erweiterungen.

Fortschritt speichern? Kostenlos registrieren

Drill 5: notes-add

cat > ~/sh-lab/werkzeug/bin/notes-add <<'EOF'
#!/usr/bin/env bash
# notes-add – legt eine Notiz an: notes-add Text der Notiz
set -euo pipefail
text="$*"
curl -fsS -X POST -H "X-API-Key: $NOTES_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"text\":\"$text\"}" "$NOTES_URL/notes"
echo
EOF
chmod +x ~/sh-lab/werkzeug/bin/notes-add
shellcheck ~/sh-lab/werkzeug/bin/notes-add && echo sauber
notes-add Einkaufen:   Milch und  Brot
notes-add "Einkaufen:   Milch und  Brot"
notes-add 'Er sagte "hallo"'; echo "Exit: $?"

Erwartet:

sauber
{"id":"…","text":"Einkaufen: Milch und Brot"}
{"id":"…","text":"Einkaufen:   Milch und  Brot"}
curl: (22) The requested URL returned error: 400
Exit: 22
  • Ohne Anführungszeichen beim Aufruf zerlegt deine Shell den Text in Wörter, und $* setzt sie mit je einem Leerzeichen wieder zusammen.
  • Das " im Text beendet die JSON-Zeichenkette zu früh, notes-api lehnt die Anfrage ab. Text in JSON einzubauen ist Arbeit für ein Werkzeug, das JSON versteht – jq an Tag 8.
  • Innerhalb doppelter Anführungszeichen schützt \" ein Anführungszeichen.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

notes-add "Kontrollpunkt Tag 2" | grep -o '"text":"[^"]*"'

Erwartet:

"text":"Kontrollpunkt Tag 2"
args "a b" c

Erwartet:

2 Argumente:
  [a b]
  [c]
f=/tmp/bericht.final.txt; echo "${f##*/} ${f%.txt} ${f%%.*}"

Erwartet:

bericht.final.txt /tmp/bericht.final /tmp/bericht

Challenge

notes-add soll ohne env.sh funktionieren, wenn notes unter der Standardadresse http://127.0.0.1:8080 läuft. Fehlt aber der API-Key, soll es mit einer klaren Meldung abbrechen, bevor curl startet.

Hinweis: ${VAR:-standard} und ${VAR:?meldung}.

Lösung

cat > ~/sh-lab/werkzeug/bin/notes-add <<'EOF'
#!/usr/bin/env bash
# notes-add – legt eine Notiz an: notes-add Text der Notiz
set -euo pipefail
url="${NOTES_URL:-http://127.0.0.1:8080}"
key="${NOTES_API_KEY:?fehlt – source ~/sh-lab/setup/env.sh}"
text="$*"
curl -fsS -X POST -H "X-API-Key: $key" -H 'Content-Type: application/json' \
  -d "{\"text\":\"$text\"}" "$url/notes"
echo
EOF
shellcheck ~/sh-lab/werkzeug/bin/notes-add && echo sauber
env -u NOTES_URL notes-add "ohne env.sh-URL" | grep -c '"id"'
env -u NOTES_API_KEY notes-add test; echo "Exit: $?"

Erwartet:

sauber
1
/home/ubuntu/sh-lab/werkzeug/bin/notes-add: line 5: NOTES_API_KEY: fehlt – source …
Exit: 1

env -u NAME startet einen Befehl ohne diese Variable – ideal, um so etwas zu testen. Die Meldung nennt Skript, Zeile und Variable; den Rest bestimmst du.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Konfiguration über Umgebungsvariablen mit Standardwerten (${X:-…}) und Pflichtwerten (${X:?…}) ist der übliche Weg – genau wie bei Containern.
  • Secrets nicht als Argument: Was in der Befehlszeile steht, sieht jeder Benutzer mit ps. Schlüssel kommen aus Variablen oder Dateien, nie als --key geheim.
  • Dateinamen mit Leerzeichen gibt es immer, spätestens auf einem Netzlaufwerk. Skripte, die nur ohne funktionieren, sind kaputt, nicht die Dateinamen.