Skip to content

Latest commit

 

History

History
1060 lines (800 loc) · 53 KB

File metadata and controls

1060 lines (800 loc) · 53 KB

AZD for nybegynnere: En strukturert læringsreise

AZD-for-beginners

GitHub watchers GitHub forks GitHub stars

Azure Discord Microsoft Foundry Discord


Automatiske oversettelser (alltid oppdatert)

Arabisk | Bengali | Bulgarsk | Burmesisk (Myanmar) | Kinesisk (forenklet) | Kinesisk (tradisjonell, Hong Kong) | Kinesisk (tradisjonell, Macau) | Kinesisk (tradisjonell, Taiwan) | Kroatisk | Tsjekkisk | Dansk | Nederlandsk | Estisk | Finsk | Fransk | Tysk | Gresk | Hebraisk | Hindi | Ungarsk | Indonesisk | Italiensk | Japansk | Kannada | Khmer | Koreansk | Litauisk | Malaysisk | Malayalam | Marathi | Nepalsk | Nigeriansk pidgin | Norsk | Persisk (Farsi) | Polsk | Portugisisk (Brasil) | Portugisisk (Portugal) | Punjabi (Gurmukhi) | Rumensk | Russisk | Serbisk (kyrillisk) | Slovakisk | Slovensk | Spansk | Swahili | Svensk | Tagalog (Filippinsk) | Tamil | Telugu | Thai | Tyrkisk | Ukrainsk | Urdu | Vietnamesisk

Foretrekker du å klone lokalt?

Dette depotet inkluderer 50+ språkoversettelser som betydelig øker nedlastingsstørrelsen. For å klone uten oversettelser, bruk sparsommelig utsjekking:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

Dette gir deg alt du trenger for å fullføre kurset med mye raskere nedlasting.

🆕 Hva er nytt i azd i dag

Azure Developer CLI har vokst utover tradisjonelle nettapper og API-er. I dag er azd det eneste verktøyet for å distribuere enhver applikasjon til Azure – inkludert AI-drevne applikasjoner og intelligente agenter.

Dette betyr for deg:

  • AI-agenter er nå førsteklasses azd arbeidsbelastninger. Du kan initialisere, distribuere og administrere AI-agentprosjekter med samme azd initazd up arbeidsflyt du allerede kjenner.
  • Microsoft Foundry-integrasjon bringer modellutplassering, agenthosting og AI-tjenestekonfigurasjon direkte inn i azd-maløkosystemet.
  • Kjernearbeidsflyten er uendret. Enten du distribuerer en todo-app, en mikrotjeneste eller en multi-agent AI-løsning, er kommandoene de samme.

Hvis du har brukt azd tidligere, er AI-støtte en naturlig utvidelse – ikke et eget verktøy eller et avansert spor. Hvis du begynner ferskt, lærer du én arbeidsflyt som fungerer for alt.


🚀 Hva er Azure Developer CLI (azd)?

Azure Developer CLI (azd) er et utviklervennlig kommandolinjeverktøy som gjør det enkelt å distribuere applikasjoner til Azure. I stedet for å manuelt opprette og koble sammen dusinvis av Azure-ressurser, kan du distribuere hele applikasjoner med én enkelt kommando.

Magien med azd up

# Denne ene kommandoen gjør alt:
# ✅ Oppretter alle Azure-ressursene
# ✅ Konfigurerer nettverk og sikkerhet
# ✅ Bygger applikasjonskoden din
# ✅ Distribuerer til Azure
# ✅ Gir deg en fungerende URL
azd up

Det er alt! Ingen klikk i Azure-portalen, ingen komplekse ARM-maler å lære først, ingen manuell konfigurasjon – bare fungerende applikasjoner på Azure.


❓ Azure Developer CLI vs Azure CLI: Hva er forskjellen?

Dette er det vanligste spørsmålet nybegynnere stiller. Her er det enkle svaret:

Funksjon Azure CLI (az) Azure Developer CLI (azd)
Formål Administrere individuelle Azure-ressurser Distribuere komplette applikasjoner
Tankesett Infrastruktur-fokusert Applikasjons-fokusert
Eksempel az webapp create --name myapp... azd up
Læringskurve Må kjenne Azure-tjenester Bare kjenne appen din
Best for DevOps, Infrastruktur Utviklere, Prototyping

Enkel analogi

  • Azure CLI er som å ha alle verktøyene til å bygge et hus – hammere, sager, spiker. Du kan bygge hva som helst, men du må kunne konstruksjon.
  • Azure Developer CLI er som å leie en entreprenør – du beskriver hva du vil ha, og de tar seg av byggingen.

Når bruke hver

