Skip to content

README.md

Latest commit

 

History

History
1058 lines (800 loc) · 57.8 KB

README.md

File metadata and controls

1058 lines (800 loc) · 57.8 KB

AZD Kezdőknek: Egy Strukturált Tanulási Út

AZD-for-beginners

GitHub watchers GitHub forks GitHub stars

Azure Discord Microsoft Foundry Discord

Automatikus Fordítások (Mindig Friss)

Arab | Bengáli | Bolgár | Burmai (Myanmar) | Kínai (Egyszerűsített) | Kínai (Hagyományos, Hong Kong) | Kínai (Hagyományos, Makaó) | Kínai (Hagyományos, Tajvan) | Horvát | Cseh | Dán | Holland | Észt | Finn | Francia | Német | Görög | Héber | Hindi | Magyar | Indonéz | Olasz | Japán | Kannada | Khmer | Koreai | Litván | Maláj | Malayalam | Marathi | Nepáli | Nigeriai pidgin | Norvég | Perzsa (Farsi) | Lengyel | Portugál (Brazília) | Portugál (Portugália) | Pandzsábi (Gurmukhi) | Román | Orosz | Szerb (Cirill) | Szlovák | Szlovén | Spanyol | Szuahéli | Svéd | Tagalog (Filippínó) | Tamil | Telugu | Thai | Török | Ukrán | Urdu | Vietnami

Inkább helyileg klónoznád?

Ez a tároló 50+ nyelvi fordítást tartalmaz, ami jelentősen megnöveli a letöltési méretet. Ha fordítások nélkül szeretnél klónozni, használj sparse checkout-ot:

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"

Így minden meglesz, ami a kurzus elvégzéséhez kell, jóval gyorsabb letöltéssel.

🆕 Mi Újság az azd-vel Ma

Az Azure Developer CLI túlnőtt a hagyományos webalkalmazások és API-k kezelésén. Ma az azd az egyetlen eszköz, amellyel bármilyen alkalmazást lehet telepíteni az Azure-ra – beleértve a mesterséges intelligencia vezérelt alkalmazásokat és intelligens ügynököket is.

Ez mit jelent számodra:

  • Az AI ügynökök most elsőrendű azd munkaterhelésként kezelhetők. Inicializálhatod, telepítheted és kezelheted az AI ügynök projekteket ugyanazzal az azd init → azd up folyamattal, amit már ismersz.
  • A Microsoft Foundry integráció közvetlenül beemeli a modelltelepítést, az ügynökök hosztolását és az AI szolgáltatások konfigurációját az azd sablon ökoszisztémába.
  • Az alapvető munkafolyamat változatlan maradt. Akár todo alkalmazást, mikro-szolgáltatást, vagy több ügynökből álló AI megoldást telepítesz, a parancsok ugyanazok.

Ha már használtad az azd-t korábban, az AI támogatás annak természetes kiterjesztése – nem egy külön eszköz vagy haladó útvonal. Ha most kezded, egyetlen munkafolyamatot tanulsz meg, ami mindenre működik.

🚀 Mi az Azure Developer CLI (azd)?

Az Azure Developer CLI (azd) egy fejlesztőbarát parancssori eszköz, amely leegyszerűsíti az alkalmazások Azure-ra történő telepítését. Ahelyett, hogy manuálisan hoznál létre és csatlakoztatnál tucatnyi Azure erőforrást, egyetlen parancs segítségével telepíthetsz egész alkalmazásokat.

Az azd up varázslata

# Ez az egyetlen parancs mindent elvégez:
# ✅ Létrehozza az összes Azure-erőforrást
# ✅ Konfigurálja a hálózatot és a biztonságot
# ✅ Lefordítja az alkalmazás kódját
# ✅ Telepíti az Azure-ba
# ✅ Megad egy működő URL-címet
azd up

Ennyi! Nem kell kattintgatni az Azure Portalon, nem kell bonyolult ARM sablonokat megtanulni előre, nincs manuális konfiguráció – csak működő alkalmazás az Azure-on.

❓ Azure Developer CLI vs Azure CLI: Mi a Különbség?

Ez a kezdők leggyakoribb kérdése. Íme a rövid válasz:

Jellemző Azure CLI (az) Azure Developer CLI (azd)
Cél Egyedi Azure erőforrások kezelése Teljes alkalmazások telepítése
Megközelítés Infrastruktúra-központú Alkalmazás-központú
Példa az webapp create --name myapp... azd up
Tanulási görbe Azure szolgáltatások ismerete szükséges Csak az alkalmazásodat kell ismerned
Legalkalmasabb DevOps, Infrastruktúra Fejlesztők, prototípus készítés

Egyszerű Analógia

  • Azure CLI olyan, mintha minden építőeszközt megkapnál egy ház felépítéséhez – kalapács, fűrész, szögek. Bármit fel tudsz építeni, de ismerned kell az építkezést.
  • Azure Developer CLI olyan, mintha felbérelnél egy vállalkozót – elmondod, mit szeretnél, ők pedig elvégzik az építést.

