Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände

Ziel: Die Labor-VM anlegen, Docker und die Werkzeuge installieren, den Begleitcode holen, notes starten und den Werkzeugkasten vorbereiten. · Dauer: ca. 45 min · Voraussetzung: keine

Briefing

  • Gearbeitet wird in der Ubuntu-26.04-VM sh, als User ubuntu in ~/sh-lab.
  • notes ist die Anwendung, die deine Skripte betreuen: notes-api (Go) speichert Notizen in Postgres, davor steht nginx und schreibt jede Anfrage in ein Zugriffslog.
  • Dein Werkzeugkasten liegt in ~/sh-lab/werkzeug: bin/ für Skripte, lib/ für gemeinsame Funktionen, tests/ für Tests. env.sh setzt bin/ an den Anfang von PATH.
  • Werkzeuge: ShellCheck findet Fehler in Skripten, shfmt formatiert sie, bats testet sie, jq liest JSON.
 du ─ssh─► VM sh:  curl 127.0.0.1:8080 ─► nginx ─► notes-api ─► Postgres
                                         └─► ~/sh-lab/notes/logs/access.log
                   ~/sh-lab/werkzeug/{bin,lib,tests}

Drill 1: Die Labor-VM

Auf dem Laptop (Multipass von multipass.run):

multipass launch 26.04 --name sh --cpus 2 --memory 4G --disk 20G
multipass exec sh -- bash -c "echo '$(cat ~/.ssh/id_ed25519.pub)' \
  >> ~/.ssh/authorized_keys"
multipass info sh | grep IPv4
ssh ubuntu@<IP aus der Ausgabe>

Ab hier läuft alles in der VM:

bash --version | head -1
echo "$SHELL"
readlink -f /bin/sh

Erwartet:

GNU bash, version 5.3.9(1)-release (x86_64-pc-linux-gnu)
/bin/bash
/usr/bin/dash

Deine Login-Shell ist Bash. /bin/sh ist auf Ubuntu aber dash, eine kleine, streng POSIX-konforme Shell. Ein Skript, das mit #!/bin/sh beginnt, läuft also nicht in Bash – dazu mehr an Tag 1. Auf einem Mac mit Apple Silicon steht aarch64 statt x86_64.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Docker und Werkzeuge

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
https://download.docker.com/linux/ubuntu $(. /etc/os-release; echo $VERSION_CODENAME) \
stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
sudo apt-get update -qq
sudo apt-get install -y -qq docker-ce docker-ce-cli containerd.io \
  docker-compose-plugin jq git xz-utils >/dev/null
sudo usermod -aG docker ubuntu

ShellCheck und shfmt kommen als einzelne Programme von GitHub, bats per git:

case "$(uname -m)" in
  x86_64)  SC=x86_64;  SF=amd64 ;;
  aarch64) SC=aarch64; SF=arm64 ;;
esac
cd /tmp
U=https://github.com/koalaman/shellcheck/releases/download/v0.11.0
curl -fsSL $U/shellcheck-v0.11.0.linux.$SC.tar.xz | tar -xJ
sudo install -m 0755 shellcheck-v0.11.0/shellcheck /usr/local/bin/
sudo curl -fsSL -o /usr/local/bin/shfmt \
  https://github.com/mvdan/sh/releases/download/v3.14.1/shfmt_v3.14.1_linux_$SF
sudo chmod 0755 /usr/local/bin/shfmt
git clone -q --depth 1 --branch v1.14.0 https://github.com/bats-core/bats-core.git \
  /tmp/bats 2>/dev/null
sudo /tmp/bats/install.sh /usr/local >/dev/null

Melde dich ab (exit) und wieder an, damit die Gruppe docker gilt:

docker --version
docker compose version
shellcheck --version | sed -n 2p
shfmt --version
bats --version
jq --version

Erwartet:

Docker version 29.9.2, build a82e528
Docker Compose version v5.6.1
version: 0.11.0
v3.14.1
Bats 1.14.0
jq-1.8.1

Das case oben ist schon ein Stück Shell-Skript: Es wählt je nach Prozessor den passenden Dateinamen. An Tag 3 schreibst du solche Verzweigungen selbst.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Begleitcode und Umgebung

mkdir -p ~/sh-lab/setup
git clone -q https://github.com/thomaszachmann/shell-scripting-zum-anfassen.git \
  ~/sh-lab/code
cp ~/sh-lab/code/setup/env.sh ~/sh-lab/setup/
cat ~/sh-lab/setup/env.sh
source ~/sh-lab/setup/env.sh
echo "$PATH" | cut -d: -f1

Erwartet:

# setup/env.sh – zu Beginn jedes Trainingstags einlesen: source ~/sh-lab/setup/env.sh
export LAB="$HOME/sh-lab"
export NOTES_URL="http://127.0.0.1:8080"           # notes hinter nginx
export NOTES_API_KEY="lab-api-key-123"             # nur Labor
export NOTES_LOG="$LAB/notes/logs/access.log"      # Zugriffslog von nginx
case ":$PATH:" in
  *":$LAB/werkzeug/bin:"*) ;;
  *) export PATH="$LAB/werkzeug/bin:$PATH" ;;       # eigene Skripte zuerst