Situasjon Bruk dette
"Jeg vil raskt distribuere webappen min" azd up
"Jeg trenger bare å opprette en lagringskonto" az storage account create
"Jeg bygger en full AI-applikasjon" azd init --template azure-search-openai-demo
"Jeg må feilsøke en spesifikk Azure-ressurs" az resource show
"Jeg vil ha produksjonsklar distribusjon på minutter" azd up --environment production

De fungerer sammen!

AZD bruker Azure CLI under panseret. Du kan bruke begge:

# Distribuer appen din med AZD
azd up

# Deretter finjuster spesifikke ressurser med Azure CLI
az webapp config set --name myapp --always-on true

🌟 Finn maler i Awesome AZD

Ikke start fra bunnen! Awesome AZD er fellesskapets samling av maler klare til distribusjon:

Ressurs Beskrivelse
🔗 Awesome AZD Gallery Bla gjennom 200+ maler med ett-klikk-distribusjon
🔗 Send inn en mal Bidra med din egen mal til fellesskapet
🔗 GitHub-lager Gi stjerne og utforsk koden

Populære AI-maler fra Awesome AZD

# RAG-chat med Microsoft Foundry-modeller + AI-søk
azd init --template azure-search-openai-demo

# Rask AI-chatapplikasjon
azd init --template openai-chat-app-quickstart

# AI-agenter med Foundry-agenter
azd init --template get-started-with-ai-agents

🎯 Kom i gang i 3 steg

Før du begynner, sørg for at maskinen din er klar for malen du vil distribuere:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Hvis noen nødvendige sjekker feiler, fiks det først og fortsett deretter med kjapp start.

Steg 1: Installer AZD (2 minutter)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

curl -fsSL https://aka.ms/install-azd.sh | bash

Steg 2: Autentiser for AZD

# Valgfritt hvis du planlegger å bruke Azure CLI-kommandoer direkte i dette kurset
az login

# Påkrevd for AZD-arbeidsflyter
azd auth login

Hvis du er usikker på hvilken du trenger, følg hele oppsettflyten i Installasjon & Oppsett.

Steg 3: Distribuer din første app

# Initialiser fra en mal
azd init --template todo-nodejs-mongo

# Distribuer til Azure (oppretter alt!)
azd up

🎉 Ferdig! Appen din er nå live på Azure.

Rydd opp (ikke glem!)

# Remove all resources when done experimenting
azd down --force --purge

📚 Hvordan bruke dette kurset

Dette kurset er utformet for progressiv læring – start der du er komfortabel og jobb deg oppover:

Din erfaring Start her
Helt ny på Azure Kapittel 1: Grunnlag
Kan Azure, ny på AZD Kapittel 1: Grunnlag
Vil distribuere AI-apper Kapittel 2: AI-første utvikling
Vil ha praktisk trening 🎓 Interaktivt verksted – 3-4 timers guidet lab
Trenger produksjonsmønstre Kapittel 8: Produksjon & Enterprise

Raskt oppsett

  1. Fork dette depotet: GitHub forks
  2. Klon det: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. Få hjelp: Azure Discord Community

Foretrekker du å klone lokalt?

Dette depotet inkluderer 50+ språkoversettelser som betydelig øker nedlastingsstørrelsen. For å klone uten oversettelser, bruk sparsommelig utsjekking:

git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

Dette gir deg alt du trenger for å fullføre kurset med mye raskere nedlasting.

Kursoversikt

Mestre Azure Developer CLI (azd) gjennom strukturerte kapitler designet for progressiv læring. Spesiell fokus på AI-applikasjonsdistribusjon med Microsoft Foundry-integrasjon.

Hvorfor dette kurset er viktig for moderne utviklere

Basert på innsikter fra Microsoft Foundry Discord-fellesskapet, ønsker 45% av utviklere å bruke AZD for AI-arbeidsbelastninger, men møter utfordringer med:

  • Komplekse AI-arkitekturer med mange tjenester
  • Beste praksis for produksjonsdistribusjon av AI
  • Azure AI-tjenesteintegrasjon og konfigurasjon
  • Kostnadsoptimalisering for AI-arbeidsbelastninger
  • Feilsøking av AI-spesifikke distribusjonsproblemer

Læringsmål

Ved å fullføre dette strukturerte kurset vil du:

  • Mestre AZD-grunnleggende: Kjernebegreper, installasjon og konfigurasjon
  • Distribuere AI-applikasjoner: Bruke AZD med Microsoft Foundry-tjenester
  • Implementere Infrastruktur som kode: Administrere Azure-ressurser med Bicep-mal
  • Feilsøke distribusjoner: Løse vanlige problemer og debugge feil
  • Optimalisere for produksjon: Sikkerhet, skalering, overvåking og kostnadsstyring
  • Bygge multi-agent løsninger: Distribuere komplekse AI-arkitekturer

Før du begynner: Kontoer, tilgang og forutsetninger