Mikor melyiket használd

Szituáció Használd ezt
"Gyorsan szeretném telepíteni a webalkalmazásom" azd up
"Csak egy tárolófiókot akarok létrehozni" az storage account create
"Teljes AI alkalmazást fejlesztek" azd init --template azure-search-openai-demo
"Egy specifikus Azure erőforrást kell hibakeresnem" az resource show
"Pár perc alatt éles környezetbe akarok telepíteni" azd up --environment production

Együtt is használhatók!

Az azd az Azure CLI-t használja a háttérben. Mindkettőt használhatod:

# Telepítse az alkalmazását az AZD-vel
azd up

# Ezután finomhangolja a konkrét erőforrásokat az Azure CLI-vel
az webapp config set --name myapp --always-on true

🌟 Találj sablonokat az Awesome AZD-ben

Ne kezdj nulláról! Az Awesome AZD a közösség által készített, azonnal telepíthető sablonok gyűjteménye:

Erőforrás Leírás
🔗 Awesome AZD Galéria Böngéssz 200+ sablon között, egykattintásos telepítéssel
🔗 Sablont beküldeni Küldd be saját sablonodat a közösségnek
🔗 GitHub tároló Csillagozd és böngészd a forrást

Népszerű AI sablonok az Awesome AZD-ből

# RAG-csevegés Microsoft Foundry modellekkel + MI-keresés
azd init --template azure-search-openai-demo

# Gyors MI-csevegőalkalmazás
azd init --template openai-chat-app-quickstart

# MI-ügynökök Foundry-ügynökökkel
azd init --template get-started-with-ai-agents

🎯 Kezdés 3 lépésben

Mielőtt elkezdenéd, győződj meg róla, hogy a géped készen áll az adott sablon telepítésére:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Ha bármelyik ellenőrzés megbukik, előbb azt javítsd, majd folytasd a gyors kezdéssel.

1. lépés: Azd telepítése (2 perc)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

2. lépés: Azd hitelesítés

# Nem kötelező, ha a kurzus során közvetlenül az Azure CLI parancsokat kívánja használni
az login

# Szükséges az AZD munkafolyamatokhoz
azd auth login

Ha nem vagy biztos, melyikre van szükséged, kövesd a teljes beállítási folyamatot a Telepítés és beállítás dokumentumban.

3. lépés: Az első alkalmazás telepítése

# Inicializálás sablonból
azd init --template todo-nodejs-mongo

# Telepítés Azure-ra (mindent létrehoz!)
azd up

🎉 Ennyi! Az alkalmazásod most már élő az Azure-on.

Takarítás (Ne feledd!)

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

📚 Hogyan használd ezt a kurzust

Ez a kurzus fokozatos tanulásra lett tervezve – kezd ott, ahol kényelmes és lépésről lépésre haladj előre:

Tapasztalatod Innen kezd
Totál új vagy az Azure-ban 1. fejezet: Alapok
Ismered az Azure-t, az azd újdonság 1. fejezet: Alapok
AI alkalmazásokat szeretnél telepíteni 2. fejezet: AI-Központú Fejlesztés
Gyakorlati kézbe vétel érdekel 🎓 Interaktív Műhely - 3-4 órás vezetett labor
Éles minták kellenek 8. fejezet: Termelés & Vállalati minták

Gyors beállítás

  1. Forkold ezt a tárolót: GitHub forks
  2. Klónozd: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. Kérj segítséget: Azure Discord Közösség

Inkább helyileg klónoznád?

Ez a tároló 50+ nyelvi fordítást tartalmaz, ami jelentősen megnöveli a letöltési méretet. Ha fordítások nélkül szeretnél klónozni, használj sparse checkout-ot:

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'

Így minden meglesz, ami a kurzus elvégzéséhez kell, jóval gyorsabb letöltéssel.

Kurzus Áttekintés

Sajátítsd el az Azure Developer CLI-t (azd) strukturált fejezeteken keresztül, amelyek a fokozatos tanulásra vannak kialakítva. Különös hangsúly az AI alkalmazások telepítésén Microsoft Foundry integrációval.

Miért lényeges ez a kurzus a modern fejlesztőknek

A Microsoft Foundry Discord közösség visszajelzései alapján, a fejlesztők 45%-a az azd-t szeretné használni AI munkaterhelésekhez, de akadályokkal találkoznak:

  • Komplex többszolgáltatásos AI architektúrák
  • AI termelési telepítési legjobb gyakorlatok
  • Azure AI szolgáltatás integráció és konfiguráció
  • AI munkaterhelések költséghatékonyságának optimalizálása
  • AI-specifikus telepítési problémák hibakeresése

Tanulási célok

A kurzus elvégzése után:

  • Azd alapok mesterfokon: Alapfogalmak, telepítés és konfiguráció
  • AI alkalmazások telepítése: Azd használata Microsoft Foundry szolgáltatásokkal
  • Infrastruktúra kód formájában: Azure erőforrások kezelése Bicep sablonokkal
  • Telepítések hibakeresése: Gyakori problémák megoldása és hibák feltárása
  • Termelésre optimalizálás: Biztonság, skálázás, monitoring, költségkezelés
  • Több ügynökös megoldások építése: Komplex AI architektúrák telepítése

