AZD dla początkujących: Uporządkowana ścieżka nauki

Automatyczne tłumaczenia (zawsze aktualne)

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese

Wolisz sklonować lokalnie?

To repozytorium zawiera tłumaczenia na ponad 50 języków, co znacząco zwiększa rozmiar pobierania. Aby sklonować bez tłumaczeń, użyj sparse checkout:

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"

To da Ci wszystko, czego potrzebujesz, aby ukończyć kurs z dużo szybszym pobieraniem.

🆕 Co nowego w azd dzisiaj

Azure Developer CLI rozwinął się poza tradycyjne aplikacje webowe i API. Dziś azd to jedno narzędzie do wdrażania dowolnych aplikacji w Azure — w tym aplikacji zasilanych SI i inteligentnych agentów.

Co to dla Ciebie oznacza:

• Agenci SI są teraz pełnoprawnymi obciążeniami azd. Możesz inicjalizować, wdrażać i zarządzać projektami agentów SI za pomocą tego samego workflow azd init → azd up, które już znasz.
• Integracja z Microsoft Foundry umożliwia wdrażanie modeli, hostowanie agentów i konfigurację usług SI bezpośrednio w ekosystemie szablonów azd.
• Podstawowy workflow nie uległ zmianie. Niezależnie, czy wdrażasz aplikację todo, mikroserwis czy kompleksowe rozwiązanie z wieloma agentami SI, polecenia są takie same.

Jeśli już korzystałeś z azd, wsparcie dla SI jest naturalnym rozszerzeniem — nie osobnym narzędziem czy zaawansowanym torem. Jeśli zaczynasz od zera, nauczysz się jednego workflow, które działa we wszystkim.

🚀 Czym jest Azure Developer CLI (azd)?

Azure Developer CLI (azd) to przyjazne dla deweloperów narzędzie wiersza polecenia, które upraszcza wdrażanie aplikacji do Azure. Zamiast ręcznie tworzyć i łączyć dziesiątki zasobów Azure, możesz wdrożyć całe aplikacje jednym poleceniem.

Magia azd up

# To jedno polecenie robi wszystko:
# ✅ Tworzy wszystkie zasoby Azure
# ✅ Konfiguruje sieć i zabezpieczenia
# ✅ Buduje kod Twojej aplikacji
# ✅ Wdraża do Azure
# ✅ Daje działający adres URL
azd up

To wszystko! Bez klikania w Azure Portal, bez uczenia się skomplikowanych szablonów ARM, bez ręcznej konfiguracji — po prostu działające aplikacje w Azure.

❓ Azure Developer CLI czy Azure CLI: Jaka jest różnica?

To najczęstsze pytanie początkujących. Oto prosta odpowiedź:

Prosta analogia

• Azure CLI to jak mieć wszystkie narzędzia do budowy domu — młotki, piły, gwoździe. Możesz zbudować wszystko, ale musisz znać się na budowie.
• Azure Developer CLI to jak zatrudnić wykonawcę — opisujesz, co chcesz, a oni zajmują się budową.

Kiedy używać którego

Działają razem!

AZD korzysta z Azure CLI pod spodem. Możesz używać obu:

# Wdróż swoją aplikację za pomocą AZD
azd up

# Następnie dopracuj konkretne zasoby za pomocą Azure CLI
az webapp config set --name myapp --always-on true

🌟 Znajdź szablony w Awesome AZD

Nie zaczynaj od zera! Awesome AZD to zbiór gotowych do wdrożenia szablonów stworzonych przez społeczność:

Popularne szablony AI z Awesome AZD

# Czat RAG z modelami Microsoft Foundry + wyszukiwaniem AI
azd init --template azure-search-openai-demo

# Szybka aplikacja czatu AI
azd init --template openai-chat-app-quickstart

# Agenci AI z agentami Foundry
azd init --template get-started-with-ai-agents

🎯 Zacznij w 3 krokach

Zanim zaczniesz, upewnij się, że Twoja maszyna jest gotowa do szablonu, który chcesz wdrożyć:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Jeśli którykolwiek z wymaganych testów nie przejdzie, najpierw to napraw, a potem kontynuuj szybki start.

Krok 1: Zainstaluj AZD (2 minuty)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

Krok 2: Uwierzytelnij się dla AZD

# Opcjonalne, jeśli planujesz używać poleceń Azure CLI bezpośrednio w tym kursie
az login

# Wymagane dla przepływów pracy AZD
azd auth login

Jeśli nie jesteś pewien czego potrzebujesz, przejdź pełny proces konfiguracji opisany w Instalacja i konfiguracja.

Krok 3: Wdróż swoją pierwszą aplikację

# Zainicjalizuj z szablonu
azd init --template todo-nodejs-mongo