Før du starter Kapittel 1, sørg for at du har følgende på plass. Installasjonstrinnene senere i denne guiden forutsetter at disse grunnleggende tingene allerede er håndtert.

  • Et Azure-abonnement: Du kan bruke et eksisterende abonnement fra jobb eller din egen konto, eller opprette en gratis prøveperiode for å komme i gang.
  • Tillatelse til å opprette Azure-ressurser: For de fleste øvelser bør du ha minst Bidragsyter-tilgang på målabonnementet eller ressursgruppen. Noen kapitler antar også at du kan opprette ressursgrupper, administrerte identiteter og RBAC-tildelinger.
  • En GitHub-konto: Dette er nyttig for å forke repositoriet, følge dine egne endringer og bruke GitHub Codespaces for workshoppen.
  • Forutsetninger for malens kjøringstid: Noen maler krever lokale verktøy som Node.js, Python, Java eller Docker. Kjør oppsettvalidatoren før du begynner, slik at du oppdager manglende verktøy tidlig.
  • Grunnleggende terminalkunnskap: Du trenger ikke å være ekspert, men du bør være komfortabel med å kjøre kommandoer som git clone, azd auth login, og azd up.

Jobber du i et bedriftsabonnement? Hvis Azure-miljøet ditt styres av en administrator, bekreft på forhånd at du kan distribuere ressurser i abonnementet eller ressursgruppen du planlegger å bruke. Hvis ikke, be om et sandkasseabonnement eller Bidragsyter-tilgang før du starter.

Ny til Azure? Start med ditt eget Azure-prøveabonnement eller betal-som-du-går-abonnement på https://aka.ms/azurefreetrial slik at du kan fullføre øvelsene fra start til slutt uten å vente på godkjenninger på leietakernivå.

🗺️ Kurskart: Rask navigering etter kapittel

Hvert kapittel har en dedikert README med læringsmål, raske startere og øvelser:

Kapittel Emne Leksjoner Varighet Vanskelighetsgrad
Kap 1: Grunnlag Komme i gang AZD Basics | Installasjon | Første prosjekt 30-45 min
Kap 2: AI-utvikling AI-første apper Foundry-integrasjon | AI-agenter | Modell distribusjon | Workshop 1-2 t ⭐⭐
Kap 3: Konfigurasjon Autentisering og sikkerhet Konfigurasjon | Autentisering & sikkerhet 45-60 min ⭐⭐
Kap 4: Infrastruktur IaC & distribusjon Distribusjonsveiledning | Provisionering 1-1.5 t ⭐⭐⭐
Kap 5: Multi-agent AI-agentløsninger Detaljhandelsscenario | Koordineringsmønstre 2-3 t ⭐⭐⭐⭐
Kap 6: Forhåndsdistribusjon Planlegging og validering Forundersøkelser | Kapasitetsplanlegging | SKU-valg | App Insights 1 t ⭐⭐
Kap 7: Feilsøking Debugging og feilretting Vanlige problemer | Feilsøking | AI-problemer 1-1.5 t ⭐⭐
Kap 8: Produksjon Bedriftsmønstre Produksjonspraksis 2-3 t ⭐⭐⭐⭐
🎓 Workshop Praktisk lab Introduksjon | Valg | Validering | Nedbryting | Konfigurasjon | Tilpasning | Nedrigging | Oppsummering 3-4 t ⭐⭐

Total kursvarighet: ~10-14 timer | Ferdighetsutvikling: Nybegynner → Klart for produksjon


📚 Læringskapitler

Velg din læringsvei basert på erfaringsnivå og mål

🚀 Kapittel 1: Grunnlag & rask start

Forutsetninger: Azure-abonnement, grunnleggende kjennskap til kommandolinje
Varighet: 30-45 minutter
Vanskelighet: ⭐

Hva du vil lære

  • Forstå grunnleggende om Azure Developer CLI
  • Installere AZD på din plattform
  • Din første vellykkede distribusjon

Læringsressurser

Praktiske øvelser

# Rask installasjonskontroll
azd version

# Distribuer din første applikasjon
azd init --template todo-nodejs-mongo
azd up

💡 Kapittelresultat: Distribuere en enkel webapplikasjon til Azure ved å bruke AZD

✅ Suksessvalidering:

# Etter å ha fullført kapittel 1, bør du kunne:
azd version              # Viser installert versjon
azd init --template todo-nodejs-mongo  # Initialiserer prosjekt
azd up                  # Distribuerer til Azure
azd show                # Viser URL for kjørende app
# Applikasjonen åpnes i nettleser og fungerer
azd down --force --purge  # Rydder opp ressurser

📊 Tidsbruk: 30-45 minutter
📈 Ferdighetsnivå etter: Kan distribuere grunnleggende applikasjoner på egen hånd
📈 Ferdighetsnivå etter: Kan distribuere grunnleggende applikasjoner på egen hånd


