Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 5: Arrays und Optionen

Ziel: Listen in Arrays halten, mit assoziativen Arrays zählen, Ausgaben mit mapfile einlesen und Optionen mit getopts auswerten. Am Ende prüft notes-check mehrere 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 -t liest die Zeilen einer Ausgabe in ein Array.
  • getopts wertet kurze Optionen wie -u url -t 3 -v aus. 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 – deshalb sort.
  • ${anzahl[$c]:-0} liefert 0 für einen Schlüssel, den es noch nicht gibt, und hält set -u ruhig.
  • [[ -v name[schlüssel] ]] prüft, ob es einen Eintrag gibt.

POSIX: sh kennt keine Arrays. Das einzige Array dort sind die Argumente, gesetzt mit set -- 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 -2

Erwartet:

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) in opt, der Buchstabe in OPTARG.
  • shift $((OPTIND - 1)) entfernt die verarbeiteten Optionen; "$@" sind danach nur noch die Endpunkte.
  • || true hinter curl: 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: getopts gibt es in jeder sh. Lange Optionen wie --timeout kennt es nicht; die wertest du selbst mit case "$1" in --timeout) … und shift aus.

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 curlopts

Erwartet:

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 /notes

Erwartet:

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. eval fü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_VERSINFO oder nennt Homebrew-Bash.