# Wdróż do Azure (utworzy wszystko!)
azd up

🎉 To wszystko! Twoja aplikacja jest teraz dostępna w Azure.

Posprzątaj (Nie zapomnij!)

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

📚 Jak korzystać z tego kursu

Ten kurs jest zaprojektowany jako program nauki progresywnej — zacznij tam, gdzie czujesz się pewnie i idź dalej:

Szybka konfiguracja

1. Forkuj to repozytorium:
2. Sklonuj je: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
3. Zdobądź pomoc: Społeczność Azure Discord

Wolisz sklonować lokalnie?

To repozytorium zawiera tłumaczenia na ponad 50 języków, co znacząco zwiększa rozmiar pobierania. Aby sklonować bez tłumaczeń, użyj sparse checkout:

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'

To da Ci wszystko, czego potrzebujesz, aby ukończyć kurs z dużo szybszym pobieraniem.

Przegląd kursu

Opanuj Azure Developer CLI (azd) poprzez uporządkowane rozdziały zaprojektowane do nauki krok po kroku. Szczególny nacisk na wdrażanie aplikacji SI z integracją Microsoft Foundry.

Dlaczego ten kurs jest niezbędny dla nowoczesnych deweloperów

Na podstawie informacji ze społeczności Microsoft Foundry Discord, 45% deweloperów chce używać AZD do obciążeń SI, ale napotyka wyzwania związane z:

• Złożonymi architekturami SI wykorzystującymi wiele usług
• Najlepszymi praktykami produkcyjnego wdrażania SI
• Integracją i konfiguracją usług Azure SI
• Optymalizacją kosztów obciążeń SI
• Rozwiązywaniem problemów specyficznych dla wdrożeń SI

Cele nauki

Po ukończeniu tego uporządkowanego kursu będziesz potrafił:

• Opanować podstawy AZD: kluczowe koncepcje, instalację i konfigurację
• Wdrażać aplikacje SI: używać AZD z usługami Microsoft Foundry
• Wdrażać infrastrukturę jako kod: zarządzać zasobami Azure za pomocą szablonów Bicep
• Rozwiązywać problemy we wdrożeniach: usuwać popularne błędy i debugować
• Optymalizować na produkcji: zagadnienia bezpieczeństwa, skalowalności, monitoringu i zarządzania kosztami
• Budować rozwiązania wieloagentowe: wdrażać złożone architektury SI

Zanim zaczniesz: konta, dostęp i założenia

Przed rozpoczęciem rozdziału 1 upewnij się, że masz następujące elementy. Kroki instalacji w kolejnych sekcjach zakładają, że te kwestie są już załatwione.

• Subskrypcja Azure: Możesz użyć istniejącej subskrypcji z pracy lub własnego konta albo utworzyć bezpłatną wersję próbną, aby rozpocząć.
• Uprawnienia do tworzenia zasobów Azure: Do większości ćwiczeń powinieneś mieć co najmniej dostęp Współtwórcy do docelowej subskrypcji lub grupy zasobów. Niektóre rozdziały mogą również zakładać, że potrafisz tworzyć grupy zasobów, tożsamości zarządzane oraz przypisania RBAC.
• Konto GitHub: Przydatne do forka repozytorium, śledzenia własnych zmian oraz korzystania z GitHub Codespaces podczas warsztatów.
• Wymagania narzędzi uruchomieniowych szablonów: Niektóre szablony wymagają lokalnych narzędzi takich jak Node.js, Python, Java lub Docker. Uruchom walidator instalacji przed rozpoczęciem, aby wcześnie wykryć brakujące narzędzia.
• Podstawowa znajomość terminala: Nie musisz być ekspertem, ale powinieneś czuć się komfortowo uruchamiając polecenia takie jak git clone, azd auth login oraz azd up.

Pracujesz w subskrypcji korporacyjnej?
Jeśli Twoje środowisko Azure jest zarządzane przez administratora, upewnij się wcześniej, że możesz wdrażać zasoby w subskrypcji lub grupie zasobów, którą planujesz używać. Jeśli nie, poproś o subskrypcję sandbox lub dostęp Współtwórcy przed rozpoczęciem.

Nowy w Azure?
Zacznij od własnej wersji próbnej Azure lub subskrypcji pay-as-you-go na https://aka.ms/azurefreetrial, aby móc wykonać ćwiczenia kompleksowo bez konieczności oczekiwania na zatwierdzenia na poziomie dzierżawy.

🗺️ Mapa kursu: Szybka nawigacja według rozdziału

Każdy rozdział ma dedykowany plik README z celami nauki, szybkim startem i ćwiczeniami:

Całkowity czas kursu: ~10-14 godzin | Postęp umiejętności: Początkujący → Gotowy do produkcji

📚 Rozdziały do nauki