🤖 Kapittel 2: AI-første utvikling (Anbefalt for AI-utviklere)

Forutsetninger: Kapittel 1 fullført
Varighet: 1-2 timer
Vanskelighet: ⭐⭐

Hva du vil lære

  • Microsoft Foundry-integrasjon med AZD
  • Distribusjon av AI-drevne applikasjoner
  • Forståelse av AI-tjenestekonfigurasjoner

Læringsressurser

Praktiske øvelser

# Distribuer din første AI-applikasjon
azd init --template azure-search-openai-demo
azd up

# Prøv flere AI-maler
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Kapittelresultat: Distribuere og konfigurere en AI-drevet chatapplikasjon med RAG-funksjonalitet

✅ Suksessvalidering:

# Etter kapittel 2 skal du kunne:
azd init --template azure-search-openai-demo
azd up
# Teste AI-chatgrensesnittet
# Stille spørsmål og få AI-drevne svar med kilder
# Verifisere at søkeintegrasjonen fungerer
azd monitor  # Sjekke at Application Insights viser telemetri
azd down --force --purge

📊 Tidsbruk: 1-2 timer
📈 Ferdighetsnivå etter: Kan distribuere og konfigurere produksjonsklare AI-applikasjoner
💰 Kostnadsbevissthet: Forstå utviklingskostnader på $80-150/mnd, produksjonskostnader $300-3500/mnd

💰 Kostnadshensyn for AI-distribusjoner

Utviklingsmiljø (Estimert $80-150/mnd):

  • Microsoft Foundry-modeller (betal-som-du-går): $0-50/mnd (avhengig av token-bruk)
  • AI Search (grunnleggende nivå): $75/mnd
  • Container Apps (forbruk): $0-20/mnd
  • Lagring (standard): $1-5/mnd

Produksjonsmiljø (Estimert $300-3 500+/mnd):

  • Microsoft Foundry-modeller (PTU for stabil ytelse): $3 000+/mnd ELLER Betal-som-du-går med høyt volum
  • AI Search (standard nivå): $250/mnd
  • Container Apps (dedikert): $50-100/mnd
  • Application Insights: $5-50/mnd
  • Lagring (premium): $10-50/mnd

💡 Kostnadsoptimaliseringstips:

  • Bruk gratisnivå Microsoft Foundry-modeller for læring (Azure OpenAI 50 000 tokens/mnd inkludert)
  • Kjør azd down for å fjerne ressurser når du ikke aktivt utvikler
  • Start med forbruksbasert fakturering, oppgrader til PTU bare i produksjon
  • Bruk azd provision --preview for å estimere kostnader før distribusjon
  • Aktiver autoskalering: betal kun for faktisk bruk

Kostnadsmonitorering:

# Sjekk estimerte månedlige kostnader
azd provision --preview

# Overvåk faktiske kostnader i Azure-portalen
az consumption budget list --resource-group <your-rg>

⚙️ Kapittel 3: Konfigurasjon og autentisering

Forutsetninger: Kapittel 1 fullført
Varighet: 45-60 minutter
Vanskelighet: ⭐⭐

Hva du vil lære

  • Miljøkonfigurasjon og administrasjon
  • Autentisering og beste praksis for sikkerhet
  • Navngivning og organisering av ressurser

Læringsressurser

Praktiske øvelser

  • Konfigurer flere miljøer (utvikling, staging, produksjon)
  • Sett opp autentisering med administrert identitet
  • Implementer miljøspesifikke konfigurasjoner

💡 Kapittelresultat: Administrer flere miljøer med riktig autentisering og sikkerhet


🏗️ Kapittel 4: Infrastruktur som kode og distribusjon

Forutsetninger: Kapitler 1-3 fullført
Varighet: 1-1.5 timer
Vanskelighet: ⭐⭐⭐

Hva du vil lære

  • Avanserte distribusjonsmønstre
  • Infrastruktur som kode med Bicep
  • Strategier for ressursprovisjonering

Læringsressurser

Praktiske øvelser

  • Lag egendefinerte Bicep-maler
  • Distribuer multi-tjenesteapplikasjoner
  • Implementer blue-green distribusjonsstrategier

💡 Kapittelresultat: Distribuer komplekse multi-tjenesteapplikasjoner ved hjelp av egendefinerte infrastrukturen-maler


🎯 Kapittel 5: Multi-agent AI-løsninger (Avansert)

Forutsetninger: Kapitler 1-2 fullført
Varighet: 2-3 timer
Vanskelighet: ⭐⭐⭐⭐

Hva du vil lære

  • Arkitekturmønstre for multi-agent
  • Agent-orkestrering og koordinasjon
  • Produksjonsklare AI-distribusjoner

Læringsressurser

Praktiske øvelser

