Azure Developer CLI | The .NET Blog

Hooki azd w Python, TypeScript i .NET: koniec ze skryptami shell

Emiliano Montesdeoca — Thu, 23 Apr 2026 00:00:00 +0000

Ten artykuł został przetłumaczony automatycznie. Aby zobaczyć oryginalną wersję, kliknij tutaj.

Jeśli kiedykolwiek miałeś projekt w całości napisany w .NET i mimo to musiałeś pisać skrypty Bash dla hooków azd — znasz ten ból. Po co przełączać się na składnię shell w kroku pre-provisioning, skoro reszta projektu to C#?

Ta frustracja ma teraz oficjalne rozwiązanie. Azure Developer CLI właśnie wprowadził obsługę wielu języków dla hooków, i jest dokładnie tak dobre, jak brzmi.

Czym są hooki

Hooki to skrypty wykonywane w kluczowych punktach cyklu życia azd — przed provisioningiem, po deploymencie i nie tylko. Definiuje się je w azure.yaml i pozwalają na wstrzyknięcie własnej logiki bez modyfikowania CLI.

Wcześniej obsługiwane były tylko Bash i PowerShell. Teraz można używać Pythona, JavaScript, TypeScript lub .NET — resztą zajmuje się azd automatycznie.

Jak działa wykrywanie

Wystarczy wskazać hook na plik, a azd wywnioskuje język z rozszerzenia:

hooks:
 preprovision:
 run: ./hooks/setup.py
 postdeploy:
 run: ./hooks/seed.ts
 postprovision:
 run: ./hooks/migrate.cs

Bez dodatkowej konfiguracji. Jeśli rozszerzenie jest niejednoznaczne, można jawnie podać kind: python (lub odpowiedni język).

Ważne szczegóły według języka

Python

Umieść requirements.txt lub pyproject.toml obok skryptu (lub w dowolnym katalogu nadrzędnym). azd automatycznie tworzy środowisko wirtualne, instaluje zależności i uruchamia skrypt.

JavaScript i TypeScript

Ten sam wzorzec — package.json blisko skryptu, a azd najpierw wykona npm install. Dla TypeScript używa npx tsx bez etapu kompilacji i bez tsconfig.json.

.NET

Dwa dostępne tryby:

Tryb projektu: jeśli obok skryptu jest .csproj, azd automatycznie uruchamia dotnet restore i dotnet build.
Tryb single-file: na .NET 10+ samodzielne pliki .cs uruchamiają się bezpośrednio przez dotnet run script.cs. Plik projektu nie jest wymagany.

Konfiguracja dla konkretnego executora

Każdy język obsługuje opcjonalny blok config:

hooks:
 preprovision:
 run: ./hooks/setup.ts
 config:
 packageManager: pnpm
 postprovision:
 run: ./hooks/migrate.cs
 config:
 configuration: Release
 framework: net10.0

Dlaczego to ważne dla programistów .NET

Hooki były ostatnim miejscem w projekcie opartym na azd, które wymuszało zmianę języka. Teraz cały pipeline deploymentu — od kodu aplikacji po hooki cyklu życia — może żyć w jednym języku. Można ponownie wykorzystywać istniejące narzędzia .NET w hookach, referencować współdzielone biblioteki i porzucić utrzymywanie skryptów shell.

Podsumowanie

Jedna z tych zmian, które wydają się drobne, ale naprawdę redukują codzienne tarcia w pracy z azd. Obsługa wielu języków dla hooków jest dostępna teraz — pełna dokumentacja w oficjalnym poście.

azd + GitHub Copilot: Konfiguracja projektu z AI i inteligentne rozwiązywanie błędów

Emiliano Montesdeoca — Tue, 21 Apr 2026 00:00:00 +0000

Ten artykuł został przetłumaczony automatycznie. Oryginalną wersję angielską znajdziesz tutaj.

Znasz ten moment, gdy chcesz wdrożyć istniejącą aplikację na Azure i patrzysz na pusty azure.yaml, próbując przypomnieć sobie, czy Twoje Express API powinno używać Container Apps czy App Service? Ten moment właśnie stał się znacznie krótszy.