Mielőtt elkezdenéd: Fiókok, elérések és feltételezések

Mielőtt megkezdenéd az 1. fejezetet, győződj meg róla, hogy a következők rendben vannak. A telepítési lépések később ezek meglétét feltételezik.

  • Egy Azure-előfizetés: Használhat meglévő előfizetést a munkahelyéről vagy saját fiókjából, vagy létrehozhat egy ingyenes próbaverziót a kezdéshez.
  • Engedély az Azure-erőforrások létrehozására: A legtöbb gyakorlatnál legalább Contributor jogosultsággal kell rendelkeznie a cél előfizetésben vagy erőforráscsoportban. Egyes fejezetek feltételezhetik, hogy erőforráscsoportokat, kezelt identitásokat és RBAC-hozzárendeléseket is létre tud hozni.
  • Egy GitHub-fiók: Hasznos a tárház fork-olásához, a saját módosítások nyomon követéséhez, valamint a GitHub Codespaces használatához a workshop során.
  • Sablon futtatási előfeltételek: Egyes sablonok helyi eszközöket igényelnek, például Node.js, Python, Java vagy Docker. A hiányzó eszközök korai felismeréséhez futtassa a beállítás érvényesítőjét a kezdés előtt.
  • Alapvető terminál-ismeretek: Nem kell szakértőnek lennie, de kényelmesen kell tudnia futtatni parancsokat, mint például git clone, azd auth login és azd up.

Vállalati előfizetésben dolgozik?
Ha Azure-környezetét egy rendszergazda kezeli, előre egyeztesse, hogy tud-e erőforrásokat telepíteni az előfizetésbe vagy erőforráscsoportba, amelyet használni szeretne. Ha nem, kérjen sandbox előfizetést vagy Contributor jogosultságot a kezdés előtt.

Új az Azure-ban?
Kezdje a saját Azure próbaverziójával vagy a pay-as-you-go előfizetésével a https://aka.ms/azurefreetrial oldalon, hogy a gyakorlatokat végig tudja csinálni bérlőszintű jóváhagyások nélkül.

🗺️ Tanfolyam térkép: Gyors navigáció fejezetenként

Minden fejezethez tartozik egy dedikált README a tanulási célokkal, gyors kezdettel és gyakorlatokkal:

Fejezet Téma Leckék Időtartam Bonyolultság
1. fejezet: Alapok Bevezetés AZD alapok | Telepítés | Első projekt 30-45 perc ⭐
2. fejezet: AI fejlesztés AI-előre épített alkalmazások Foundry integráció | AI ügynökök | Modell telepítés | Workshop 1-2 óra ⭐⭐
3. fejezet: Konfiguráció Hitelesítés és biztonság Konfiguráció | Hitelesítés & Biztonság 45-60 perc ⭐⭐
4. fejezet: Infrastruktúra IaC & Telepítés Telepítési útmutató | Provisioning 1-1,5 óra ⭐⭐⭐
5. fejezet: Többügynök AI ügynök megoldások Kiskereskedelmi forgatókönyv | Koordinációs minták 2-3 óra ⭐⭐⭐⭐
6. fejezet: Telepítés előtti lépések Tervezés & Ellenőrzés Előzetes ellenőrzések | Kapacitástervezés | SKU kiválasztás | App Insights 1 óra ⭐⭐
7. fejezet: Hibakeresés Hibakeresés & Javítás Gyakori problémák | Hibakeresés | AI problémák 1-1,5 óra ⭐⭐
8. fejezet: Éles környezet Vállalati minták Éles gyakorlatok 2-3 óra ⭐⭐⭐⭐
🎓 Workshop Gyakorlati labor Bevezető | Kiválasztás | Érvényesítés | Deconstruct | Konfiguráció | Testreszabás | Szétszedés | Összegzés 3-4 óra ⭐⭐

A teljes tanfolyam időtartama: ~10-14 óra | Készségfejlődés: Kezdő → Éles környezetre kész

📚 Tanulási fejezetek

Válassza ki tanulási útját tapasztalat és célok alapján

🚀 1. fejezet: Alapok & Gyors kezdés

Előfeltételek: Azure-előfizetés, alapvető parancssori ismeretek
Időtartam: 30-45 perc
Bonyolultság: ⭐

Amit tanulni fog

  • Az Azure Developer CLI alapjainak megértése
  • AZD telepítése a platformjára
  • Az első sikeres telepítés

Tanulási források

Gyakorlati feladatok

# Gyors telepítés ellenőrzése
azd version

# Telepítse első alkalmazását
azd init --template todo-nodejs-mongo
azd up

💡 A fejezet eredménye: Egyszerű webalkalmazás sikeres telepítése Azure-ra AZD segítségével

✅ Siker igazolása:

# Az 1. fejezet elvégzése után képes leszel:
azd version              # Megmutatja a telepített verziót
azd init --template todo-nodejs-mongo  # Inicializálja a projektet
azd up                  # Telepíti az Azure-ra
azd show                # Megjeleníti a futó alkalmazás URL-jét
# Az alkalmazás megnyílik a böngészőben és működik
azd down --force --purge  # Takarítja a forrásokat

📊 Időráfordítás: 30-45 perc
📈 Készségszint a fejezet után: Képes alapalkalmazások önálló telepítésére
📈 Készségszint a fejezet után: Képes alapalkalmazások önálló telepítésére

🤖 2. fejezet: AI-első fejlesztés (AI fejlesztőknek ajánlott)

Előfeltételek: 1. fejezet befejezése
Időtartam: 1-2 óra
Bonyolultság: ⭐⭐

Amit tanulni fog

  • Microsoft Foundry integráció AZD-vel
  • Mesterséges intelligenciával támogatott alkalmazások telepítése
  • AI szolgáltatások konfigurációjának megértése

Tanulási források

Gyakorlati feladatok

# Telepítse első mesterséges intelligencia alkalmazását
azd init --template azure-search-openai-demo
azd up

# Próbáljon ki további MI sablonokat
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 A fejezet eredménye: AI-alapú chatalkalmazás telepítése és konfigurálása RAG képességekkel

✅ Siker igazolása:

# A 2. fejezet után képes leszel:
azd init --template azure-search-openai-demo
azd up
# Tesztelni az AI csevegőfelületet
# Kérdéseket feltenni és AI által támogatott válaszokat kapni forrásokkal
# Ellenőrizni, hogy a keresési integráció működik
azd monitor  # Megnézni, hogy az Application Insights megjeleníti a telemetriát
azd down --force --purge

📊 Időráfordítás: 1-2 óra
📈 Készségszint a fejezet után: Képes éles környezetre kész AI alkalmazások telepítésére és konfigurálására
💰 Költségtudatosság: Érti az kb. 80-150$/hó fejlesztési, 300-3500$/hó éles költségeket

💰 Költségek figyelembevétele AI telepítések esetén

Fejlesztési környezet (becsült 80-150$/hó):

  • Microsoft Foundry modellek (pay-as-you-go): 0-50$/hó (token-használattól függően)
  • AI keresés (Alap csomag): 75$/hó
  • Container App-ek (Fogyasztás alapú): 0-20$/hó
  • Tárolás (Standard): 1-5$/hó

Éles környezet (becsült 300-3500+$/hó):

  • Microsoft Foundry modellek (PTU a stabil teljesítményért): 3000+$/hó VAGY pay-as-you-go nagy volumen esetén
  • AI keresés (Standard csomag): 250$/hó
  • Container App-ek (Dedikált): 50-100$/hó
  • Application Insights: 5-50$/hó
  • Tárolás (Prémium): 10-50$/hó

💡 Költségoptimalizálási tippek:

  • Használja a Free Tier Microsoft Foundry modelleket tanuláshoz (Azure OpenAI havi 50 000 tokennel együtt)
  • Az aktív fejlesztés szüneteltetésekor futtassa az azd down parancsot az erőforrások felszabadításához
  • Kezdje fogyasztás alapú számlázással, PTU-ra csak éles környezetben váltson
  • Használja az azd provision --preview parancsot a költségek előzetes becsléséhez telepítés előtt
  • Kapcsolja be az automatikus skálázást: csak a tényleges használatért fizet

Költségfigyelés:

# Becsült havi költségek ellenőrzése
azd provision --preview

# Aktuális költségek figyelése az Azure Portálon
az consumption budget list --resource-group <your-rg>

⚙️ 3. fejezet: Konfiguráció & Hitelesítés

Előfeltételek: 1. fejezet befejezése
Időtartam: 45-60 perc
Bonyolultság: ⭐⭐

Amit tanulni fog

  • Környezeti konfiguráció és menedzsment
  • Hitelesítés és biztonsági bevált gyakorlatok
  • Erőforrásnévzés és szervezés

Tanulási források

Gyakorlati feladatok

  • Több környezet konfigurálása (fejlesztői, teszt, éles)
  • Kezelt identitás alapú hitelesítés beállítása
  • Környezet-specifikus konfigurációk megvalósítása

💡 A fejezet eredménye: Több környezet kezelése megfelelő hitelesítéssel és biztonsággal

🏗️ 4. fejezet: Infrastruktúra kódként & Telepítés

Előfeltételek: 1-3. fejezet befejezése
Időtartam: 1-1,5 óra
Bonyolultság: ⭐⭐⭐

Amit tanulni fog

  • Haladó telepítési minták
  • Infrastruktúra kódként Bicep használatával
  • Erőforrás-provisioning stratégiák

Tanulási források

Gyakorlati feladatok

  • Egyedi Bicep sablonok készítése
  • Több szolgáltatásos alkalmazások telepítése
  • Blue-green telepítési stratégiák megvalósítása