# Distribuer den komplette detaljhandelsløsningen med flere agenter
cd examples/retail-multiagent-arm-template
./deploy.sh

# Utforsk agentkonfigurasjoner
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Kapittelresultat: Distribuer og administrer en produksjonsklar multi-agent AI-løsning med Kunde- og Lager-agenter


🔍 Kapittel 6: Forhåndsdistribusjonsvalidering og planlegging

Forutsetninger: Kapittel 4 fullført
Varighet: 1 time
Vanskelighet: ⭐⭐

Hva du vil lære

  • Kapasitetsplanlegging og ressursvalidering
  • Strategier for SKU-valg
  • Forhåndssjekker og automatisering

Læringsressurser

Praktiske øvelser

  • Kjør valideringsskript for kapasitet
  • Optimaliser SKU-valg for kostnad
  • Implementer automatiserte forhåndssjekker før distribusjon

💡 Kapittelresultat: Valider og optimaliser distribusjoner før utførelse


🚨 Kapittel 7: Feilsøking og debugging

Forutsetninger: Fullført et distribusjonskapittel
Varighet: 1-1,5 timer
Kompleksitet: ⭐⭐

Hva du vil lære

  • Systematiske tilnærminger til debugging
  • Vanlige problemer og løsninger
  • AI-spesifikk feilsøking

Læringsressurser

Praktiske øvelser

  • Diagnostiser distribusjonsfeil
  • Løs autentiseringsproblemer
  • Debugg tilkoblingsproblemer til AI-tjenester

💡 Kapittelresultat: Selvstendig diagnostisere og løse vanlige distribusjonsproblemer


🏢 Kapittel 8: Produksjon og bedriftsmønstre

Forutsetninger: Kapitlene 1-4 fullført
Varighet: 2-3 timer
Kompleksitet: ⭐⭐⭐⭐

Hva du vil lære

  • Strategier for produksjonsdistribusjon
  • Sikkerhetsmønstre for bedriftsbruk
  • Overvåking og kostnadsoptimalisering

Læringsressurser

Praktiske øvelser

  • Implementer bedrifts-sikkerhetsmønstre
  • Sett opp omfattende overvåking
  • Distribuer til produksjon med riktig styring

💡 Kapittelresultat: Distribuer bedriftsklare applikasjoner med full produksjonskapasitet


🎓 Workshop Oversikt: Praktisk læringserfaring

⚠️ WORKSHOP STATUS: Aktiv utvikling
Workshop-materialet utvikles og forbedres for øyeblikket. Kjerne-moduler fungerer, men noen avanserte seksjoner er uferdige. Vi jobber aktivt med å fullføre alt innhold. Følg fremdriften →

Interaktive workshop-materialer

Omfattende praktisk læring med nettleserbaserte verktøy og guidede øvelser

Våre workshop-materialer gir en strukturert, interaktiv læringsopplevelse som utfyller det kapittelbaserte pensumet ovenfor. Workshoppen er designet for både selvstyrt læring og instruktørledede økter.

🛠️ Workshop-funksjoner

  • Nettleserbasert grensesnitt: Fullstendig MkDocs-basert workshop med søk, kopi og tema-funksjoner
  • GitHub Codespaces-integrasjon: Ett-klikks oppsett av utviklingsmiljø
  • Strukturert læringssti: 8-moduls guidede øvelser (totalt 3-4 timer)
  • Progressiv metodikk: Introduksjon → Valg → Validering → Nedbrytning → Konfigurasjon → Tilpasning → Nedrigging → Oppsummering
  • Interaktiv DevContainer-miljø: Forhåndskonfigurerte verktøy og avhengigheter

📚 Workshop modulstruktur

Workshoppen følger en 8-moduls progressiv metodikk som tar deg fra oppdagelse til mestring av distribusjon:

Modul Tema Hva du gjør Varighet
0. Introduksjon Workshop oversikt Forstå læringsmål, forutsetninger og workshop struktur 15 min
1. Valg Malutforsking Utforsk AZD-maler og velg riktig AI-mal for ditt scenario 20 min
2. Validering Distribuer og verifiser Distribuer malen med azd up og valider infrastruktur fungerer 30 min
3. Nedbrytning Forstå struktur Bruk GitHub Copilot til å utforske malarkitektur, Bicep-filer og kodeorganisering 30 min
4. Konfigurasjon Azure.yaml i dybden Mestre azure.yaml konfigurasjon, livssyklus-kroker og miljøvariabler 30 min
5. Tilpasning Gjør det ditt Aktiver AI Search, sporing, evaluering, og tilpass for ditt scenario 45 min
6. Nedrigging Rydd opp Trygt avvikle ressurser med azd down --purge 15 min
7. Oppsummering Neste steg Gå gjennom resultater, nøkkelkonsepter, og fortsett læringsreisen 15 min

