Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände aufbauen

Ziel: Alle Werkzeuge sind da, ~/term-lab steht, die Übungs-zsh startet isoliert. · Dauer: ca. 30 min · Voraussetzung: keine

Briefing

  • Alles läuft auf einem Mac mit Apple Silicon. Homebrew liegt unter /opt/homebrew, die Standard-Shell ist zsh.
  • Die Werkzeuge stehen in einem Brewfile. Ein Befehl prüft, ein Befehl installiert.
  • Dein Übungs-Home ist ~/term-lab. Die Übungs-zsh liest ihre Konfiguration aus ~/term-lab/zsh statt aus ~.
  • Das Übungsprojekt ~/term-lab/projekt ist ein kleines Git-Repo mit Go, Python, YAML und Logs.
  • Eine Nerd Font liefert die Symbole für Prompt, eza und Neovim.
~/term-lab/
├── lab              Startskript: Übungs-zsh öffnen
├── zsh/             ZDOTDIR: .zshenv, .zshrc, .zsh_history
├── config/zsh/      eigene *.zsh-Dateien (ab Tag 5)
├── config/starship.toml
├── tmux.conf        (ab Tag 8)
├── gitconfig        GIT_CONFIG_GLOBAL für die Drills
├── bin/             eigene Skripte, steht im PATH
└── projekt/         Übungsprojekt "shop" (Git-Repo)

Drill 1: System prüfen

sw_vers -productVersion
uname -m
echo $SHELL
zsh --version
brew --prefix

Erwartet (kann je nach Version abweichen):

15.6.1
arm64
/bin/zsh
zsh 5.9 (arm64-apple-darwin24.0)
/opt/homebrew

Steht bei uname -m x86_64, läuft dein Terminal unter Rosetta. Dann liegt Homebrew unter /usr/local. Prüfe in den Informationen der Terminal-App im Finder, ob „Mit Rosetta öffnen” aktiv ist.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Das Brewfile

Das Begleitmaterial liegt auf GitHub. Hol es und merk dir den Pfad in einer Variablen:

git clone https://github.com/thomaszachmann/mac-terminal-zum-anfassen.git \
  ~/mac-terminal-zum-anfassen
export BUCH=~/mac-terminal-zum-anfassen
ls $BUCH/brew $BUCH/setup

Erwartet:

Cloning into '/Users/du/mac-terminal-zum-anfassen'...
/Users/du/mac-terminal-zum-anfassen/brew:
Brewfile

/Users/du/mac-terminal-zum-anfassen/setup:
projekt-dateien.sh  term-lab-setup.sh

Ein Auszug aus dem Brewfile:

cask "iterm2"
cask "ghostty"
cask "font-jetbrains-mono-nerd-font"

brew "tmux"
brew "starship"
brew "fzf"
brew "tlrc"        # liefert den Befehl tldr
brew "kubectx"     # liefert kubectx und kubens

Erst prüfen, nichts installieren:

brew bundle check --verbose --file=$BUCH/brew/Brewfile

Erwartet (gekürzt, hängt von deinem Mac ab):

brew bundle can't satisfy your Brewfile's dependencies.
→ Cask ghostty needs to be installed or updated.
→ Formula starship needs to be installed or updated.
→ Formula tlrc needs to be installed or updated.
→ Formula httpie needs to be installed or updated.
→ Formula entr needs to be installed or updated.
Satisfy missing dependencies with `brew bundle install`.

„installed or updated” heißt: fehlt oder ist veraltet. Jetzt installieren, ohne Vorhandenes zu aktualisieren:

brew bundle install --no-upgrade --file=$BUCH/brew/Brewfile
brew bundle check --file=$BUCH/brew/Brewfile

Erwartet (gekürzt, kann je nach Version abweichen):

Installing ghostty
Installing starship
...
`brew bundle` complete! 32 Brewfile dependencies now installed.
The Brewfile's dependencies are satisfied.

Warum --no-upgrade? Ein Lab-Setup soll nicht nebenbei deine Arbeitswerkzeuge auf neue Major-Versionen heben. Aktualisieren ist eine bewusste Entscheidung (Tag 13).

Tipp: Das Brewfile ist dein erstes Stück „Mac als Code”. An Tag 13 erzeugst du es mit brew bundle dump aus deinem echten System.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Übungs-Home anlegen

Das Setup-Skript legt ~/term-lab an. Es fasst weder ~/.zshrc noch ~/.gitconfig an:

bash $BUCH/setup/term-lab-setup.sh

Erwartet:

✔ projekt: 4 Commits, 500 Logzeilen
✔ Übungs-Home: /Users/du/term-lab
  Start: /Users/du/term-lab/lab