Wybierz ścieżkę nauki zgodnie z poziomem doświadczenia i celami

🚀 Rozdział 1: Podstawy i szybki start

Wymagania wstępne: subskrypcja Azure, podstawowa znajomość wiersza poleceń
Czas trwania: 30-45 minut
Złożoność: ⭐

Czego się nauczysz

• Podstawy Azure Developer CLI
• Instalacja AZD na Twojej platformie
• Twoje pierwsze udane wdrożenie

Materiały do nauki

• 🎯 Zacznij tutaj: Co to jest Azure Developer CLI?
• 📖 Teoria: Podstawy AZD – podstawowe pojęcia i terminologia
• ⚙️ Instalacja: Instalacja i konfiguracja – przewodniki specyficzne dla platformy
• 🛠️ Praktyka: Twój pierwszy projekt – tutorial krok po kroku
• 📋 Szybka ściąga: Cheat Sheet poleceń

Ćwiczenia praktyczne

# Szybkie sprawdzenie instalacji
azd version

# Wdróż swoją pierwszą aplikację
azd init --template todo-nodejs-mongo
azd up

💡 Efekt rozdziału: Pomyślnie wdrożona prosta aplikacja webowa na Azure z użyciem AZD

✅ Kryteria sukcesu:

# Po ukończeniu rozdziału 1 powinieneś być w stanie:
azd version              # Pokazuje zainstalowaną wersję
azd init --template todo-nodejs-mongo  # Inicjalizuje projekt
azd up                  # Wdraża do Azure
azd show                # Wyświetla URL działającej aplikacji
# Aplikacja otwiera się w przeglądarce i działa
azd down --force --purge  # Czyści zasoby

📊 Czas potrzebny: 30-45 minut
📈 Poziom umiejętności: Potrafi samodzielnie wdrażać podstawowe aplikacje

🤖 Rozdział 2: AI-First Development (Polecany dla developerów AI)

Wymagania wstępne: ukończony rozdział 1
Czas trwania: 1-2 godziny
Złożoność: ⭐⭐

Czego się nauczysz

• Integracja Microsoft Foundry z AZD
• Wdrażanie aplikacji zasilanych AI
• Zrozumienie konfiguracji usług AI

Materiały do nauki

• 🎯 Zacznij tutaj: Integracja Microsoft Foundry
• 🤖 Agenci AI: Przewodnik po agentach AI – wdrażanie inteligentnych agentów z AZD
• 📖 Wzorce: Wdrożenie modelu AI – wdrażanie i zarządzanie modelami AI
• 🛠️ Warsztat: Laboratorium AI – przygotuj swoje rozwiązania AI pod AZD
• 🎥 Interaktywny przewodnik: Materiały warsztatowe – nauka w przeglądarce z MkDocs * środowisko DevContainer
• 📋 Szablony: Szablony Microsoft Foundry
• 📝 Przykłady: Przykłady wdrożeń AZD

Ćwiczenia praktyczne

# Wdróż swoją pierwszą aplikację AI
azd init --template azure-search-openai-demo
azd up

# Wypróbuj dodatkowe szablony AI
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Efekt rozdziału: Wdrożona i skonfigurowana aplikacja czatu zasilana AI z funkcjami RAG

✅ Kryteria sukcesu:

# Po rozdziale 2 powinieneś być w stanie:
azd init --template azure-search-openai-demo
azd up
# Przetestować interfejs czatu AI
# Zadawać pytania i otrzymywać odpowiedzi zasilane przez AI wraz ze źródłami
# Zweryfikować, czy integracja wyszukiwania działa
azd monitor  # Sprawdzić, czy Application Insights wyświetla telemetrię
azd down --force --purge

📊 Czas potrzebny: 1-2 godziny
📈 Poziom umiejętności: Potrafi wdrażać i konfigurować aplikacje AI gotowe do produkcji
💰 Świadomość kosztów: Zrozumienie kosztów rozwojowych $80-150/mies., kosztów produkcyjnych $300-3500/mies.

💰 Rozważania kosztowe dla wdrożeń AI

Środowisko developerskie (szacunkowo $80-150/mies.):

• Modele Microsoft Foundry (Pay-as-you-go): $0-50/mies. (zależnie od zużycia tokenów)
• AI Search (poziom podstawowy): $75/mies.
• Container Apps (konsumpcja): $0-20/mies.
• Storage (standard): $1-5/mies.

Środowisko produkcyjne (szacunkowo $300-3,500+/mies.):

• Modele Microsoft Foundry (PTU dla stabilnej wydajności): $3000+/mies. LUB Pay-as-you-go przy dużej skali
• AI Search (poziom standardowy): $250/mies.
• Container Apps (dedykowane): $50-100/mies.
• Application Insights: $5-50/mies.
• Storage (premium): $10-50/mies.