esac
true
/home/ubuntu/sh-lab/werkzeug/bin

source führt die Datei in deiner laufenden Shell aus – die Variablen bleiben danach gesetzt. Ein normaler Aufruf (bash env.sh) liefe in einer neuen Shell, und alles wäre danach wieder weg. Das case sorgt dafür, dass bin/ nicht bei jedem source noch einmal in PATH landet.

Fortschritt speichern? Kostenlos registrieren

Drill 4: notes starten

cd ~/sh-lab/code/notes/notes-api
docker build -q --build-arg VERSION=0.4.0 -t notes-api:0.4.0 . | cut -c1-19
cp -R ~/sh-lab/code/notes-stack ~/sh-lab/notes && cd ~/sh-lab/notes
docker compose up -d --wait 2>&1 | grep -E 'Healthy|Started' | tail -2
curl -s $NOTES_URL/healthz; echo
curl -s -X POST -H "X-API-Key: $NOTES_API_KEY" \
  -H 'Content-Type: application/json' -d '{"text":"erste Notiz"}' $NOTES_URL/notes
echo
tail -2 "$NOTES_LOG"

Erwartet (gekürzt, beim ersten Mal einige Minuten):

sha256:f453f6401d46
 Container notes-db-1 Healthy
 Container notes-notes-api-1 Healthy
ok
{"id":"…","text":"erste Notiz"}
172.19.0.1 [02/Nov/2026:11:56:21 +0000] "GET /healthz HTTP/1.1" 200 3 0.002 curl/8.18.0
172.19.0.1 [02/Nov/2026:11:56:21 +0000] "POST /notes HTTP/1.1" 201 67 0.009 curl/8.18.0

Jede Zeile im Log ist eine Anfrage: Absender, Zeit, Anfrage, Status, Bytes, Dauer in Sekunden und Programm. Ab Tag 6 wertest du genau diese Zeilen aus.

Achtung: Auf Ubuntu 26.04 blockiert das AppArmor-Profil docker-default den Postgres-Container. Deshalb steht in compose.yaml für db die Zeile apparmor=unconfined – nur im Labor.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Der Werkzeugkasten

mkdir -p ~/sh-lab/werkzeug/{bin,lib,tests}
ls ~/sh-lab/werkzeug
type -a ls cd

Erwartet:

bin
lib
tests
ls is aliased to `ls --color=auto'
ls is /usr/bin/ls
ls is /bin/ls
cd is a shell builtin
  • {bin,lib,tests} ist Brace Expansion: Bash macht daraus drei Wörter, bevor mkdir startet.
  • type -a zeigt, was hinter einem Namen steckt: ein Alias, ein Programm im PATH oder ein Builtin, das die Shell selbst ausführt. ls gibt es zweimal, weil /bin auf Ubuntu nur ein Link auf /usr/bin ist. Den Alias kennt nur deine interaktive Shell, in einem Skript fehlt er. cd muss ein Builtin sein – ein eigenes Programm könnte das Verzeichnis deiner Shell nicht ändern.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

docker compose -f ~/sh-lab/notes/compose.yaml ps --format '{{.Service}}' | sort

Erwartet: drei laufende Dienste (migrate ist fertig und beendet).

db
notes-api
proxy
curl -s -o /dev/null -w '%{http_code}\n' $NOTES_URL/notes

Erwartet:

200
command -v shellcheck shfmt bats jq

Erwartet:

/usr/local/bin/shellcheck
/usr/local/bin/shfmt
/usr/local/bin/bats
/usr/bin/jq

Challenge

Finde alle Befehle, deren Name nur aus Kleinbuchstaben besteht und auf sh endet – also Shells wie bash, dash und sh.

Hinweis: compgen -c listet alle Befehle, die die Shell kennt.

Lösung

compgen -c | grep -E '^[a-z]*sh$' | sort -u

Erwartet (je nach installierten Paketen):

bash
capsh
chsh
dash
hash
instmodsh
podmansh
rbash
sh
ssh
tclsh

rbash ist eine eingeschränkte Bash, hash ein Builtin, ssh und chsh sind gar keine Shells. Auch das gehört dazu: Ein Muster findet, was passt, nicht was gemeint ist.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Ein Werkzeugkasten, viele Server: Skripte gehören in ein Git-Repository und werden von dort verteilt, nicht auf jedem Server einzeln gepflegt (Tag 14).
  • Feste Versionen: ShellCheck, shfmt und bats laufen in der CI mit denselben Versionen wie lokal – sonst meldet die CI Fehler, die lokal niemand sieht.
  • Bash ist nicht überall: Alpine-Container und BusyBox haben nur sh. Wer dort Skripte braucht, schreibt sie POSIX-konform oder installiert bash ausdrücklich.