Tag 0: Das Trainingsgelände
Ziel: Eine Labor-VM mit Docker, Git und der GitHub-Kommandozeile
gh, ein eigenes Repositorynotes-actionsauf 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.
ghist 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.
resoluteist der Codename von Ubuntu 26.04. usermod -aG dockererlaubt dem Benutzerubuntu, Docker ohnesudozu nutzen.
Melde dich ab (exit) und wieder an, damit die Gruppe
docker gilt:
docker --versionErwartet:
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 -1Erwartet:
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:packagesgh zeigt einen achtstelligen Code. Öffne auf dem Laptop
https://github.com/login/device, gib ihn ein und
bestätige.
workflowerlaubt, Dateien unter.github/workflows/zu pushen. Ohne dieses Recht lehnt GitHub jeden Push mit einer Workflow-Datei ab.write:packagesunddelete:packagesbrauchst du ab Tag 6 für Images in der GitHub Container Registry.
gh auth statusErwartet (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 Repositorymaster, undgit push origin mainscheitert mitsrc 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/codeErwartet:
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 -AErwartet:
.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,defaultBranchRefErwartet:
{"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 HelloErwartet:
Hello from Docker!
gh repo view --json url --jq .urlErwartet:
https://github.com/<du>/notes-actions
git log --onelineErwartet (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 .descriptionErwartet:
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 loginim Browser ist für Menschen gedacht. Automatisierung nutzt GitHub Apps oder das kurzlebigeGITHUB_TOKENeines Laufs (Tag 9), keine persönlichen Tokens. - GitHub Enterprise Server hat dieselbe Actions-Syntax, aber eigene Runner und einen eigenen Katalog freigegebener Actions.