ops-demo/docs/vm-setup.md
2026-02-28 22:42:09 +01:00

132 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# VM-setup
Alles draait in een VirtualBox-VM die Vagrant voor je opzet. Volg deze stappen voordat je aan de oefeningen begint.
---
## Wat je nodig hebt
Doe dit de dag ervoor — niet op de ochtend van de workshop zelf.
| Tool | Versie | Download | Of op Mac |
|------------|-------------|---------------------------------------------------|---------------------------|
| VirtualBox | 7.x | https://www.virtualbox.org/wiki/Downloads | `brew install virtualbox` |
| Vagrant | 2.4.x | https://developer.hashicorp.com/vagrant/downloads | `brew install vagrant` |
| Git | willekeurig | https://git-scm.com/downloads | |
Minimaal 12 GB vrij RAM, ~15 GB schijfruimte.
**Na installatie van VirtualBox: herstart je laptop.** VirtualBox installeert een kernel-extensie en die werkt pas na
een reboot.
Snelle check — alle drie moeten een versie tonen:
```bash
VBoxManage --version && vagrant --version && git --version
```
---
## Stap 1 — Fork en clone de repo
Fork de repo naar je eigen GitHub-account via https://github.com/paulharkink/ops-demo → **Fork**.
```bash
git clone https://github.com/JOUW_USERNAME/ops-demo.git
cd ops-demo
```
---
## Stap 2 — VM opstarten
```bash
vagrant up
```
De eerste keer duurt dit 1015 minuten. Vagrant downloadt de Ubuntu 24.04 box, installeert k3s, Helm en yq, en haalt de
workshop-images alvast op. Daarna start de VM in een paar seconden.
Aan het einde zie je:
```
════════════════════════════════════════════════════════
VM provisioned successfully!
════════════════════════════════════════════════════════
```
---
## Stap 3 — Inloggen
```bash
vagrant ssh
cd /vagrant
```
Alle workshop-commando's voer je vanaf hier uit, tenzij anders aangegeven.
---
## Stap 4 — Controleer de setup
```bash
kubectl get nodes
# NAME STATUS ROLES AGE VERSION
# ops-demo Ready control-plane,master Xm v1.31.x+k3s1
helm version
# version.BuildInfo{Version:"v3.16.x", ...}
ls /vagrant
# Vagrantfile README.md apps/ docs/ manifests/ scripts/
```
---
## Stap 5 — Controleer bereikbaarheid vanaf je laptop
Vanuit je laptop (niet de VM):
```bash
ping 192.168.56.10
```
Werkt dit niet, controleer dan of de VirtualBox host-only adapter bestaat:
```bash
VBoxManage list hostonlyifs
# Verwacht: vboxnet0 met IP 192.168.56.1
```
Bestaat hij niet:
```bash
VBoxManage hostonlyif create
VBoxManage hostonlyif ipconfig vboxnet0 --ip 192.168.56.1 --netmask 255.255.255.0
```
Dan `vagrant up` opnieuw.
---
## Handige Vagrant-commando's
```bash
vagrant halt # afsluiten
vagrant up # opstarten
vagrant suspend # pauzeren
vagrant resume # hervatten
vagrant destroy # VM volledig verwijderen
```
---
## Probleemoplossing
| Symptoom | Oplossing |
|--------------------------------|-------------------------------------------------------|
| "No usable default provider" | VirtualBox niet geïnstalleerd of laptop niet herstart |
| VT-x/AMD-V niet beschikbaar | Schakel virtualisatie in via BIOS/UEFI |
| `kubectl get nodes` → NotReady | k3s start nog op, wacht 3060 seconden |
| `/vagrant` is leeg | Shared folder probleem — probeer `vagrant reload` |