# 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 |
|----------------|-------------|----------|
| VirtualBox     | 7.x         | https://www.virtualbox.org/wiki/Downloads |
| Vagrant        | 2.4.x       | https://developer.hashicorp.com/vagrant/downloads |
| 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 10–15 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 30–60 seconden |
| `/vagrant` is leeg | Shared folder probleem — probeer `vagrant reload` |