cmdb-insight/docs/Setup and configuration/AZURE-CLI-QUICKSTART.md

Azure CLI - Quick Start Guide

📍 Waar voer je deze commando's uit?

Je voert deze commando's uit in de Terminal (command line) op je computer.

---

🖥️ Terminal Openen

Op macOS (jouw situatie):

1. Open Terminal:

   • Druk op Cmd + Space (Spotlight)
   • Typ "Terminal"
   • Druk Enter
   • Of: Applications → Utilities → Terminal

2. Of gebruik iTerm2 (als je die hebt geïnstalleerd)

Op Windows:

• PowerShell of Command Prompt
• Druk Win + R, typ powershell, Enter

Op Linux:

• Open je terminal emulator (bijv. GNOME Terminal, Konsole)

---

✅ Stap 1: Check of Azure CLI Geïnstalleerd is

Voer dit commando uit in de terminal:

az --version

Als je een versie ziet (bijv. azure-cli 2.50.0): ✅ Azure CLI is geïnstalleerd, ga door naar Stap 2.

Als je een foutmelding krijgt (bijv. command not found): ❌ Azure CLI is niet geïnstalleerd, zie installatie hieronder.

---

📥 Stap 2: Azure CLI Installeren (als nodig)

Op macOS:

Optie A: Met Homebrew (Aanbevolen)

# Installeer Homebrew (als je die nog niet hebt)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Installeer Azure CLI
brew install azure-cli

Optie B: Met Installer

1. Download: https://aka.ms/installazureclimac
2. Open het .pkg bestand
3. Volg de installatie wizard

Optie C: Met pip (Python)

pip3 install azure-cli

Op Windows:

1. Download: https://aka.ms/installazurecliwindows
2. Run de .msi installer
3. Volg de installatie wizard

Op Linux:

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Na installatie, check opnieuw:

az --version

---

🔐 Stap 3: Login bij Azure

Voer dit commando uit:

az login

Wat gebeurt er:

1. Je browser opent automatisch
2. Log in met je Azure account (hetzelfde account dat je gebruikt voor Azure Portal)
3. Na succesvol inloggen, sluit je de browser
4. De terminal toont je subscriptions

Als browser niet opent automatisch:

• Je krijgt een code en URL in de terminal
• Kopieer de code
• Open de URL in je browser
• Voer de code in

Verwachte output:

[
  {
    "cloudName": "AzureCloud",
    "id": "12345678-1234-1234-1234-123456789012",
    "name": "Subscription Name",
    "state": "Enabled",
    ...
  }
]

✅ Je bent nu ingelogd!

---

🔍 Stap 4: Haal ACR Credentials Op

Voer dit commando uit:

az acr credential show --name zdlas

Verwachte output:

{
  "passwords": [
    {
      "name": "password",
      "value": "abc123xyz..."
    },
    {
      "name": "password2",
      "value": "def456uvw..."
    }
  ],
  "username": "zdlas"
}

Noteer:

• Username: zdlas (of wat er staat)
• Password: Gebruik passwords[0].value (de eerste password)

⚠️ Belangrijk: Deze credentials zijn gevoelig! Deel ze niet en gebruik ze alleen voor de service connection.

---

📋 Complete Stappen in Terminal

Hier is de complete reeks commando's:

# 1. Check of Azure CLI geïnstalleerd is
az --version

# 2. Login bij Azure (opent browser)
az login

# 3. Haal ACR credentials op
az acr credential show --name zdlas

Kopieer de output en gebruik de username en passwords[0].value in Azure DevOps.

---

🔄 Alternatief: Via Azure Portal (Zonder Azure CLI)

Als je Azure CLI niet wilt installeren, kun je credentials ook via Azure Portal ophalen:

1. Ga naar Azure Portal: https://portal.azure.com

2. Ga naar je Container Registry: Zoek naar zdlas

3. Klik op "Access keys" (links in het menu)

4. Je ziet:

   • Login server: zdlas.azurecr.io
   • Username: zdlas (of admin username)
   • Password: Klik op "Show" naast password om het te zien
   • Password2: Alternatieve password

5. Kopieer de username en password

✅ Dit is hetzelfde als az acr credential show!

---

🎯 Voor Jouw Situatie (Service Connection)

Gebruik deze credentials in Azure DevOps:

1. In de service connection wizard:

   • Kies "Docker Registry" → "Others"
   • Docker Registry: zdlas.azurecr.io
   • Docker ID: zdlas (of de username uit de output)
   • Docker Password: passwords[0].value (uit de output)
   • Service connection name: zuyderland-cmdb-acr-connection

2. Save

---

🚨 Troubleshooting

"az: command not found"

Oplossing: Azure CLI is niet geïnstalleerd

• Installeer Azure CLI (zie Stap 2 hierboven)
• Of gebruik Azure Portal alternatief (zie hierboven)

"az login" opent geen browser

Oplossing:

• Kopieer de code en URL uit de terminal
• Open de URL handmatig in je browser
• Voer de code in

"Subscription not found" of "Access denied"

Oplossing:

• Check of je ingelogd bent met het juiste Azure account
• Check of je toegang hebt tot de subscription waar de ACR staat
• Probeer: az account list om je subscriptions te zien
• Selecteer de juiste subscription: az account set --subscription "Subscription Name"

"ACR not found"

Oplossing:

• Check of de ACR naam correct is: zdlas
• Check of je toegang hebt tot de ACR
• Probeer: az acr list om alle ACR's te zien

---

💡 Tips

1. Azure CLI blijft ingelogd - Je hoeft niet elke keer az login te doen
2. Check je subscription - Als je meerdere subscriptions hebt: az account show
3. Wissel subscription - az account set --subscription "Subscription Name"
4. Logout - az logout (als je klaar bent)

---

📚 Meer Informatie

• Azure CLI Installatie
• Azure CLI Login
• ACR Credentials

---

🎯 Quick Reference

Terminal openen:

• macOS: Cmd + Space → "Terminal"

Azure CLI commando's:

az --version              # Check installatie
az login                  # Login bij Azure
az acr credential show --name zdlas  # Haal credentials op

Azure Portal alternatief:

• Portal → Container Registry → Access keys

Klaar! 🚀