Tag 5: Arrays und Optionen
Ziel: Listen in Arrays halten, mit assoziativen Arrays zählen, Ausgaben mit
mapfileeinlesen und Optionen mitgetoptsauswerten. Am Ende prüftnotes-checkmehrere Endpunkte mit Optionen und Hilfe-Text. · Dauer: ca. 75 min · Voraussetzung: Tag 4
Briefing
- Ein Array hält eine Liste von Werten, jeder bleibt
für sich – auch mit Leerzeichen.
"${liste[@]}"liefert alle Elemente,${#liste[@]}ihre Anzahl. - Ein assoziatives Array (
declare -A) bildet Schlüssel auf Werte ab: ideal zum Zählen. mapfile -tliest die Zeilen einer Ausgabe in ein Array.getoptswertet kurze Optionen wie-u url -t 3 -vaus. Was danach übrig bleibt, sind die eigentlichen Argumente.
notes-check -t 2 -v /healthz /notes ─► getopts: timeout=2, verbose=1
└─► Array endpunkte=(/healthz /notes)
└─► declare -A ergebnis[ok|fehler]++
Drill 1: Arrays
source ~/sh-lab/setup/env.sh
mkdir -p ~/sh-lab/tag05 && cd ~/sh-lab/tag05
dienste=(db notes-api "nginx proxy")
dienste+=(backup)
echo "Anzahl: ${#dienste[@]}"
echo "erstes: ${dienste[0]}, letztes: ${dienste[-1]}"
for d in "${dienste[@]}"; do printf '[%s] ' "$d"; done; echo
for d in ${dienste[@]}; do printf '[%s] ' "$d"; done; echo
echo "Teil: ${dienste[*]:1:2}"
unset 'dienste[1]'
echo "nach unset: ${dienste[*]} – Indizes: ${!dienste[*]}"Erwartet:
Anzahl: 4
erstes: db, letztes: backup
[db] [notes-api] [nginx proxy] [backup]
[db] [notes-api] [nginx] [proxy] [backup]
Teil: notes-api nginx proxy
nach unset: db nginx proxy backup – Indizes: 0 2 3
Wieder dieselbe Lektion wie an Tag 2: ohne Anführungszeichen zerfällt
nginx proxy in zwei Wörter. "${liste[@]}" ist
für Arrays, was "$@" für Argumente ist. Nach
unset hat das Array eine Lücke – die Indizes werden nicht
neu nummeriert.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Zählen mit assoziativen Arrays
codes=(200 200 404 201 200 503 404 200)
declare -A anzahl
for c in "${codes[@]}"; do
anzahl[$c]=$((${anzahl[$c]:-0} + 1))
done
for c in "${!anzahl[@]}"; do echo "$c ${anzahl[$c]}"; done | sort
echo "Gibt es 500? ${anzahl[500]:-nein}"
[[ -v anzahl[404] ]] && echo "404 kam vor"Erwartet:
200 4
201 1
404 2
503 1
Gibt es 500? nein
404 kam vor
${!anzahl[@]}liefert die Schlüssel. Ihre Reihenfolge ist zufällig – deshalbsort.${anzahl[$c]:-0}liefert 0 für einen Schlüssel, den es noch nicht gibt, und hältset -uruhig.[[ -v name[schlüssel] ]]prüft, ob es einen Eintrag gibt.
POSIX:
shkennt keine Arrays. Das einzige Array dort sind die Argumente, gesetzt mitset -- a b c.
Fortschritt speichern? Kostenlos registrieren
Drill 3: mapfile
mapfile -t container < <(docker ps --format '{{.Names}}' | sort)
echo "${#container[@]} Container: ${container[*]}"
mapfile -t -n 2 zeilen < /etc/os-release
printf '%s\n' "${zeilen[@]}"Erwartet:
3 Container: notes-db-1 notes-notes-api-1 notes-proxy-1
PRETTY_NAME="Ubuntu 26.04.1 LTS"
NAME="Ubuntu"
-t entfernt das Zeilenende, -n 2 liest
höchstens zwei Zeilen. Vorher hätte man dafür eine
while read-Schleife gebraucht.
Fortschritt speichern? Kostenlos registrieren
Drill 4: notes-check mit getopts
cat > ~/sh-lab/werkzeug/bin/notes-check <<'EOF'
#!/usr/bin/env bash
# notes-check – prüft Endpunkte von notes
set -euo pipefail
source "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")/../lib/lib.sh"
usage() {
cat <<HILFE
Aufruf: $PROG [-u url] [-t sekunden] [-v] [endpunkt…]
-u url Adresse von notes (Standard: \$NOTES_URL)
-t sekunden Zeitlimit je Anfrage (Standard: 3)
-v jeden Endpunkt einzeln melden
-h diese Hilfe
Ohne Endpunkte: /healthz /notes /version
Exit-Code: 0 alle ok, 1 mindestens einer gescheitert, 2 falsche Bedienung
HILFE
}
url="$(notes_url)"
timeout=3
verbose=0
while getopts ":u:t:vh" opt; do
case "$opt" in
u) url="$OPTARG" ;;
t) timeout="$OPTARG" ;;
v) verbose=1 ;;
h) usage; exit 0 ;;
:) die "Option -$OPTARG braucht einen Wert" 2 ;;
*) die "unbekannte Option -$OPTARG (Hilfe: -h)" 2 ;;
esac
done
shift $((OPTIND - 1))
need curl
endpunkte=("$@")
((${#endpunkte[@]} > 0)) || endpunkte=(/healthz /notes /version)
declare -A ergebnis=([ok]=0 [fehler]=0)
for e in "${endpunkte[@]}"; do
code=$(curl -s -o /dev/null -w '%{http_code}' --max-time "$timeout" "$url$e") || true
if [[ $code == 2?? ]]; then
ergebnis[ok]=$((ergebnis[ok] + 1))
else
ergebnis[fehler]=$((ergebnis[fehler] + 1))
fi
((verbose)) && echo "$code $e"
done
echo "${ergebnis[ok]} ok, ${ergebnis[fehler]} Fehler"
((ergebnis[fehler] == 0))
EOF
chmod +x ~/sh-lab/werkzeug/bin/notes-check
shellcheck -x ~/sh-lab/werkzeug/bin/notes-check && echo sauber
notes-check
notes-check -v /healthz /admin; echo "Exit: $?"
notes-check -x; echo "Exit: $?"
notes-check -t; echo "Exit: $?"
notes-check -h | head -2Erwartet:
sauber
3 ok, 0 Fehler
200 /healthz
404 /admin
1 ok, 1 Fehler
Exit: 1
12:30:02 notes-check: FEHLER unbekannte Option -x (Hilfe: -h)
Exit: 2
12:30:02 notes-check: FEHLER Option -t braucht einen Wert
Exit: 2
Aufruf: notes-check [-u url] [-t sekunden] [-v] [endpunkt…]
-u url Adresse von notes (Standard: $NOTES_URL)
- Im
optstring":u:t:vh"heißt ein:hinter dem Buchstaben „braucht einen Wert”, der:ganz vorne „Fehler selbst behandeln”: dann landet?(unbekannt) oder:(Wert fehlt) inopt, der Buchstabe inOPTARG. shift $((OPTIND - 1))entfernt die verarbeiteten Optionen;"$@"sind danach nur noch die Endpunkte.|| truehintercurl: Ein nicht erreichbarer Server soll gezählt werden, nicht das Skript beenden.- Die letzte Zeile
((ergebnis[fehler] == 0))ist der Exit-Code des Skripts. - Im Hilfetext ersetzt das Here-Document ohne
'…'Variablen wie$PROG.\$lässt ein$stehen.
POSIX:
getoptsgibt es in jedersh. Lange Optionen wie--timeoutkennt es nicht; die wertest du selbst mitcase "$1" in --timeout) …undshiftaus.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Arrays für Befehle
Ein Befehl mit Optionen, die je nach Lage dazukommen, gehört in ein Array – nicht in einen Text:
cat > curlopts <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
opts=(-s -o /dev/null -w '%{http_code} %{time_total}s\n')
[[ ${LANGSAM:-0} == 1 ]] && opts+=(--limit-rate 1k)
opts+=(-A "notes check")
curl "${opts[@]}" "$NOTES_URL/healthz"
printf '%q ' curl "${opts[@]}"; echo
EOF
bash curloptsErwartet:
200 0.001234s
curl -s -o /dev/null -w %\{http_code\}\ %\{time_total\}s\\n -A notes\ check
printf '%q' zeigt jedes Wort so, wie man es in die Shell
tippen müsste: Der User-Agent notes check ist
ein Argument geblieben. In einer Textvariable
opts="-A notes check" wäre er beim Aufruf zerfallen.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
notes-check -v -t 1 /healthz /notesErwartet:
200 /healthz
200 /notes
2 ok, 0 Fehler
notes-check -u http://127.0.0.1:9 >/dev/null; echo "Exit: $?"Erwartet:
Exit: 1
bash -c 'declare -A a=([x]=1); a[y]=2; echo "${#a[@]}"'Erwartet:
2
Challenge
notes-check soll eine Option -q bekommen:
keine Ausgabe, nur der Exit-Code – für cron und
until-Schleifen.
Hinweis: Drei Stellen: optstring,
case und die Ausgabe am Ende.
Lösung
cd ~/sh-lab/werkzeug/bin
f=notes-check
sed -i 's/":u:t:vh"/":u:t:vqh"/' $f
sed -i 's/^ v) verbose=1 ;;$/&\n q) quiet=1 ;;/' $f
sed -i 's/^verbose=0$/&\nquiet=0/' $f
sed -i 's/^echo "\${ergebnis\[ok\]} ok/((quiet)) || &/' $f
sed -i 's/^ -v .*$/&\n -q keine Ausgabe, nur Exit-Code/' $f
grep -n -E 'quiet|-q ' notes-check
shellcheck -x notes-check && notes-check -q; echo "Exit: $?"
notes-check -q /admin; echo "Exit: $?"Erwartet:
12: -q keine Ausgabe, nur Exit-Code
22:quiet=0
28: q) quiet=1 ;;
50:((quiet)) || echo "${ergebnis[ok]} ok, ${ergebnis[fehler]} Fehler"
Exit: 0
Exit: 1
sed -i ändert die Datei an Ort und Stelle;
& steht im Ersatz für den gefundenen Text. Im Editor
geht es genauso – sed lernst du an Tag 7 richtig
kennen.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Jedes Werkzeug hat
-h. Ein Skript ohne Hilfe wird nach drei Monaten nicht mehr benutzt – oder falsch. - Befehle in Arrays bauen, nie in Textvariablen mit
eval.evalführt alles aus, was in der Variable steht, auch eingeschleuste Befehle. - Bash-Version prüfen: Assoziative Arrays gibt es ab
Bash 4. macOS bringt noch Bash 3.2 mit; ein Skript für Macs prüft
BASH_VERSINFOoder nennt Homebrew-Bash.