💡 A fejezet eredménye: Összetett több szolgáltatásos alkalmazások telepítése egyedi infrastruktúra sablonokkal

🎯 5. fejezet: Többügynök AI megoldások (Haladó)

Előfeltételek: 1-2. fejezet befejezése
Időtartam: 2-3 óra
Bonyolultság: ⭐⭐⭐⭐

Amit tanulni fog

  • Többügynök architektúra minták
  • Ügynök-orchesztráció és koordináció
  • Éles környezetre kész AI telepítések

Tanulási források

Gyakorlati feladatok

# Telepítse az egész kiskereskedelmi többügynökös megoldást
cd examples/retail-multiagent-arm-template
./deploy.sh

# Fedezze fel az ügynök konfigurációkat
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 A fejezet eredménye: Többügynök AI megoldáséles környezetbe telepítése és kezelése Ügyfél és Készlet ügynökökkel

🔍 6. fejezet: Telepítés előtti érvényesítés & tervezés

Előfeltételek: 4. fejezet befejezése
Időtartam: 1 óra
Bonyolultság: ⭐⭐

Amit megtanulsz

  • Kapacitástervezés és erőforrás-validálás
  • SKU kiválasztási stratégiák
  • Előzetes ellenőrzések és automatizálás

Tanulási források

Gyakorlati feladatok

  • Futtass kapacitás-ellenőrző szkripteket
  • Optimalizáld a SKU-k kiválasztását költség szerint
  • Valósíts meg automatizált előtelepítési ellenőrzéseket

💡 Fejezet eredménye: Ellenőrizd és optimalizáld a telepítéseket a végrehajtás előtt

🚨 7. fejezet: Hibakeresés és hibajavítás

Előfeltételek: Bármely telepítési fejezet teljesítve
Időtartam: 1-1,5 óra
Bonyolultság: ⭐⭐

Amit megtanulsz

  • Szisztematikus hibakeresési módszerek
  • Gyakori problémák és megoldások
  • AI-specifikus hibajavítás

Tanulási források

Gyakorlati feladatok

  • Diagnosztizáld a telepítési hibákat
  • Oldd meg az azonosítási problémákat
  • Hibakeresés AI szolgáltatás-kapcsolódási hibák esetén

💡 Fejezet eredménye: Önállóan diagnosztizáld és oldd meg a gyakori telepítési problémákat

🏢 8. fejezet: Gyártási és vállalati minták

Előfeltételek: 1-4. fejezet teljesítve
Időtartam: 2-3 óra
Bonyolultság: ⭐⭐⭐⭐

Amit megtanulsz

  • Gyártási telepítési stratégiák
  • Vállalati biztonsági minták
  • Felügyelet és költség-optimalizálás

Tanulási források

Gyakorlati feladatok

  • Valósíts meg vállalati biztonsági mintákat
  • Állíts be átfogó monitorozást
  • Telepíts gyártási környezetbe megfelelő irányítással

💡 Fejezet eredménye: Telepíts vállalati szintű alkalmazásokat teljes gyártási képességekkel

🎓 Workshop áttekintése: Gyakorlati tanulási élmény

⚠️ WORKSHOP ÁLLAPOT: Folyamatban lévő fejlesztés
A workshop anyagait jelenleg fejlesztjük és finomítjuk. Az alapmodulok működőképesek, de néhány haladó rész még nem teljes. Aktívan dolgozunk a teljes tartalom elkészítésén. Nyomon követés →

Interaktív workshop anyagok

Átfogó, gyakorlati tanulás böngészőalapú eszközökkel és vezetett gyakorlatokkal

Workshop anyagaink strukturált, interaktív tanulási élményt nyújtanak, amely kiegészíti a fent bemutatott fejezet-alapú tananyagot. A workshop önálló és oktató vezette tanulásra is alkalmas.

🛠️ Workshop jellemzők

  • Böngészőalapú felület: Teljes MkDocs-alapú workshop kereséssel, másolással és témakezeléssel
  • GitHub Codespaces integráció: Egykattintásos fejlesztői környezet beállítás
  • Strukturált tanulási útvonal: 8 modul vezérelt gyakorlatokkal (összesen 3-4 óra)
  • Fokozatos módszertan: Bevezetés → Kiválasztás → Érvényesítés → De-konstruálás → Konfiguráció → Testreszabás → Lebontás → Összefoglalás
  • Interaktív DevContainer környezet: Előre konfigurált eszközök és függőségek

📚 Workshop modul struktúra

A workshop egy 8 modulból álló fokozatos módszertan, amely a felfedezéstől a telepítés mesterségéig vezet:

Modul Téma Mi a teendő Időtartam
0. Bevezetés Workshop áttekintés Értelmezd a tanulási célokat, előfeltételeket és workshop struktúrát 15 perc
1. Kiválasztás Sablon felfedezés Fedezd fel az AZD sablonokat és válaszd ki a megfelelő AI sablont a helyzethez 20 perc
2. Érvényesítés Telepítés és ellenőrzés Telepítsd a sablont azd up paranccsal és ellenőrizd az infrastruktúrát 30 perc
3. De-konstruálás Szerkezet megértése Használd a GitHub Copilotot a sablon architektúra, Bicep fájlok és kód szervezésének felfedezésére 30 perc
4. Konfiguráció azure.yaml mélyreható Mesterkedj az azure.yaml konfigurációban, életciklus horgonyokban és környezeti változókban 30 perc
5. Testreszabás Személyre szabás Engedélyezd az AI keresést, nyomon követést, értékelést és alakítsd a saját forgatókönyved szerint 45 perc
6. Lebontás Erőforrások tisztítása Biztonságosan töröld az erőforrásokat azd down --purge paranccsal 15 perc
7. Összefoglalás Következő lépések Tekintsd át az elért eredményeket, kulcsfogalmakat és folytasd a tanulási utadat 15 perc

Workshop menet:

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

🚀 Workshop elindítása

# 1. lehetőség: GitHub Codespaces (ajánlott)
# Kattints a "Code" → "Create codespace on main" menüpontra a tárolóban

# 2. lehetőség: Helyi fejlesztés
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Kövesd a workshop/README.md-ben található telepítési útmutatót

🎯 Workshop tanulási eredmények

A workshop elvégzésével a résztvevők:

  • Telepítsenek gyártási AI alkalmazásokat: Használják az AZD-t Microsoft Foundry szolgáltatásokkal
  • Mesterkedjenek többügynökös architektúrákban: Valósítsanak meg koordinált AI ügynök megoldásokat
  • Alkalmazzanak biztonsági legjobb gyakorlatokat: Konfigurálják az azonosítást és hozzáférés-vezérlést
  • Optimalizálják a méretezést: Tervezzenek költséghatékony, teljesítményorientált telepítéseket
  • Hibakeresést végezzenek telepítéseken: Önállóan oldják meg a gyakori problémákat

📖 Workshop források

Ideális: Vállalati képzésekhez, egyetemi kurzusokhoz, önálló tanuláshoz és fejlesztői bootcampokhoz.

📖 Mélyebb betekintés: AZD képességek

Az alapok mellett az AZD igen erős funkciókat biztosít gyártási telepítésekhez:

  • Sablonalapú telepítések - Használj előre elkészített sablonokat gyakori alkalmazási mintákhoz
  • Infrastruktúra kódonként - Azure erőforrások kezelése Bicep vagy Terraform segítségével
  • Integrált munkafolyamatok - Zökkenőmentes erőforrás-provisionálás, telepítés és monitorozás
  • Fejlesztőbarát - Optimalizált a fejlesztői termelékenység és élmény érdekében

AZD + Microsoft Foundry: Tökéletes AI telepítésekhez

Miért AZD az AI megoldásokhoz? AZD kezeli az AI fejlesztők fő kihívásait:

  • AI-kész sablonok - Előre konfigurált sablonok Microsoft Foundry modellekhez, kognitív szolgáltatásokhoz és ML munkaterhelésekhez
  • Biztonságos AI telepítések - Beépített biztonsági minták AI szolgáltatásokhoz, API kulcsokhoz és model végpontokhoz
  • Gyártási AI minták - Legjobb gyakorlatok skálázható, költséghatékony AI alkalmazás telepítésekhez
  • End-to-end AI munkafolyamatok - A modellfejlesztéstől a gyártásba vitelig megfelelő monitorozással
  • Költségoptimalizálás - Intelligens erőforrás-allokáció és skálázási stratégiák AI munkaterhelésekhez
  • Microsoft Foundry integráció - Zökkenőmentes kapcsolat a Microsoft Foundry modell katalógussal és végpontokkal

🎯 Sablonok és példatár

Kiemelt: Microsoft Foundry sablonok

Kezdj itt, ha AI alkalmazásokat telepítesz!

Megjegyzés: Ezek a sablonok különféle AI mintákat demonstrálnak. Némelyik külső Azure mintákból, mások helyi implementációk.

Sablon Fejezet Bonyolultság Szolgáltatások Típus
Kezdés AI chattel 2. fejezet ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights Külső
Kezdés AI ügynökökkel 2. fejezet ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights Külső
Azure Search + OpenAI Demo 2. fejezet ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage Külső
OpenAI Chat App Gyorsindító 2. fejezet ⭐ AzureOpenAI + Container Apps + Application Insights Külső
Agent OpenAI Python Prompty 5. fejezet ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty Külső
Contoso Chat RAG 8. fejezet ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps Külső
Retail Többügynökös megoldás 5. fejezet ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB Helyi

Kiemelt: Teljes tanulási forgatókönyvek

Gyártásra kész alkalmazás sablonok a tanulási fejezetek szerint

