# Azure DevOps Setup - Stap voor Stap Guide

Nu je code in Azure DevOps staat, volg deze stappen om Docker images automatisch te bouwen en naar Azure Container Registry te pushen.

## 📋 Stappenplan

### Stap 1: Azure Container Registry Aanmaken

Als je nog geen Azure Container Registry hebt:

**Optie A: Met Script (Aanbevolen) 🚀**
```bash
# Run het script (interactief)
./scripts/create-acr.sh

# Of met custom parameters:
./scripts/create-acr.sh rg-cmdb-gui zuyderlandcmdbacr westeurope Basic
```

Het script doet automatisch:
- ✅ Checkt of je ingelogd bent bij Azure
- ✅ Maakt resource group aan (als nodig)
- ✅ Controleert of ACR naam beschikbaar is
- ✅ Maakt ACR aan met Basic SKU
- ✅ Toont credentials
- ✅ Test Docker login

**Optie B: Via Azure CLI (Handmatig)**
```bash
# Login bij Azure
az login

# Resource group aanmaken (als nog niet bestaat)
az group create --name rg-cmdb-gui --location westeurope

# Container Registry aanmaken
az acr create \
  --resource-group rg-cmdb-gui \
  --name zuyderlandcmdbacr \
  --sku Basic \
  --admin-enabled true
```