Ein zweiter Aufruf ändert nichts. Das Skript ist idempotent:

bash $BUCH/setup/term-lab-setup.sh

Erwartet:

projekt existiert schon – unverändert (neu bauen mit --reset)
✔ Übungs-Home: /Users/du/term-lab
  Start: /Users/du/term-lab/lab

Der Kern ist das Startskript ~/term-lab/lab:

cat ~/term-lab/lab

Erwartet:

#!/bin/sh
# Startet die Übungs-zsh. Die echte ~/.zshrc bleibt unberührt.
LAB="${LAB:-$HOME/term-lab}"
exec env LAB="$LAB" ZDOTDIR="$LAB/zsh" zsh -i "$@"

Warum ZDOTDIR? zsh sucht .zshenv, .zshrc und .zsh_history in $ZDOTDIR. Ist die Variable nicht gesetzt, nimmt zsh $HOME. Ein Umbiegen von HOME wäre gefährlicher: dann fänden auch git, ssh und alle anderen Tools ihre Konfiguration nicht mehr.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Die Übungs-zsh starten

~/term-lab/lab
echo $ZDOTDIR
echo $HISTFILE
echo $GIT_CONFIG_GLOBAL
git config user.name

Erwartet:

[lab] ~ % echo $ZDOTDIR
/Users/du/term-lab/zsh
/Users/du/term-lab/zsh/.zsh_history
/Users/du/term-lab/gitconfig
Lab User

Der gelbe Präfix [lab] zeigt dir immer, dass du im Übungs-Home bist. Deine History landet in einer eigenen Datei. Git nimmt die Lab-Konfiguration.

Welche Dateien hat diese zsh beim Start gelesen? Die Option sourcetrace verrät es:

ZDOTDIR=~/term-lab/zsh zsh -o sourcetrace -i -c exit

Erwartet:

+/Users/du/term-lab/zsh/.zshenv:1> <sourcetrace>
+/etc/zshrc:1> <sourcetrace>
+/Users/du/term-lab/zsh/.zshrc:1> <sourcetrace>

Keine Spur von ~/.zshrc. Genau das wollen wir. Mit exit oder ⌃D kommst du zurück in deine normale Shell.

Achtung: Startest du ein neues Fenster oder einen neuen Tab, bist du wieder in deiner echten Shell. Tippe dann erneut ~/term-lab/lab. An Tag 1 baust du dafür ein eigenes Terminal-Profil.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Das Übungsprojekt erkunden

cd ~/term-lab/projekt
git log --oneline --graph --all --decorate
git branch

Erwartet:

* 375fbf7 (feature/rabatt) feat: Rabatt-Schalter
* 2e4e6aa (HEAD -> main) chore: Config, Manifeste, Report
* a57983c feat: Warenkorb und HTTP-Server
* 1dc0abc init: Projektgerüst
  feature/rabatt
* main

Die Commits haben feste Datumswerte und den Autor „Lab User”. Darum siehst du dieselben Hashes wie im Buch.

find . -path ./.git -prune -o -type f -print | sort

Erwartet:

./.gitignore
./cmd/shop/main.go
./config/app.json
./config/app.yaml
./deploy/k8s/deployment.yaml
./docs/notizen.txt
./go.mod
./internal/cart/cart.go
./logs/access.log
./logs/app.log
./README.md
./scripts/report.py

Die Logs stehen in .gitignore. Das ist Absicht: An Tag 6 siehst du, warum rg sie nicht findet.

python3 scripts/report.py
grep -rn TODO --include='*.go' --include='*.py' .

Erwartet:

INFO   350
WARN   50
ERROR  50
DEBUG  50
internal/cart/cart.go:16:   // TODO: Rabatte berücksichtigen
cmd/shop/main.go:13:        port = "8080" // TODO: aus config/app.yaml lesen
scripts/report.py:13:# TODO: als JSON ausgeben

Fortschritt speichern? Kostenlos registrieren

Drill 6: Nerd Font prüfen

Eine Nerd Font ist eine normale Programmierschrift plus einige tausend Symbole: Git-Zweig, Ordner, Sprach-Logos, Powerline-Pfeile. Prompt, eza --icons und Neovim brauchen sie.

ls ~/Library/Fonts | grep -E 'JetBrainsMonoNerdFont(Mono)?-Regular'
brew list --cask --versions font-jetbrains-mono-nerd-font

Erwartet (kann je nach Version abweichen):

JetBrainsMonoNerdFont-Regular.ttf
JetBrainsMonoNerdFontMono-Regular.ttf
font-jetbrains-mono-nerd-font 3.4.0

Die Variante NerdFontMono hat streng einspaltige Symbole. Sie passt am besten in Terminals. Jetzt der Sichttest:

printf '   \U000f0219 \n'

Erwartet: fünf Symbole (Pfeil, Git-Zweig, Ordner, Dokument, Branch). Siehst du Kästchen oder Fragezeichen, nutzt deine Terminal-App noch keine Nerd Font. Das stellst du an Tag 1 um.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Neu bauen und aufräumen

Du hast das Projekt verbastelt? Dann baust du nur das Projekt neu. Deine Lab-Konfiguration unter zsh/ bleibt erhalten:

bash $BUCH/setup/term-lab-setup.sh --reset

Erwartet:

✔ projekt: 4 Commits, 500 Logzeilen
✔ Übungs-Home: /Users/du/term-lab
  Start: /Users/du/term-lab/lab

Komplett entfernen geht genauso einfach, denn außerhalb von ~/term-lab gibt es nichts:

echo rm -rf ~/term-lab    # erst ansehen, dann ohne echo

Sicherheit: Gewöhn dir echo vor rm -rf mit Variablen oder ~ an. Ein leeres $LAB macht aus rm -rf "$LAB/projekt" sonst rm -rf /projekt. Das Setup-Skript schützt sich mit set -u.

Fortschritt speichern? Kostenlos registrieren

Shortcut-Tabelle

Taste Wirkung Merkhilfe
⌃D Shell beenden (bei leerer Zeile) Done
⌃C laufenden Befehl abbrechen Cancel
⌃L Bildschirm leeren, Zeile bleibt Leeren
⌘K Scrollback der Terminal-App löschen Kill buffer
⌘T / ⌘N neuer Tab / neues Fenster Tab, New

Kontrollpunkt

LAB=${LAB:-~/term-lab}
ok() { local m=$1; shift; "$@" >/dev/null 2>&1 && echo "✔ $m" || echo "✘ $m"; }
hist=$(env ZDOTDIR="$LAB/zsh" zsh -i -c 'echo $HISTFILE')
ok "Startskript"     test -x "$LAB/lab"
ok "Lab-.zshrc"      test -f "$LAB/zsh/.zshrc"
ok "Projekt-Repo"    test "$(git -C "$LAB/projekt" rev-list --count --all)" = 4
ok "eigene History"  test "$hist" = "$LAB/zsh/.zsh_history"
ok "Nerd Font"       sh -c 'ls ~/Library/Fonts | grep -q NerdFont'
for t in tmux fzf rg fd bat eza zoxide atuin nvim jq gh; do
  ok "Tool $t" command -v $t
done

Erwartet (gekürzt):

✔ Startskript
✔ Lab-.zshrc
✔ Projekt-Repo
✔ eigene History
✔ Nerd Font
✔ Tool tmux
...
✔ Tool gh

Challenge

Terminal-Apps auf dem Mac starten die Shell als Login-Shell. Starte die Übungs-zsh als Login-Shell und finde heraus, welche Startdatei dann zusätzlich gelesen wird.

Hinweis: man zsh, Abschnitt STARTUP/SHUTDOWN FILES, und die Option -l.

Lösung

ZDOTDIR=~/term-lab/zsh zsh -l -o sourcetrace -i -c exit

Erwartet:

+/Users/du/term-lab/zsh/.zshenv:1> <sourcetrace>
+/etc/zprofile:1> <sourcetrace>
+/etc/zshrc:1> <sourcetrace>
+/Users/du/term-lab/zsh/.zshrc:1> <sourcetrace>

Neu ist /etc/zprofile. Dort ruft macOS path_helper auf und baut den PATH aus /etc/paths und /etc/paths.d/. Eine eigene .zprofile in ~/term-lab/zsh würde direkt danach gelesen. Warum das für einen sauberen PATH wichtig ist, siehst du an Tag 2.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Auf Firmen-Macs verwaltet oft MDM (Jamf, Intune, Kandji) die Software. Prüfe, ob Homebrew erlaubt ist und ob ein interner Mirror oder Proxy (HOMEBREW_ARTIFACT_DOMAIN, HTTPS_PROXY) nötig ist.
  • Leg das Brewfile ins Team-Repo. Neue Kolleginnen und Kollegen sind dann mit brew bundle install in Minuten arbeitsfähig.
  • Pinne kritische Versionen bewusst und aktualisiere gesammelt mit brew bundle install plus Changelog-Check, nicht nebenbei.
  • Schriftarten und Casks brauchen manchmal Admin-Rechte. Kläre das vor dem Onboarding-Tag, nicht währenddessen.
  • Das Muster „eigenes Übungs-Home per ZDOTDIR” eignet sich auch für Schulungen und Pairing auf fremden Rechnern: nichts wird überschrieben, alles lässt sich mit einem rm -rf entfernen.