Sablon Tanulási fejezet Bonyolultság Fő tanulási pont
openai-chat-app-quickstart 2. fejezet ⭐ Alap AI telepítési minták
azure-search-openai-demo 2. fejezet ⭐⭐ RAG megvalósítás Azure AI kereséssel
ai-document-processing 4. fejezet ⭐⭐ Dokumentum intelligencia integráció
agent-openai-python-prompty 5. fejezet ⭐⭐⭐ Ügynök keretrendszer és függvényhívás
contoso-chat 8. fejezet ⭐⭐⭐ Vállalati AI összehangolás
retail-multi-agent-solution 5. fejezet ⭐⭐⭐⭐ Többügynökös architektúra vevő és készlet ügynökökkel

Példák típus szerint

📌 Helyi vs Külső példák:
Helyi példák (ebben a repo-ban) = Azonnal használatra készek
Külső példák (Azure Samples) = Klónozd a linkelt tárolókat

Helyi példák (azonnal használható)

  • Retail Többügynökös megoldás - Teljes gyártásra kész implementáció ARM sablonokkal
    • Többügynökös architektúra (Vevő + Készlet ügynökök)
    • Átfogó monitorozás és értékelés
    • Egykattintásos telepítés ARM sablonnal

Helyi példák - Konténeres alkalmazások (2-5. fejezet)

Átfogó konténeres telepítési példák ebben a tárolóban:

Külső példák - Egyszerű alkalmazások (1-2. fejezet)

Klónozd ezeket az Azure Sample tárolókat a kezdéshez:

Külső példák - Adatbázis integráció (3-4. fejezet)

Külső példák - Haladó minták (4-8. fejezet)

Külső sablon gyűjtemények

📚 Tanulási források és hivatkozások

Gyors hivatkozások

Gyakorlati műhelyek

  • MI Műhely labor - Tegye MI megoldásait az AZD-vel telepíthetővé (2-3 óra)
  • Interaktív műhely - 8 modulból álló irányított gyakorlat MkDocs és GitHub Codespaces használattal
    • Menete: Bevezetés → Kiválasztás → Érvényesítés → Lebontás → Konfiguráció → Testreszabás → Bontás → Összegzés

Külső tanulási források

MI ügynök képességek az Ön szerkesztőjéhez

  • Microsoft Azure képességek a skills.sh-en - 37 nyílt ügynök képesség Azure MI, Foundry, telepítés, diagnosztika, költségoptimalizálás és még sok más területen. Telepítse őket GitHub Copilotba, Cursorba, Claude Code-ba vagy bármely támogatott ügynökbe: 
    npx skills add microsoft/github-copilot-for-azure

🔧 Gyors hibaelhárítási útmutató

Gyakori kezdői hibák és azonnali megoldásaik:

❌ "azd: parancs nem található" 
# Először telepítse az AZD-t
# Windows (PowerShell):
winget install microsoft.azd

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

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

# A telepítés ellenőrzése
azd version
❌ "Nem található előfizetés" vagy "Előfizetés nincs beállítva" 
# Elérhető előfizetések listázása
az account list --output table

# Alapértelmezett előfizetés beállítása
az account set --subscription "<subscription-id-or-name>"

# AZD környezet beállítása
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Ellenőrzés
az account show
❌ "InsufficientQuota" vagy "Kvóta túllépve" 
# Próbáljon ki másik Azure régiót
azd env set AZURE_LOCATION "westus2"
azd up

# Vagy használjon kisebb SKU-kat fejlesztés közben
# Szerkessze az infra/main.parameters.json fájlt:
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" a folyamat közepén hibát jelez 
# 1. lehetőség: Tisztítás és újrapróbálkozás
azd down --force --purge
azd up

# 2. lehetőség: Csak az infrastruktúra javítása
azd provision

# 3. lehetőség: Részletes állapot ellenőrzése
azd show

# 4. lehetőség: Naplók ellenőrzése az Azure Monitorban
azd monitor --logs
❌ "Hitelesítés sikertelen" vagy "Token lejárt" 
# Jelentkezzen be újra az AZD-hez
azd auth logout
azd auth login

# Opcionális: frissítse az Azure CLI-t is, ha az az parancsokat futtatja
az logout
az login

# Hitelesítés ellenőrzése
az account show
❌ "Erőforrás már létezik" vagy névütközések 
# Az AZD egyedi neveket generál, de ha konfliktus van:
azd down --force --purge

# Akkor próbálkozz újra friss környezettel
azd env new dev-v2
azd up
❌ A sablon telepítése túl sokáig tart

Normál várakozási idők:

  • Egyszerű webalkalmazás: 5-10 perc
  • Adatbázis alkalmazással: 10-15 perc
  • MI alkalmazások: 15-25 perc (OpenAI előkészítés lassú)
# Haladás ellenőrzése
azd show

# Ha több mint 30 percig akad el, ellenőrizze az Azure Portált:
azd monitor --overview
# Keresse meg a sikertelen telepítéseket
❌ "Engedély megtagadva" vagy "Tiltott" 
# Ellenőrizze az Azure szerepkörét
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Legalább "Contributor" szerepkörre van szüksége
# Kérje az Azure adminisztrátorától, hogy adja meg:
# - Contributor (erőforrásokhoz)
# - User Access Administrator (szerepkör-hozzárendelésekhez)
❌ Nem található a telepített alkalmazás URL-je 
# Az összes szolgáltatási végpont megjelenítése
azd show