Workshopflyt:

Introduction → Selection → Validation → Deconstruction → Configuration → Customization → Teardown → Wrap-up
     ↓            ↓           ↓              ↓               ↓              ↓            ↓           ↓
  Overview    Find the     Deploy &      Explore        Master         Customize     Clean up    Review &
             right        verify        code &        azure.yaml      for your      resources   next steps
             template                   structure                     scenario

🚀 Komme i gang med workshoppen

# Alternativ 1: GitHub Codespaces (Anbefalt)
# Klikk "Code" → "Create codespace on main" i depotet

# Alternativ 2: Lokal utvikling
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Følg oppsettsinstruksjonene i workshop/README.md

🎯 Workshop læringsmål

Ved å fullføre workshoppen vil deltakerne:

  • Distribuere produksjonsklare AI-applikasjoner: Bruke AZD med Microsoft Foundry-tjenester
  • Mestre multi-agent arkitekturer: Implementere koordinerte AI-agentløsninger
  • Implementere sikkerhetsbest practices: Konfigurere autentisering og tilgangskontroll
  • Optimalisere for skala: Designe kostnadseffektive og høyytelses distribusjoner
  • Feilsøke distribusjoner: Løse vanlige problemer selvstendig

📖 Workshop-ressurser

Perfekt for: Bedriftstrening, universitetskurs, selvstyrt læring og utviklerbootcamps.


📖 Grundig gjennomgang: AZD-funksjonalitet

Utover det grunnleggende gir AZD kraftige funksjoner for produksjonsdistribusjoner:

  • Malbaserte distribusjoner – Bruk forhåndsbygde maler for vanlige applikasjonsmønstre
  • Infrastruktur som kode – Administrer Azure-ressurser med Bicep eller Terraform
  • Integrerte arbeidsflyter – Søk, distribuer og overvåk applikasjoner sømløst
  • Utviklervennlig – Optimalisert for utviklerproduktivitet og brukeropplevelse

AZD + Microsoft Foundry: Perfekt for AI-distribusjoner

Hvorfor AZD for AI-løsninger? AZD adresserer de største utfordringene AI-utviklere møter:

  • AI-klare maler – Forhåndskonfigurerte maler for Microsoft Foundry-modeller, Cognitive Services og ML-arbeidsbelastninger
  • Sikre AI-distribusjoner – Innebygde sikkerhetsmønstre for AI-tjenester, API-nøkler og modelendepunkter
  • Produksjonsmønstre for AI – Beste praksis for skalerbare, kostnadseffektive AI-applikasjoner
  • Ende-til-ende AI-arbeidsflyter – Fra modellutvikling til produksjonsdistribusjon med riktig overvåking
  • Kostnadsoptimalisering – Smarte ressursallokering og skalering for AI-arbeidsbelastninger
  • Microsoft Foundry-integrasjon – Sømløs kobling til Microsoft Foundry-modellkatalog og endepunkter

🎯 Maler og eksempelbibliotek

Fremhevet: Microsoft Foundry-maler

Start her hvis du distribuerer AI-applikasjoner!

Merk: Disse malene viser forskjellige AI-mønstre. Noen er eksterne Azure Samples, andre er lokale implementasjoner.

Mal Kapittel Kompleksitet Tjenester Type
Get started with AI chat Kapittel 2 ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights Ekstern
Get started with AI agents Kapittel 2 ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights Ekstern
Azure Search + OpenAI Demo Kapittel 2 ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage Ekstern
OpenAI Chat App Quickstart Kapittel 2 AzureOpenAI + Container Apps + Application Insights Ekstern
Agent OpenAI Python Prompty Kapittel 5 ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty Ekstern
Contoso Chat RAG Kapittel 8 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps Ekstern
Retail Multi-Agent Solution Kapittel 5 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB Lokal

Fremhevet: Fullstendige læringsscenarioer

Produksjonsklare applikasjonsmaler kartlagt til læringskapitler

Mal Læringskapittel Kompleksitet Nøkkellæring
openai-chat-app-quickstart Kapittel 2 Grunnleggende AI distribusjonsmønstre
azure-search-openai-demo Kapittel 2 ⭐⭐ RAG-implementering med Azure AI Search
ai-document-processing Kapittel 4 ⭐⭐ Dokumentintelligens-integrasjon
agent-openai-python-prompty Kapittel 5 ⭐⭐⭐ Agentrammeverk og funksjonskall
contoso-chat Kapittel 8 ⭐⭐⭐ Enterprise AI-orchestration
retail-multi-agent-solution Kapittel 5 ⭐⭐⭐⭐ Multi-agent arkitektur med Customer og Inventory agenter

Læring etter eksempeltype

📌 Lokale vs. eksterne eksempler:
Lokale eksempler (i dette repoet) = Klare til bruk umiddelbart
Eksterne eksempler (Azure Samples) = Klon fra lenkede repositorier