💡 Wskazówki optymalizacyjne kosztów:

• Korzystaj z Bezpłatnego poziomu modeli Microsoft Foundry do nauki (w Azure OpenAI 50,000 tokenów/mies. wliczone)
• Używaj azd down do deaktywacji zasobów, gdy nie rozwijasz aktywnie
• Zacznij od rozliczania na zasadzie konsumpcji, na PTU przejdź dopiero w produkcji
• Użyj azd provision --preview do szacowania kosztów przed wdrożeniem
• Włącz autoskalowanie: płacisz tylko za rzeczywiste użycie

Monitorowanie kosztów:

# Sprawdź szacowane miesięczne koszty
azd provision --preview

# Monitoruj rzeczywiste koszty w Azure Portal
az consumption budget list --resource-group <your-rg>

⚙️ Rozdział 3: Konfiguracja i uwierzytelnianie

Wymagania wstępne: ukończony rozdział 1
Czas trwania: 45-60 minut
Złożoność: ⭐⭐

Czego się nauczysz

• Konfiguracja i zarządzanie środowiskiem
• Najlepsze praktyki uwierzytelniania i bezpieczeństwa
• Nazewnictwo i organizacja zasobów

Materiały do nauki

• 📖 Konfiguracja: Przewodnik konfiguracji – ustawianie środowiska
• 🔐 Bezpieczeństwo: Wzorce uwierzytelniania i tożsamości zarządzanej
• 📝 Przykłady: Przykład aplikacji bazodanowej – przykłady AZD dla baz danych

Ćwiczenia praktyczne

• Konfiguracja wielu środowisk (dev, staging, prod)
• Konfiguracja uwierzytelniania z tożsamością zarządzaną
• Implementacja konfiguracji specyficznych dla środowiska

💡 Efekt rozdziału: Zarządzaj wieloma środowiskami z właściwym uwierzytelnianiem i bezpieczeństwem

🏗️ Rozdział 4: Infrastruktura jako kod i wdrożenie

Wymagania wstępne: ukończone rozdziały 1-3
Czas trwania: 1-1,5 godziny
Złożoność: ⭐⭐⭐

Czego się nauczysz

• Zaawansowane wzorce wdrożeniowe
• Infrastruktura jako kod za pomocą Bicep
• Strategie provisioningu zasobów

Materiały do nauki

• 📖 Wdrożenie: Przewodnik wdrożenia – kompletne workflow
• 🏗️ Provisioning: Provisioning zasobów – zarządzanie zasobami Azure
• 📝 Przykłady: Przykład aplikacji kontenerowej – wdrożenia konteneryzowane

Ćwiczenia praktyczne

• Tworzenie własnych szablonów Bicep
• Wdrażanie aplikacji wieloserwisowych
• Implementacja strategii wdrożenia blue-green

💡 Efekt rozdziału: Wdrażaj złożone aplikacje wieloserwisowe z użyciem niestandardowych szablonów infrastruktury

🎯 Rozdział 5: Rozwiązania AI Multi-Agent (Zaawansowany)

Wymagania wstępne: ukończone rozdziały 1-2
Czas trwania: 2-3 godziny
Złożoność: ⭐⭐⭐⭐

Czego się nauczysz

• Wzorce architektury multi-agentowej
• Orkiestracja i koordynacja agentów
• Produkcyjne wdrożenia AI

Materiały do nauki

• 🤖 Projekt specjalny: Rozwiązanie retail multi-agent – kompletna implementacja
• 🛠️ Szablony ARM: Pakiet szablonów ARM multi-agent – wdrożenie jednym kliknięciem
• 📖 Architektura: Wzorce koordynacji multi-agent

Ćwiczenia praktyczne

# Wdróż kompletne rozwiązanie wieloagentowe dla handlu detalicznego
cd examples/retail-multiagent-arm-template
./deploy.sh

# Zbadaj konfiguracje agentów
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Efekt rozdziału: Wdrażanie i zarządzanie produkcyjnym rozwiązaniem AI multi-agent z agentami obsługi klienta i magazynowymi

🔍 Rozdział 6: Walidacja i planowanie przed wdrożeniem

Wymagania wstępne: ukończony rozdział 4
Czas trwania: 1 godzina
Złożoność: ⭐⭐

Czego się nauczysz

• Planowanie pojemności i walidacja zasobów
• Strategie wyboru SKU
• Kontrole wstępne i automatyzacja

Materiały do nauki

• 📊 Planowanie: Capacity Planning - Walidacja zasobów
• 💰 Wybór: SKU Selection - Wybory opłacalne kosztowo
• ✅ Walidacja: Pre-flight Checks - Zautomatyzowane skrypty

Ćwiczenia praktyczne