# Vagy nyissa meg az Azure portált
azd monitor

# Ellenőrizzen egy adott szolgáltatást
azd env get-values
# Keressen *_URL változókat

📚 Teljes hibaelhárítási források

🎓 Tanfolyam befejezése és tanúsítvány

Haladás követése

Kövesse tanulási előrehaladását minden fejezeten keresztül:

  • 1. fejezet: Alapok és gyors indulás ✅
  • 2. fejezet: MI-első fejlesztés ✅
  • 3. fejezet: Konfiguráció és hitelesítés ✅
  • 4. fejezet: Infrastruktúra mint kód és telepítés ✅
  • 5. fejezet: Többügynökös MI megoldások ✅
  • 6. fejezet: Előzetes telepítési érvényesítés és tervezés ✅
  • 7. fejezet: Hibaelhárítás és hibakeresés ✅
  • 8. fejezet: Termelési és vállalati minták ✅

Tanulás ellenőrzése

Minden fejezet befejezése után ellenőrizze tudását:

  1. Gyakorlati feladat: Fejezeti gyakorlati telepítés befejezése
  2. Tudásellenőrzés: A fejezet GYIK szakaszának áttekintése
  3. Közösségi beszélgetés: Tapasztalat megosztása az Azure Discordban
  4. Következő fejezet: Haladás magasabb szintű fejezetre

Tanfolyam befejezésének előnyei

Az összes fejezet befejezésével rendelkezni fog:

  • Termelési tapasztalat: Valós MI alkalmazások telepítése Azure-ba
  • Szakmai készségek: Vállalati szintű telepítési képességek
  • Közösségi elismerés: Aktív tagja az Azure fejlesztői közösségnek
  • Karrier előrelépés: Keresett AZD és MI telepítési szakértelem

🤝 Közösség és támogatás

Segítség és támogatás

Közösségi betekintések a Microsoft Foundry Discordról

Legutóbbi szavazás eredményei a #Azure csatornán:

  • 45% fejlesztő szeretné használni az AZD-t MI munkaterhelésekhez
  • Fő kihívások: Több szolgáltatás telepítése, hitelesítő adatok kezelése, termelési készség
  • Leggyakrabban kért: MI-specifikus sablonok, hibaelhárítási útmutatók, bevált gyakorlatok

Csatlakozzon közösségünkhöz, hogy:

  • Megoszthassa AZD + MI tapasztalatait és segítséget kapjon
  • Korai hozzáférést kapjon új MI sablonokhoz
  • Hozzájáruljon MI telepítési legjobb gyakorlataihoz
  • Befolyásolja a jövőbeni MI + AZD fejlesztéseket

Hozzájárulás a tanfolyamhoz

Szívesen fogadunk hozzájárulásokat! Kérjük, olvassa el a Hozzájárulási útmutatót az alábbiakról:

  • Tartalom fejlesztések: Meglévő fejezetek és példák tökéletesítése
  • Új példák: Valós helyzeteket és sablonokat adjon hozzá
  • Fordítás: Segítsen a többnyelvű támogatás fenntartásában
  • Hibajelentések: Pontosság és érthetőség javítása
  • Közösségi szabályok: Befogadó közösségi irányelvek követése

📄 Tanfolyam információk

Licenc

Ez a projekt az MIT licenc alatt áll - részletekért lásd a LICENSE fájlt.

Kapcsolódó Microsoft tanulási források

Csapatunk más átfogó tanfolyamokat is készít:

LangChain

LangChain4j kezdőknek LangChain.js kezdőknek LangChain kezdőknek

Azure / Edge / MCP / Ügynökök

AZD kezdőknek Edge MI kezdőknek MCP kezdőknek MI ügynökök kezdőknek

Generatív MI sorozat

Generatív MI kezdőknek Generatív MI (.NET) Generatív MI (Java) Generatív MI (JavaScript)

Alapvető tanulás

Gépi tanulás kezdőknek Data Science for Beginners AI for Beginners Cybersecurity for Beginners Web Dev for Beginners IoT for Beginners XR Development for Beginners

Copilot sorozat

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

🗺️ Tanfolyam navigáció

🚀 Készen állsz a tanulásra?

Kezdőknek: Kezdd a 1. fejezettel: Alapok és Gyors kezdés
AI fejlesztőknek: Ugorj a 2. fejezethez: AI-első fejlesztés
Tapasztalt fejlesztőknek: Kezdd a 3. fejezettel: Beállítás és hitelesítés

Következő lépések: Kezdd az 1. fejezettel - AZD alapok →

Felelősségkizárás:
Ez a dokumentum az AI fordító szolgáltatás, a Co-op Translator segítségével készült. Bár a pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti, anyanyelvi dokumentum tekintendő hiteles forrásnak. Kritikus információk esetén professzionális emberi fordítást javaslunk. Nem vállalunk felelősséget az ebből a fordításból adódó félreértésekért vagy félreértelmezésekért.