**Optie C: Via Azure Portal**
1. Ga naar [Azure Portal](https://portal.azure.com)
2. Klik op **"Create a resource"**
3. Zoek naar **"Container Registry"**
4. Klik **"Create"**
5. Vul in:
   - **Resource group**: Kies bestaande of maak nieuwe (bijv. `rg-cmdb-gui`)
   - **Registry name**: Bijv. `zuyderlandcmdbacr` (moet uniek zijn, alleen kleine letters en cijfers)
   - **Location**: `West Europe` (of gewenste regio)
   - **SKU**: `Basic` (voor development/test) of `Standard` (voor productie)
6. Klik **"Review + create"** → **"Create"**

**Noteer je ACR naam!** Je hebt deze nodig in de volgende stappen.

**📚 Zie `docs/AZURE-ACR-QUICKSTART.md` voor een complete quick-start guide.**

---

### Stap 2: Service Connection Aanmaken in Azure DevOps

Deze connection geeft Azure DevOps toegang tot je Azure Container Registry.

1. **Ga naar je Azure DevOps project**
2. Klik op **⚙️ Project Settings** (onderaan links)
3. Ga naar **Service connections** (onder Pipelines)
4. Klik op **"New service connection"**
5. Kies **"Docker Registry"**
6. Kies **"Azure Container Registry"**
7. Vul in:
   - **Azure subscription**: Selecteer je Azure subscription
   - **Azure container registry**: Selecteer je ACR (bijv. `zuyderlandcmdbacr`)
   - **Service connection name**: Bijv. `zuyderland-cmdb-acr-connection`
   - **Description**: Optioneel
8. Klik **"Save"**

**✅ Noteer de service connection naam!** Je hebt deze nodig voor de pipeline.

---

### Stap 3: Pipeline Variabelen Aanpassen

Pas de `azure-pipelines.yml` aan naar jouw instellingen:

1. **Open** `azure-pipelines.yml` in je repository
2. **Pas de variabelen aan** (regel 15-20):

```yaml
variables:
  # Pas deze aan naar jouw ACR naam
  acrName: 'zuyderlandcmdbacr'  # ← Jouw ACR naam hier
  
  repositoryName: 'zuyderland-cmdb-gui'
  
  # Pas deze aan naar de service connection naam die je net hebt gemaakt
  dockerRegistryServiceConnection: 'zuyderland-cmdb-acr-connection'  # ← Jouw service connection naam
  
  imageTag: '$(Build.BuildId)'
```

3. **Commit en push** de wijzigingen:
```bash
git add azure-pipelines.yml
git commit -m "Configure Azure DevOps pipeline"
git push origin main
```

---

### Stap 4: Pipeline Aanmaken in Azure DevOps

1. **Ga naar je Azure DevOps project**
2. Klik op **Pipelines** (links in het menu)
3. Klik op **"New pipeline"** of **"Create Pipeline"**
4. Kies **"Azure Repos Git"** (of waar je code staat)
5. Selecteer je repository: **"Zuyderland CMDB GUI"** (of jouw repo naam)
6. Kies **"Existing Azure Pipelines YAML file"**
7. Selecteer:
   - **Branch**: `main`
   - **Path**: `/azure-pipelines.yml`
8. Klik **"Continue"**
9. **Review** de pipeline configuratie
10. Klik **"Run"** om de pipeline te starten

---

### Stap 5: Pipeline Uitvoeren

De pipeline start automatisch en zal:

1. ✅ Code uitchecken
2. ✅ Backend Docker image bouwen
3. ✅ Frontend Docker image bouwen
4. ✅ Images naar Azure Container Registry pushen

**Je kunt de voortgang volgen:**
- Klik op de running pipeline
- Bekijk de logs per stap
- Bij success zie je de image URLs

**Verwachte output:**
```
Backend Image: zuyderlandcmdbacr.azurecr.io/zuyderland-cmdb-gui/backend:123
Frontend Image: zuyderlandcmdbacr.azurecr.io/zuyderland-cmdb-gui/frontend:123
```

---

### Stap 6: Images Verifiëren

**In Azure Portal:**
1. Ga naar je **Container Registry** (`zuyderlandcmdbacr`)
2. Klik op **"Repositories"**
3. Je zou moeten zien:
   - `zuyderland-cmdb-gui/backend`
   - `zuyderland-cmdb-gui/frontend`
4. Klik op een repository om de tags te zien (bijv. `latest`, `123`)

**Via Azure CLI:**
```bash
# Lijst repositories
az acr repository list --name zuyderlandcmdbacr

# Lijst tags voor backend
az acr repository show-tags --name zuyderlandcmdbacr --repository zuyderland-cmdb-gui/backend

# Lijst tags voor frontend
az acr repository show-tags --name zuyderlandcmdbacr --repository zuyderland-cmdb-gui/frontend
```

---

## 🚀 Automatische Triggers

De pipeline triggert automatisch bij:

1. **Push naar `main` branch** → Bouwt `latest` tag
2. **Git tags die beginnen met `v*`** → Bouwt versie tag (bijv. `v1.0.0`)

**Voorbeeld:**
```bash
# Tag aanmaken en pushen
git tag v1.0.0
git push origin v1.0.0
# → Pipeline triggert automatisch en bouwt versie 1.0.0
```

---

## 🔧 Troubleshooting

### Pipeline Fails: "Service connection not found"

**Oplossing:**
- Controleer of de service connection naam in `azure-pipelines.yml` overeenkomt met de naam in Azure DevOps
- Ga naar Project Settings → Service connections en verifieer de naam

### Pipeline Fails: "ACR not found"

**Oplossing:**
- Controleer of de `acrName` variabele correct is in `azure-pipelines.yml`
- Verifieer dat de ACR bestaat: `az acr list`

### Pipeline Fails: "Permission denied"

**Oplossing:**
- Controleer of de service connection de juiste permissions heeft
- Verifieer dat je Azure subscription toegang heeft tot de ACR
- Probeer de service connection opnieuw aan te maken

### Images worden niet gepusht

**Oplossing:**
- Check de pipeline logs voor specifieke errors
- Verifieer dat de Docker build succesvol is
- Controleer of de ACR admin-enabled is (voor development)

---

## 📦 Volgende Stappen: Deployment

Nu je images in Azure Container Registry staan, kun je ze deployen:

### Optie 1: Azure App Service

```bash
# Web App aanmaken en configureren
az webapp create --name cmdb-backend --resource-group rg-cmdb-gui --plan plan-cmdb-gui
az webapp config container set --name cmdb-backend --resource-group rg-cmdb-gui \
  --docker-custom-image-name zuyderlandcmdbacr.azurecr.io/zuyderland-cmdb-gui/backend:latest \
  --docker-registry-server-url https://zuyderlandcmdbacr.azurecr.io
```

### Optie 2: Docker Compose op VM

```bash
# Login bij ACR
az acr login --name zuyderlandcmdbacr

# Pull images
docker-compose -f docker-compose.prod.acr.yml pull

# Deploy
docker-compose -f docker-compose.prod.acr.yml up -d
```

### Optie 3: Azure Container Instances (ACI)

```bash
az container create \
  --resource-group rg-cmdb-gui \
  --name cmdb-backend \
  --image zuyderlandcmdbacr.azurecr.io/zuyderland-cmdb-gui/backend:latest \
  --registry-login-server zuyderlandcmdbacr.azurecr.io \
  --registry-username <acr-username> \
  --registry-password <acr-password>
```

---

## 📝 Checklist

- [ ] Azure Container Registry aangemaakt
- [ ] Service Connection geconfigureerd in Azure DevOps
- [ ] `azure-pipelines.yml` variabelen aangepast
- [ ] Pipeline aangemaakt en gerund
- [ ] Images succesvol gebouwd en gepusht
- [ ] Images geverifieerd in Azure Portal
- [ ] Automatische triggers getest (push naar main)

---

## 🎯 Quick Reference

**ACR Login:**
```bash
az acr login --name zuyderlandcmdbacr
```

**Images Lijsten:**
```bash
az acr repository list --name zuyderlandcmdbacr
az acr repository show-tags --name zuyderlandcmdbacr --repository zuyderland-cmdb-gui/backend
```

**Pipeline Handmatig Triggeren:**
- Ga naar Pipelines → Selecteer pipeline → "Run pipeline"

**Pipeline Logs Bekijken:**
- Ga naar Pipelines → Selecteer pipeline → Klik op de run → Bekijk logs per stap

---

## 📚 Meer Informatie

- [Azure Container Registry Docs](https://docs.microsoft.com/en-us/azure/container-registry/)
- [Azure DevOps Pipelines Docs](https://docs.microsoft.com/en-us/azure/devops/pipelines/)
- [Docker Task Reference](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/build/docker)

---

## 💡 Tips

1. **Gebruik versie tags voor productie**: Tag releases met `v1.0.0`, `v1.0.1`, etc.
2. **Monitor pipeline costs**: Azure DevOps geeft gratis build minuten per maand
3. **Enable retention policies**: Configureer ACR om oude images automatisch te verwijderen
4. **Use build caching**: Voor snellere builds bij volgende runs
5. **Set up notifications**: Configureer email/Slack notificaties voor pipeline status