• Uruchom skrypty walidacji pojemności
• Optymalizuj wybór SKU pod kątem kosztów
• Wdroż zautomatyzowane kontrole przed wdrożeniem

💡 Rezultat rozdziału: Zweryfikuj i optymalizuj wdrożenia przed ich realizacją

🚨 Rozdział 7: Rozwiązywanie problemów i debugowanie

Wymagania wstępne: ukończony dowolny rozdział wdrożeniowy
Czas trwania: 1-1,5 godziny
Poziom trudności: ⭐⭐

Czego się nauczysz

• Systematyczne podejścia do debugowania
• Typowe problemy i ich rozwiązania
• Specyficzne techniki rozwiązywania problemów AI

Materiały do nauki

• 🔧 Typowe problemy: Common Issues - FAQ i rozwiązania
• 🕵️ Debugowanie: Debugging Guide - Strategie krok po kroku
• 🤖 Problemy AI: AI-Specific Troubleshooting - Problemy z usługami AI

Ćwiczenia praktyczne

• Diagnozuj awarie wdrożeń
• Rozwiąż problemy z uwierzytelnianiem
• Debuguj łączność usług AI

💡 Rezultat rozdziału: Samodzielnie diagnozuj i rozwiązuj powszechne problemy wdrożeniowe

🏢 Rozdział 8: Wzorce produkcyjne i korporacyjne

Wymagania wstępne: ukończone rozdziały 1-4
Czas trwania: 2-3 godziny
Poziom trudności: ⭐⭐⭐⭐

Czego się nauczysz

• Strategie wdrożeń produkcyjnych
• Wzorce bezpieczeństwa korporacyjnego
• Monitorowanie i optymalizacja kosztów

Materiały do nauki

• 🏭 Produkcja: Production AI Best Practices - Wzorce korporacyjne
• 📝 Przykłady: Microservices Example - Złożone architektury
• 📊 Monitorowanie: Application Insights integration - Monitorowanie

Ćwiczenia praktyczne

• Wdroż wzorce bezpieczeństwa korporacyjnego
• Skonfiguruj kompleksowe monitorowanie
• Wdróż do produkcji z właściwym nadzorem

💡 Rezultat rozdziału: Wdróż aplikacje gotowe do produkcji z pełną funkcjonalnością produkcyjną

🎓 Przegląd warsztatów: Praktyczne doświadczenie w nauce

⚠️ STATUS WARSZTATU: Aktywny rozwój
Materiały warsztatowe są w trakcie opracowywania i dopracowywania. Podstawowe moduły działają, ale niektóre zaawansowane sekcje są niekompletne. Pracujemy nad ukończeniem całej zawartości. Śledź postęp →

Interaktywne materiały warsztatowe

Kompleksowa nauka praktyczna z narzędziami w przeglądarce i ćwiczeniami z przewodnikiem

Nasze materiały warsztatowe oferują uporządkowane, interaktywne doświadczenie edukacyjne, które uzupełnia powyższy program rozdziałowy. Warsztat jest zaprojektowany zarówno do nauki samodzielnej, jak i sesji prowadzonych przez instruktora.

🛠️ Funkcje warsztatu

• Interfejs w przeglądarce: Kompletny warsztat oparty na MkDocs z wyszukiwaniem, kopiowaniem i motywami
• Integracja z GitHub Codespaces: Jeden klik na konfigurację środowiska deweloperskiego
• Struktura nauki: 8 modułów ćwiczeń z przewodnikiem (3-4 godziny łącznie)
• Stopniowana metodologia: Wprowadzenie → Wybór → Walidacja → Dekonstrukcja → Konfiguracja → Dostosowanie → Demontaż → Podsumowanie
• Interaktywne środowisko DevContainer: Wstępnie skonfigurowane narzędzia i zależności

📚 Struktura modułów warsztatowych

Warsztat wykorzystuje 8-modułową metodologię progresywną, która prowadzi od odkrycia do mistrzostwa wdrożeniowego:

Przebieg warsztatu:

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

🚀 Rozpoczęcie warsztatu

# Opcja 1: GitHub Codespaces (zalecane)
# Kliknij "Code" → "Create codespace on main" w repozytorium

# Opcja 2: Lokalny rozwój
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Postępuj zgodnie z instrukcjami konfiguracji w workshop/README.md

🎯 Cele nauki warsztatu

Uczestnicy po ukończeniu warsztatu:

• Wdróż aplikacje AI produkcyjne: Używaj AZD z usługami Microsoft Foundry
• Opanuj wieloagentowe architektury: Wdróż skoordynowane rozwiązania z agentami AI
• Stosuj najlepsze praktyki bezpieczeństwa: Konfiguruj uwierzytelnianie i kontrolę dostępu
• Optymalizuj skalę: Projektuj opłacalne i wydajne wdrożenia
• Rozwiązuj problemy wdrożeniowe: Samodzielnie usuwaj typowe błędy

