Bert Hausmans
55c8fee3b8
- Configure ACR name: zdlas in azure-pipelines.yml - Add Azure Container Registry documentation and guides - Add scripts for ACR creation and image building - Add docker-compose config for ACR deployment - Remove temporary Excel lock file
288 lines
8.0 KiB
Markdown
288 lines
8.0 KiB
Markdown
# Azure Container Registry - Quick Start Guide
|
|
|
|
Snelstart guide om zelf Azure Container Registry aan te maken en te configureren voor productie.
|
|
|
|
## 🚀 Stap 1: Azure Container Registry Aanmaken
|
|
|
|
### Optie A: Met Script (Aanbevolen)
|
|
|
|
```bash
|
|
# Run het script
|
|
./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: Handmatig via Azure CLI
|
|
|
|
```bash
|
|
# Login bij Azure
|
|
az login
|
|
|
|
# Resource group aanmaken
|
|
az group create --name rg-cmdb-gui --location westeurope
|
|
|
|
# Check of naam beschikbaar is
|
|
az acr check-name --name zuyderlandcmdbacr
|
|
|
|
# ACR aanmaken (Basic SKU - ~€5/maand)
|
|
az acr create \
|
|
--resource-group rg-cmdb-gui \
|
|
--name zuyderlandcmdbacr \
|
|
--sku Basic \
|
|
--admin-enabled true
|
|
|
|
# Credentials ophalen
|
|
az acr credential show --name zuyderlandcmdbacr
|
|
```
|
|
|
|
### Optie C: Via Azure Portal
|
|
|
|
1. Ga naar [Azure Portal](https://portal.azure.com)
|
|
2. Klik **"Create a resource"**
|
|
3. Zoek **"Container Registry"**
|
|
4. Klik **"Create"**
|
|
5. Vul in:
|
|
- **Resource group**: `rg-cmdb-gui` (of maak nieuwe)
|
|
- **Registry name**: `zuyderlandcmdbacr` (moet uniek zijn, alleen kleine letters en cijfers, **geen streepjes**)
|
|
- **Location**: `West Europe`
|
|
- **SKU**: `Basic` ⭐ (aanbevolen - ~€5/maand)
|
|
- **Domain name label scope**:
|
|
- **"Unsecure"** ⭐ (aanbevolen) - DNS naam wordt: `zuyderlandcmdbacr.azurecr.io`
|
|
- **"Resource Group Reuse"** (voor extra security) - DNS naam wordt: `zuyderlandcmdbacr-abc123.azurecr.io` (met hash)
|
|
- ⚠️ **Let op**: Als je een hash gebruikt, moet je alle configuraties aanpassen met de volledige DNS naam!
|
|
- **Role assignment permissions mode**:
|
|
- **"RBAC Registry Permissions"** ⭐ (aanbevolen - eenvoudigst)
|
|
- **"RBAC Registry + ABAC Repository Permissions"** (alleen als je per-repository permissions nodig hebt)
|
|
6. Klik **"Review + create"** → **"Create"**
|
|
|
|
**💡 Aanbeveling:** Kies **"Unsecure"** voor de eenvoudigste setup. Zie `docs/AZURE-ACR-DNL-SCOPE.md` voor details.
|
|
|
|
**Noteer je ACR naam!** Je hebt deze nodig voor de volgende stappen.
|
|
|
|
---
|
|
|
|
## 🔧 Stap 2: Pipeline Variabelen Aanpassen
|
|
|
|
Pas `azure-pipelines.yml` aan met jouw ACR naam:
|
|
|
|
```yaml
|
|
variables:
|
|
# Pas deze aan naar jouw ACR naam
|
|
acrName: 'zuyderlandcmdbacr' # ← Jouw ACR naam hier
|
|
|
|
repositoryName: 'zuyderland-cmdb-gui'
|
|
|
|
# Service connection naam (maak je in volgende stap)
|
|
dockerRegistryServiceConnection: 'zuyderland-cmdb-acr-connection'
|
|
|
|
imageTag: '$(Build.BuildId)'
|
|
```
|
|
|
|
**Commit en push:**
|
|
```bash
|
|
git add azure-pipelines.yml
|
|
git commit -m "Configure ACR in pipeline"
|
|
git push origin main
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 Stap 3: Service Connection Aanmaken in Azure DevOps
|
|
|
|
Deze connection geeft Azure DevOps toegang tot je ACR.
|
|
|
|
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**: `zuyderland-cmdb-acr-connection`
|
|
- **Description**: Optioneel (bijv. "ACR for CMDB GUI")
|
|
8. Klik **"Save"**
|
|
|
|
**✅ Noteer de service connection naam!** Deze moet overeenkomen met `dockerRegistryServiceConnection` in `azure-pipelines.yml`.
|
|
|
|
---
|
|
|
|
## 🎯 Stap 4: Pipeline Aanmaken en Run
|
|
|
|
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"**
|
|
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: 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
|
|
```
|
|
|
|
---
|
|
|
|
## 🐳 Stap 6: Images Lokaal Testen (Optioneel)
|
|
|
|
```bash
|
|
# Login bij ACR
|
|
az acr login --name zuyderlandcmdbacr
|
|
|
|
# Pull images
|
|
docker pull zuyderlandcmdbacr.azurecr.io/zuyderland-cmdb-gui/backend:latest
|
|
docker pull zuyderlandcmdbacr.azurecr.io/zuyderland-cmdb-gui/frontend:latest
|
|
|
|
# Test run (met docker-compose)
|
|
docker-compose -f docker-compose.prod.acr.yml pull
|
|
docker-compose -f docker-compose.prod.acr.yml up -d
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Checklist
|
|
|
|
- [ ] Azure Container Registry aangemaakt
|
|
- [ ] ACR naam genoteerd
|
|
- [ ] `azure-pipelines.yml` variabelen aangepast
|
|
- [ ] Service Connection aangemaakt in Azure DevOps
|
|
- [ ] Pipeline aangemaakt en gerund
|
|
- [ ] Images succesvol gebouwd en gepusht
|
|
- [ ] Images geverifieerd in Azure Portal
|
|
|
|
---
|
|
|
|
## 🔄 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
|
|
|
|
### ACR Naam Niet Beschikbaar
|
|
|
|
**Oplossing:**
|
|
- ACR namen moeten uniek zijn wereldwijd
|
|
- Probeer een andere naam:
|
|
- `zuyderlandcmdbacr1`
|
|
- `zuyderlandcmdbprod`
|
|
- `cmdbzuyderlandacr`
|
|
- `zuyderlandcmdbgui`
|
|
|
|
---
|
|
|
|
## 💰 Kosten & SKU Keuze
|
|
|
|
**Aanbeveling: Basic SKU** ⭐ (~€5/maand)
|
|
|
|
**Basic SKU** (Aanbevolen voor jouw situatie):
|
|
- ✅ 10GB storage - Ruim voldoende voor backend + frontend met meerdere versies
|
|
- ✅ 1GB/day webhook throughput - Voldoende voor CI/CD
|
|
- ✅ Unlimited pulls - Geen extra kosten
|
|
- ✅ RBAC support - Role-based access control
|
|
- ✅ **Kosten: ~€5/maand**
|
|
|
|
**Standard SKU** (~€20/maand):
|
|
- 100GB storage
|
|
- 10GB/day webhook throughput
|
|
- Geo-replicatie
|
|
- **Niet nodig voor jouw situatie**
|
|
|
|
**Premium SKU** (~€50/maand):
|
|
- 500GB storage
|
|
- Security scanning
|
|
- Private endpoints
|
|
- **Overkill voor 20 gebruikers**
|
|
|
|
**Voor jouw situatie (20 gebruikers): Basic is perfect!** ✅
|
|
|
|
📚 Zie `docs/AZURE-ACR-PRICING.md` voor volledige vergelijking.
|
|
|
|
---
|
|
|
|
## 📚 Meer Informatie
|
|
|
|
- **Volledige ACR Guide**: `docs/AZURE-CONTAINER-REGISTRY.md`
|
|
- **Azure DevOps Setup**: `docs/AZURE-DEVOPS-SETUP.md`
|
|
- **Deployment Guide**: `docs/PRODUCTION-DEPLOYMENT.md`
|
|
|
|
---
|
|
|
|
## 🎯 Volgende Stappen
|
|
|
|
Nu je images in ACR staan, kun je ze deployen naar:
|
|
|
|
1. **Azure Container Instances (ACI)** - Eenvoudig, snel
|
|
2. **Azure App Service (Container)** - Managed service
|
|
3. **Azure Kubernetes Service (AKS)** - Voor complexere setups
|
|
4. **VM met Docker Compose** - Volledige controle
|
|
|
|
Zie `docs/AZURE-DEPLOYMENT-SUMMARY.md` voor deployment opties.
|