Lokale eksempler (Klare til bruk)

  • Retail Multi-Agent Solution - Fullstendig produksjonsklar implementasjon med ARM-maler
    • Multi-agent arkitektur (Customer + Inventory agenter)
    • Omfattende overvåking og evaluering
    • Ett-klikk distribusjon via ARM-mal

Lokale eksempler - Containerapplikasjoner (Kapitler 2-5)

Omfattende containerdistribusjonseksempler i dette repoet:

  • Container App Examples - Fullstendig guide til containeriserte distribusjoner
    • Simple Flask API - Enkel REST API med scale-to-zero
    • Microservices Architecture - Produksjonsklar multi-service distribusjon
    • Rask start, produksjon og avanserte distribusjonsmønstre
    • Veiledning for overvåking, sikkerhet og kostnadsoptimalisering

Eksterne eksempler - Enkle applikasjoner (Kapitler 1-2)

Klon disse Azure Samples repositoriene for å komme i gang:

Eksterne eksempler - Databaseintegrasjon (Kapittel 3-4)

Eksterne eksempler - Avanserte mønstre (Kapittel 4-8)

Eksterne mal-samlinger


📚 Læringsressurser & Referanser

Rask referanse

Praktiske workshops

  • AI Workshop Lab - Gjør AI-løsningene dine klar for AZD-distribusjon (2-3 timer)
  • Interaktiv workshop - 8-modulers guidede øvelser med MkDocs og GitHub Codespaces
    • Følger: Introduksjon → Utvalg → Validering → Dekonstruksjon → Konfigurasjon → Tilpasning → Nedrigging → Oppsummering

Eksterne læringsressurser

AI-agentferdigheter for din redaktør

  • Microsoft Azure-ferdigheter på skills.sh - 37 åpne agent-ferdigheter for Azure AI, Foundry, distribusjon, feilsøking, kostnadsoptimalisering og mer. Installer dem i GitHub Copilot, Cursor, Claude Code eller hvilken som helst støttet agent:
    npx skills add microsoft/github-copilot-for-azure

🔧 Rask feilsøkingsguide

Vanlige problemer nybegynnere møter og umiddelbare løsninger:

❌ "azd: command not found"
# Installer AZD først
# Windows (PowerShell):
winget install microsoft.azd

# macOS:
brew tap azure/azd && brew install azd

# Linux:
curl -fsSL https://aka.ms/install-azd.sh | bash

# Bekreft installasjonen
azd version
❌ "Ingen abonnement funnet" eller "Abonnement ikke satt"
# List tilgjengelige abonnementer
az account list --output table

# Sett standardabonnement
az account set --subscription "<subscription-id-or-name>"

# Sett for AZD-miljø
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Verifiser
az account show
❌ "InsufficientQuota" eller "Kvote overskredet"
# Prøv en annen Azure-region
azd env set AZURE_LOCATION "westus2"
azd up

# Eller bruk mindre SKUer i utvikling
# Rediger infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" feiler halvveis
# Alternativ 1: Rengjør og prøv på nytt
azd down --force --purge
azd up

# Alternativ 2: Bare fiks infrastruktur
azd provision

# Alternativ 3: Sjekk detaljert status
azd show

# Alternativ 4: Sjekk logger i Azure Monitor
azd monitor --logs
❌ "Autentisering feilet" eller "Token utløpt"
# Autentiser på nytt for AZD
azd auth logout
azd auth login

# Valgfritt: oppdater også Azure CLI hvis du kjører az-kommandoer
az logout
az login

# Verifiser autentisering
az account show
❌ "Ressurs finnes allerede" eller navnekonflikter
# AZD genererer unike navn, men ved konflikt:
azd down --force --purge

# Prøv igjen med et nytt miljø
azd env new dev-v2
azd up
❌ Mal-distribusjon tar for lang tid

Normale ventetider:

  • Enkel webapp: 5-10 minutter
  • App med database: 10-15 minutter
  • AI-applikasjoner: 15-25 minutter (OpenAI-provisionering er treg)
# Sjekk fremdriften
azd show

# Hvis fast >30 minutter, sjekk Azure-portalen:
azd monitor --overview
# Se etter mislykkede distribusjoner
❌ "Tillatelse nektet" eller "Forbudt"
# Sjekk din Azure-rolle
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Du trenger minst rollen "Bidragsyter"
# Be din Azure-administrator om å gi:
# - Bidragsyter (for ressurser)
# - Brukertilgangsadministrator (for rolleoppgaver)
❌ Kan ikke finne URL for distribuert applikasjon
# Vis alle tjenestepunkter
azd show

# Eller åpne Azure Portal
azd monitor

# Sjekk spesifikk tjeneste
azd env get-values
# Se etter *_URL variabler