Azure Developer CLI (azd) integruje się teraz z GitHub Copilot na dwa konkretne sposoby: scaffolding projektu wspomagany przez AI podczas azd init oraz inteligentne rozwiązywanie błędów gdy wdrożenia kończą się niepowodzeniem. Obie funkcje działają całkowicie w terminalu.

Konfiguracja z Copilotem podczas azd init

Po uruchomieniu azd init pojawia się opcja “Set up with GitHub Copilot (Preview)”. Wybierz ją, a Copilot przeanalizuje Twój codebase i wygeneruje azure.yaml, szablony infrastruktury oraz moduły Bicep — na podstawie Twojego rzeczywistego kodu.

azd init
# Wybierz: "Set up with GitHub Copilot (Preview)"

Wymagania:

azd 1.23.11 lub nowszy — sprawdź przez azd version lub zaktualizuj przez azd update
Aktywna subskrypcja GitHub Copilot (Individual, Business lub Enterprise)
GitHub CLI (gh) — azd poprosi o logowanie jeśli potrzeba

To co uważam za naprawdę użyteczne: działa w obu kierunkach. Budujesz od zera? Copilot pomaga skonfigurować właściwe usługi Azure od początku. Masz istniejącą aplikację do wdrożenia? Wskaż Copilotem na nią — konfiguracja zostanie wygenerowana bez konieczności restrukturyzacji kodu.

Co faktycznie robi

Powiedzmy, że masz Node.js Express API z zależnością od PostgreSQL. Zamiast ręcznie wybierać między Container Apps a App Service, a potem pisać Bicep od zera, Copilot wykrywa Twój stack i generuje:

azure.yaml z właściwymi ustawieniami language, host i build
Moduł Bicep dla Azure Container Apps
Moduł Bicep dla Azure Database for PostgreSQL

Przed jakąkolwiek zmianą przeprowadzane są wstępne sprawdzenia — weryfikuje czystość katalogu roboczego git, pyta z wyprzedzeniem o zgodę na narzędzia serwera MCP. Nic nie dzieje się bez Twojej wiedzy.

Rozwiązywanie błędów z Copilotem

Błędy wdrożenia są nieuniknione. Brakujące parametry, problemy z uprawnieniami, dostępność SKU — a komunikat o błędzie rzadko mówi to, co naprawdę musisz wiedzieć: jak to naprawić.

Bez Copilota pętla wygląda tak: skopiuj błąd → szukaj w dokumentacji → czytaj trzy niepowiązane odpowiedzi na Stack Overflow → uruchom kilka poleceń az CLI → spróbuj ponownie. Z Copilotem w azd ta pętla znika. Gdy jakiekolwiek polecenie azd kończy się błędem, natychmiast oferuje cztery opcje:

Explain — wyjaśnienie w zrozumiałym języku, co poszło nie tak
Guidance — instrukcje krok po kroku jak naprawić problem
Diagnose and Guide — pełna analiza + Copilot stosuje poprawkę (za Twoją zgodą) + opcjonalne ponowienie
Skip — samodzielna obsługa

Kluczowa kwestia: Copilot ma już kontekst Twojego projektu, nieudanego polecenia i szczegółów błędu. Jego sugestie są specyficzne dla Twojej sytuacji.

Ustawianie domyślnego zachowania

Jeśli zawsze wybierasz tę samą opcję, pomiń interaktywny monit:

azd config set copilot.errorHandling.category troubleshoot

Wartości: explain, guidance, troubleshoot, fix, skip. Możesz też włączyć automatyczną naprawę i ponowienie:

azd config set copilot.errorHandling.fix allow

Powrót do trybu interaktywnego w dowolnym momencie:

azd config unset copilot.errorHandling.category

Podsumowanie

Uruchom azd update po najnowszą wersję i wypróbuj azd init w swoim następnym projekcie.

Przeczytaj oryginalny komunikat tutaj.