📖 Materiały warsztatowe

• 🎥 Przewodnik interaktywny: Workshop Materials - Środowisko nauki w przeglądarce
• 📋 Instrukcje etap po etapie:
  • 0. Wprowadzenie - Przegląd i cele warsztatu
  • 1. Wybór - Znajdź i wybierz szablony AI
  • 2. Walidacja - Wdróż i zweryfikuj szablony
  • 3. Dekonstrukcja - Eksploracja architektury szablonu
  • 4. Konfiguracja - Opanuj azure.yaml
  • 5. Dostosowanie - Spersonalizuj do scenariusza
  • 6. Demontaż - Posprzątaj zasoby
  • 7. Podsumowanie - Podsumowanie i dalsze kroki
• 🛠️ Laboratorium AI: AI Workshop Lab - Ćwiczenia skoncentrowane na AI
• 💡 Szybki start: Workshop Setup Guide - Konfiguracja środowiska

Idealne dla: Szkoleń korporacyjnych, studiów uniwersyteckich, nauki indywidualnej i bootcampów dla programistów.

📖 Głębokie nurkowanie: możliwości AZD

Poza podstawami, AZD oferuje potężne funkcje dla wdrożeń produkcyjnych:

• Wdrożenia oparte na szablonach - Użyj gotowych szablonów dla typowych wzorców aplikacji
• Infrastruktura jako kod - Zarządzaj zasobami Azure przy pomocy Bicep lub Terraform
• Zintegrowane przepływy pracy - Bezproblemowe provisionowanie, wdrażanie i monitorowanie aplikacji
• Przyjazne dla dewelopera - Optymalizacja produktywności i doświadczenia programisty

AZD + Microsoft Foundry: idealne do wdrożeń AI

Dlaczego AZD dla rozwiązań AI? AZD odpowiada na główne wyzwania deweloperów AI:

• Szablony gotowe na AI - Prekonfigurowane szablony dla modeli Microsoft Foundry, Cognitive Services i obciążeń ML
• Bezpieczne wdrożenia AI - Wbudowane wzorce bezpieczeństwa dla usług AI, kluczy API i endpointów modeli
• Produkcyjne wzorce AI - Najlepsze praktyki dla skalowalnych, opłacalnych wdrożeń AI
• End-to-End przepływy pracy AI - Od rozwoju modelu po wdrożenie produkcyjne z odpowiednim monitorowaniem
• Optymalizacja kosztów - Inteligentne strategie alokacji zasobów i skalowania dla obciążeń AI
• Integracja Microsoft Foundry - Płynne połączenie z katalogiem modeli i endpointami Microsoft Foundry

🎯 Biblioteka szablonów i przykładów

Polecane: szablony Microsoft Foundry

Zacznij tutaj, jeśli wdrażasz aplikacje AI!

Uwaga: Te szablony demonstrują różne wzorce AI. Niektóre to zewnętrzne przykłady Azure, inne implementacje lokalne.

Polecane: kompletne scenariusze nauki

Szablony aplikacji gotowych do produkcji powiązane z rozdziałami nauki

Nauka poprzez przykłady

📌 Przykłady lokalne vs. zewnętrzne:
Przykłady lokalne (w tym repozytorium) = gotowe do użycia od razu
Przykłady zewnętrzne (Azure Samples) = klonuj z powiązanych repozytoriów

Przykłady lokalne (gotowe do użycia)

• Retail Multi-Agent Solution - Kompleksowa implementacja produkcyjna z szablonami ARM
  • Architektura multi-agent (Klient + agenci magazynu)
  • Kompleksowe monitorowanie i ewaluacja
  • Jednoklikowe wdrożenie za pomocą szablonu ARM

Przykłady lokalne - Aplikacje kontenerowe (rozdziały 2-5)

Kompleksowe przykłady wdrożeń kontenerowych w tym repozytorium:

• Container App Examples - Kompletny przewodnik po wdrożeniach kontenerów
  • Proste API Flask - Podstawowe REST API ze skalowaniem do zera
  • Architektura mikroserwisów - Produkcyjne wdrożenie multi-serwisowe
  • Szybki start, produkcja i zaawansowane wzorce wdrożeń
  • Monitorowanie, bezpieczeństwo i wskazówki dotyczące optymalizacji kosztów

Przykłady zewnętrzne - proste aplikacje (rozdziały 1-2)

Sklonuj te repozytoria Azure Samples, by zacząć:

• Prosta aplikacja WWW - Node.js + MongoDB - Podstawowe wzorce wdrożeń
• Statyczna strona - React SPA - Wdrożenie zawartości statycznej
• Container App - Python Flask - Wdrożenie REST API