📚 Fullstendige feilsøkingsressurser


🎓 Kursfullføring & Sertifisering

Fremdriftssporing

Spor din læringsfremdrift gjennom hvert kapittel:

  • Kapittel 1: Grunnlag & Rask start ✅
  • Kapittel 2: AI-første utvikling ✅
  • Kapittel 3: Konfigurasjon & Autentisering ✅
  • Kapittel 4: Infrastruktur som kode & distribusjon ✅
  • Kapittel 5: Multi-agent AI-løsninger ✅
  • Kapittel 6: Validering før distribusjon & planlegging ✅
  • Kapittel 7: Feilsøking & debugging ✅
  • Kapittel 8: Produksjons- & bedriftsmønstre ✅

Læringsverifisering

Etter hvert kapittel, verifiser kunnskapen din ved å:

  1. Praktisk øvelse: Fullfør kapittelens hands-on distribusjon
  2. Kunnskapstjekk: Gå gjennom FAQ-seksjonen for ditt kapittel
  3. Fellesskapsdiskusjon: Del erfaringer i Azure Discord
  4. Neste kapittel: Gå videre til neste kompleksitetsnivå

Fordeler ved kursfullføring

Etter fullført kurs vil du ha:

  • Produksjonserfaring: Distribuert ekte AI-applikasjoner til Azure
  • Profesjonelle ferdigheter: Bedriftsklare distribusjonsmuligheter
  • Fellesskapsanerkjennelse: Aktiv medlem i Azure-utviklerfellesskapet
  • Karrierefremgang: Etterspurt AZD- og AI-distribusjonskompetanse

🤝 Fellesskap & Støtte

Få hjelp & støtte

Fellesskapsinnsikt fra Microsoft Foundry Discord

Siste meningsmåling fra #Azure-kanalen:

  • 45% av utviklere ønsker å bruke AZD for AI-arbeidsbelastninger
  • Topp utfordringer: Distribusjoner med flere tjenester, håndtering av legitimasjon, produksjonsklarhet
  • Mest etterspurt: AI-spesifikke maler, feilsøkingsguider, beste praksis

Bli med i vårt fellesskap for å:

  • Dele erfaringer med AZD + AI og få hjelp
  • Få tilgang til tidlige forhåndsvisninger av nye AI-maler
  • Bidra til beste praksis for AI-distribusjon
  • Påvirke fremtidig AI + AZD funksjonsutvikling

Bidra til kurset

Vi ønsker bidrag velkommen! Les vår Bidragsguide for detaljer om:

  • Forbedring av innhold: Forbedre eksisterende kapitler og eksempler
  • Nye eksempler: Legg til virkelige scenarier og maler
  • Oversettelse: Hjelp til å vedlikeholde støtte for flere språk
  • Feilrapporter: Forbedre nøyaktighet og klarhet
  • Fellesskapsstandarder: Følg våre inkluderende retningslinjer

📄 Kursinformasjon

Lisens

Dette prosjektet er lisensiert under MIT-lisensen - se LICENSE filen for detaljer.

Relaterte Microsoft læringsressurser

Vårt team produserer andre omfattende læringskurs:

LangChain

LangChain4j for Beginners LangChain.js for Beginners LangChain for Beginners

Azure / Edge / MCP / Agenter

AZD for Beginners Edge AI for Beginners MCP for Beginners AI Agents for Beginners


Generativ AI-serie

Generative AI for Beginners Generative AI (.NET) Generative AI (Java) Generative AI (JavaScript)


Kjerneopplæring

ML for Beginners Data Science for Beginners AI for Beginners Cybersecurity for Beginners Web Dev for Beginners IoT for Beginners XR Development for Beginners


Copilot-serien

Copilot for AI Paired Programming Copilot for C#/.NET Copilot Adventure


🗺️ Kursnavigasjon

🚀 Klar til å begynne å lære?

Begynnere: Start med Kapittel 1: Grunnlag & Rask start
AI-utviklere: Hopp til Kapittel 2: AI-Først Utvikling
Erfarne utviklere: Begynn med Kapittel 3: Konfigurasjon & Autentisering

Neste steg: Begynn Kapittel 1 - AZD Grunnleggende


Ansvarsfraskrivelse:
Dette dokumentet er oversatt ved hjelp av AI-oversettingstjenesten Co-op Translator. Selv om vi streber etter nøyaktighet, vennligst vær oppmerksom på at automatiske oversettelser kan inneholde feil eller unøyaktigheter. Det opprinnelige dokumentet på originalspråket bør betraktes som den autoritative kilden. For kritisk informasjon anbefales profesjonell menneskelig oversettelse. Vi fraskriver oss ansvar for eventuelle misforståelser eller feiltolkninger som måtte oppstå ved bruk av denne oversettelsen.