Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände

Ziel: Eine Labor-VM mit Docker, Git und der GitHub-Kommandozeile gh, ein eigenes Repository notes-actions auf GitHub mit dem Code von notes-api. · Dauer: ca. 45 min · Voraussetzung: ein GitHub-Konto

Briefing

  • GitHub Actions führt Workflows aus, wenn im Repository etwas passiert: ein Push, ein Pull-Request, ein Zeitplan, ein Klick. Ein Workflow ist eine YAML-Datei unter .github/workflows/.
  • Die Jobs laufen auf Runnern. Am Anfang nutzt du die Runner von GitHub, ab Tag 5 auch einen eigenen auf deiner VM.
  • gh ist die Kommandozeile zu GitHub: Repositorys anlegen, Läufe ansehen, Logs lesen, Pull-Requests öffnen. Fast alles in diesem Buch geht ohne Browser.
 Laptop ──ssh──► VM gha ── git push ──► github.com/<du>/notes-actions
                   │                         │
                   └──── gh run watch ◄──────┘  Runner von GitHub (ab Tag 5: VM)

Drill 1: Die Labor-VM

Auf dem Laptop (Multipass von multipass.run):

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

Ab hier läuft alles in der VM.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Docker

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<'EOF'
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: resolute
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt-get update -qq
sudo apt-get install -y -qq docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin jq git >/dev/null
sudo usermod -aG docker ubuntu
  • Zuerst der Schlüssel, mit dem Docker seine Pakete signiert, dann die Paketquelle. resolute ist der Codename von Ubuntu 26.04.
  • usermod -aG docker erlaubt dem Benutzer ubuntu, Docker ohne sudo zu nutzen.

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

docker --version

Erwartet:

Docker version 29.9.2, build a82e528

Fortschritt speichern? Kostenlos registrieren

Drill 3: Die GitHub-Kommandozeile

gh kommt aus einer eigenen Paketquelle von GitHub – derselbe Ablauf wie bei Docker:

sudo curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  -o /etc/apt/keyrings/githubcli.gpg
sudo tee /etc/apt/sources.list.d/github-cli.sources >/dev/null <<'EOF'
Types: deb
URIs: https://cli.github.com/packages
Suites: stable
Components: main
Signed-By: /etc/apt/keyrings/githubcli.gpg
EOF
sudo apt-get update -qq
sudo apt-get install -y -qq gh >/dev/null
gh --version | head -1

Erwartet:

gh version 2.103.3 (2026-10-26)

Anmelden – mit drei Rechten mehr, als gh sonst verlangt:

gh auth login -h github.com -p https -w -s workflow,write:packages,delete:packages

gh zeigt einen achtstelligen Code. Öffne auf dem Laptop https://github.com/login/device, gib ihn ein und bestätige.

  • workflow erlaubt, Dateien unter .github/workflows/ zu pushen. Ohne dieses Recht lehnt GitHub jeden Push mit einer Workflow-Datei ab.
  • write:packages und delete:packages brauchst du ab Tag 6 für Images in der GitHub Container Registry.
gh auth status

Erwartet (dein Benutzername steht statt <du>, die Rechte-Zeile ist gekürzt):

github.com
  ✓ Logged in to github.com account <du> (keyring)
  - Active account: true
  - Git operations protocol: https
  - Token: gho_************************************
  - Token scopes: 'delete:packages', 'gist', 'read:org', 'repo', 'workflow', ...

Damit auch git push diese Anmeldung nutzt:

gh auth setup-git
git config --global user.name "Dein Name"
git config --global user.email "<du>@users.noreply.github.com"
git config --global init.defaultBranch main
  • Die noreply-Adresse hält deine echte Mailadresse aus den Commits heraus.
  • init.defaultBranch main: Ohne diese Zeile heißt der erste Branch in einem frisch geklonten, leeren Repository master, und git push origin main scheitert mit src refspec main does not match any.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Begleitcode und Repository

mkdir -p ~/gha-lab
git clone -q https://github.com/thomaszachmann/github-actions-zum-anfassen.git \
  ~/gha-lab/code
ls ~/gha-lab/code

Erwartet:

LICENSE
README.md
notes

Jetzt dein eigenes Repository. gh repo create legt es auf GitHub an und klont es:

cd ~/gha-lab
gh repo create notes-actions --public --clone
cd notes-actions
cp -r ~/gha-lab/code/notes/notes-api/. .
cp ~/gha-lab/code/notes/.gitignore .
ls -A

Erwartet:

.dockerignore
.git
.gitignore
Dockerfile
go.mod
go.sum
main.go
main_test.go
metrics.go
oidc.go
oidc_test.go
store.go
git add -A
git commit -qm "notes-api"
git push -q -u origin main
gh repo view --json name,visibility,defaultBranchRef

Erwartet:

{"defaultBranchRef":{"name":"main"},"name":"notes-actions","visibility":"PUBLIC"}

Das Repository ist öffentlich: Läufe auf den Runnern von GitHub kosten dann nichts. Was öffentlich ist, sieht jeder – darum stehen in diesem Buch nur Lab-Werte.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

docker run --rm hello-world | grep -m1 Hello

Erwartet:

Hello from Docker!
gh repo view --json url --jq .url

Erwartet:

https://github.com/<du>/notes-actions
git log --oneline

Erwartet (die Commit-ID weicht ab):

3535972 (HEAD -> main, origin/main) notes-api

Challenge

Lass dir mit gh die Beschreibung deines Repositorys setzen – „notes-api mit GitHub Actions“ – und zeig sie an, ohne den Browser zu öffnen.

Hinweis: gh repo edit --help und gh repo view --json ….

Lösung

gh repo edit --description "notes-api mit GitHub Actions"
gh repo view --json description --jq .description

Erwartet:

notes-api mit GitHub Actions

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Organisationen statt persönlicher Konten: Im Team liegt Code in einer GitHub-Organisation. Dort regeln Teams, Rulesets und Richtlinien, wer welche Actions und Runner nutzen darf.
  • Anmeldung ohne langlebige Tokens: gh auth login im Browser ist für Menschen gedacht. Automatisierung nutzt GitHub Apps oder das kurzlebige GITHUB_TOKEN eines Laufs (Tag 9), keine persönlichen Tokens.
  • GitHub Enterprise Server hat dieselbe Actions-Syntax, aber eigene Runner und einen eigenen Katalog freigegebener Actions.