Przykłady zewnętrzne - integracja baz danych (rozdziały 3-4)

• Aplikacja Baza Danych - C# + SQL - Wzorce łączności z bazą danych
• Funkcje + Cosmos DB - Bezserwerowy przepływ danych

Zewnętrzne przykłady - Zaawansowane wzorce (rozdziały 4-8)

• Mikrousługi Java - Architektury wieloserwisowe
• Container Apps Jobs - Przetwarzanie w tle
• Enterprise ML Pipeline - Gotowe do produkcji wzorce ML

Zewnętrzne kolekcje szablonów

• Oficjalna galeria szablonów AZD - Wyselekcjonowana kolekcja oficjalnych i społecznościowych szablonów
• Szablony Azure Developer CLI - Dokumentacja szablonów Microsoft Learn
• Katalog przykładów - Lokalne przykłady naukowe z detalicznymi wyjaśnieniami

📚 Zasoby edukacyjne i odnośniki

Szybkie odnośniki

• Skrót poleceń - Podstawowe polecenia azd uporządkowane wg rozdziałów
• Słownik terminów - Terminologia Azure i azd
• FAQ - Najczęściej zadawane pytania uporządkowane wg rozdziałów
• Przewodnik nauki - Kompleksowe ćwiczenia praktyczne

Warsztaty praktyczne

• Laboratorium AI Workshop - Przygotuj swoje rozwiązania AI do wdrożenia za pomocą AZD (2-3 godziny)
• Warsztat interaktywny - 8 modułów prowadzonych ćwiczeń z MkDocs i GitHub Codespaces
  • Kolejność: Wprowadzenie → Wybór → Walidacja → Rozbiórka → Konfiguracja → Personalizacja → Demontaż → Podsumowanie

Zewnętrzne źródła nauki

• Dokumentacja Azure Developer CLI: https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/
• Centrum architektury Azure: https://learn.microsoft.com/en-us/azure/architecture/
• Kalkulator cen Azure: https://azure.microsoft.com/pricing/calculator/
• Status usług Azure: https://status.azure.com/

Umiejętności agenta AI dla twojego edytora

• Umiejętności Microsoft Azure na skills.sh - 37 otwartych umiejętności agenta dla AI Azure, Foundry, wdrożeń, diagnostyki, optymalizacji kosztów i innych. Zainstaluj je w GitHub Copilot, Cursor, Claude Code lub dowolnym wspieranym agencie:

  npx skills add microsoft/github-copilot-for-azure
  

🔧 Szybki poradnik rozwiązywania problemów

Typowe problemy początkujących i szybkie rozwiązania:

# Najpierw zainstaluj AZD
# Windows (PowerShell):
winget install microsoft.azd

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

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

# Zweryfikuj instalację
azd version

# Wyświetl dostępne subskrypcje
az account list --output table

# Ustaw domyślną subskrypcję
az account set --subscription "<subscription-id-or-name>"

# Ustaw dla środowiska AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Zweryfikuj
az account show

# Wypróbuj różne regiony Azure
azd env set AZURE_LOCATION "westus2"
azd up

# Lub użyj mniejszych SKU w środowisku deweloperskim
# Edytuj infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}

# Opcja 1: Wyczyść i spróbuj ponownie
azd down --force --purge
azd up

# Opcja 2: Napraw tylko infrastrukturę
azd provision

# Opcja 3: Sprawdź szczegółowy status
azd show

# Opcja 4: Sprawdź logi w Azure Monitor
azd monitor --logs

# Ponowna uwierzytelnienie dla AZD
azd auth logout
azd auth login

# Opcjonalnie: odśwież także Azure CLI, jeśli korzystasz z poleceń az
az logout
az login

# Zweryfikuj uwierzytelnienie
az account show

# AZD generuje unikalne nazwy, ale jeśli wystąpi konflikt:
azd down --force --purge

# Następnie spróbuj ponownie z nowym środowiskiem
azd env new dev-v2
azd up

# Sprawdź postęp
azd show

# Jeśli utknięcie trwa >30 minut, sprawdź portal Azure:
azd monitor --overview
# Szukaj nieudanych wdrożeń

# Sprawdź swoją rolę w Azure
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Potrzebujesz co najmniej roli "Współtwórca"
# Poproś administratora Azure o przyznanie:
# - Współtwórca (dla zasobów)
# - Administrator dostępu użytkowników (dla przypisań ról)

# Pokaż wszystkie punkty końcowe usług
azd show

# Lub otwórz portal Azure
azd monitor

# Sprawdź konkretną usługę
azd env get-values
# Szukaj zmiennych *_URL

📚 Pełne zasoby rozwiązywania problemów

• Podręcznik problemów typowych: Szczegółowe rozwiązania
• Problemy specyficzne dla AI: Rozwiązywanie problemów AI
• Poradnik debugowania: Instrukcje krok po kroku
• Uzyskaj pomoc: Discord Azure kanał #azure-developer-cli

🎓 Ukończenie kursu i certyfikacja

Monitorowanie postępów

Śledź swoje postępy nauki w każdym rozdziale:

• Rozdział 1: Podstawy i szybki start ✅
• Rozdział 2: Rozwój skupiony na AI ✅
• Rozdział 3: Konfiguracja i uwierzytelnianie ✅
• Rozdział 4: Infrastruktura jako kod i wdrożenia ✅
• Rozdział 5: Rozwiązania AI wieloagentowe ✅
• Rozdział 6: Walidacja i planowanie przed wdrożeniem ✅
• Rozdział 7: Rozwiązywanie problemów i debugowanie ✅
• Rozdział 8: Wzorce produkcyjne i korporacyjne ✅

Weryfikacja nauki

Po ukończeniu każdego rozdziału zweryfikuj wiedzę przez:

1. Ćwiczenie praktyczne: Zrealizuj wdrożenie praktyczne rozdziału
2. Sprawdzenie wiedzy: Przejrzyj sekcję FAQ dla swojego rozdziału
3. Dyskusje społecznościowe: Podziel się doświadczeniami na Discordzie Azure
4. Następny rozdział: Przejdź do kolejnego poziomu złożoności

Korzyści z ukończenia kursu

Po ukończeniu wszystkich rozdziałów zyskasz:

• Doświadczenie produkcyjne: Wdrożone rzeczywiste aplikacje AI w Azure
• Umiejętności zawodowe: Gotowość do wdrożeń korporacyjnych
• Uznanie społeczności: Aktywny członek społeczności programistów Azure
• Awans kariery: Poszukiwane umiejętności AZD i wdrożeń AI

🤝 Społeczność i wsparcie

Uzyskaj pomoc i wsparcie

• Problemy techniczne: Zgłaszaj błędy i proponuj funkcje
• Pytania edukacyjne: Społeczność Microsoft Azure Discord oraz
• Pomoc specyficzna dla AI: Dołącz do
• Dokumentacja: Oficjalna dokumentacja Azure Developer CLI

Wgląd społeczności z Discord Microsoft Foundry

Ostatnie wyniki ankiety z kanału #Azure:

• 45% deweloperów chce używać AZD do zadań AI
• Główne wyzwania: Wdrożenia wieloserwisowe, zarządzanie poświadczeniami, gotowość produkcyjna
• Najczęściej proszone: szablony AI, poradniki rozwiązywania problemów, najlepsze praktyki

Dołącz do społeczności, aby:

• Dzielić się doświadczeniami AZD + AI i uzyskać pomoc
• Uzyskać wczesny dostęp do nowych szablonów AI
• Współtworzyć najlepsze praktyki wdrażania AI
• Wpływać na przyszły rozwój funkcji AI + AZD

Współtworzenie kursu

Zapraszamy do współpracy! Przeczytaj nasz Przewodnik dla współtwórców dotyczący:

• Ulepszeń treści: Rozwijaj istniejące rozdziały i przykłady
• Nowych przykładów: Dodawaj scenariusze rzeczywiste i szablony
• Tłumaczeń: Pomóż w utrzymaniu wersji wielojęzycznych
• Zgłaszania błędów: Poprawiaj dokładność i jasność
• Standardów społeczności: Przestrzegaj naszych inkluzywnych wytycznych społecznościowych

📄 Informacje o kursie

Licencja

Projekt jest licencjonowany na podstawie licencji MIT - zobacz plik LICENSE dla szczegółów.

Powiązane zasoby edukacyjne Microsoft

Nasz zespół tworzy inne kompleksowe kursy edukacyjne:

LangChain

Azure / Edge / MCP / Agenci

Seria Generative AI

Podstawy nauki

Seria Copilot

🗺️ Nawigacja po Kursie

🚀 Gotowy, by zacząć naukę?

Początkujący: Zacznij od Rozdział 1: Podstawy i Szybki Start
Deweloperzy AI: Przejdź do Rozdział 2: Rozwój AI-Pierwszy
Doświadczeni Deweloperzy: Zacznij od Rozdział 3: Konfiguracja i Uwierzytelnianie

Kolejne kroki: Rozpocznij Rozdział 1 - Podstawy AZD →

Zastrzeżenie:
Ten dokument został przetłumaczony za pomocą usługi tłumaczeń AI Co-op Translator. Chociaż dążymy do dokładności, prosimy mieć na uwadze, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym powinien być uważany za źródło wiążące. W przypadku informacji o krytycznym znaczeniu zaleca się skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia.