Azure Developer CLI | The .NET Blog

Hooks azd dengan Python, TypeScript, dan .NET: Selamat Tinggal Shell Script

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

Postingan ini diterjemahkan secara otomatis. Untuk versi aslinya, klik di sini.

Jika pernah memiliki proyek yang sepenuhnya ditulis dalam .NET namun tetap harus menulis script Bash untuk hooks azd, rasa frustrasi itu sudah pasti familiar. Mengapa harus beralih ke sintaks shell di langkah pre-provisioning ketika seluruh proyek menggunakan C#?

Masalah ini kini memiliki solusi resmi. Azure Developer CLI baru saja meluncurkan dukungan multi-bahasa untuk hooks, dan hasilnya sesuai ekspektasi.

Apa itu hooks

Hooks adalah script yang berjalan di titik-titik penting dalam siklus hidup azd — sebelum provisioning, setelah deployment, dan lainnya. Didefinisikan di azure.yaml, mereka memungkinkan injeksi logika kustom tanpa memodifikasi CLI.

Sebelumnya hanya Bash dan PowerShell yang didukung. Kini bisa menggunakan Python, JavaScript, TypeScript, atau .NET — dan azd menangani sisanya secara otomatis.

Cara kerja deteksi bahasa

Cukup arahkan hook ke sebuah file dan azd akan menyimpulkan bahasa dari ekstensinya:

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

Tanpa konfigurasi tambahan. Jika ekstensinya ambigu, bisa menambahkan kind: python (atau bahasa yang sesuai) secara eksplisit.

Detail penting per bahasa

Python

Letakkan requirements.txt atau pyproject.toml di samping script (atau direktori induknya). azd akan otomatis membuat virtual environment, menginstal dependensi, dan menjalankan script.

JavaScript dan TypeScript

Pola yang sama — letakkan package.json dekat script dan azd akan menjalankan npm install terlebih dahulu. Untuk TypeScript, menggunakan npx tsx tanpa langkah kompilasi dan tanpa tsconfig.json.

.NET

Dua mode tersedia:

Mode project: Jika ada .csproj di samping script, azd otomatis menjalankan dotnet restore dan dotnet build.
Mode single-file: Di .NET 10+, file .cs mandiri dapat dijalankan langsung via dotnet run script.cs. Tidak perlu file project.

Konfigurasi per executor

Setiap bahasa mendukung blok config opsional:

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

Mengapa ini penting bagi developer .NET

Hooks adalah tempat terakhir dalam proyek berbasis azd yang memaksa pergantian bahasa. Sekarang seluruh deployment pipeline — dari kode aplikasi hingga lifecycle hooks — bisa hidup dalam satu bahasa. Utility .NET yang sudah ada bisa digunakan kembali di hooks, shared library bisa direferensikan, dan pemeliharaan shell script pun berakhir.

Penutup

Salah satu perubahan yang terlihat kecil namun benar-benar mengurangi gesekan dalam workflow azd sehari-hari. Dukungan multi-bahasa untuk hooks sudah tersedia sekarang — cek post resmi untuk dokumentasi lengkap.

azd + GitHub Copilot: Penyiapan Proyek Berbantuan AI dan Pemecahan Masalah Error Cerdas

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

Artikel ini diterjemahkan secara otomatis. Untuk versi asli dalam bahasa Inggris, klik di sini.

Kamu pasti pernah mengalami momen ketika ingin men-deploy aplikasi yang sudah ada ke Azure, lalu menatap file azure.yaml yang kosong sambil mencoba mengingat apakah Express API-mu harus menggunakan Container Apps atau App Service? Momen itu kini jauh lebih singkat.

Azure Developer CLI (azd) kini terintegrasi dengan GitHub Copilot dalam dua cara yang nyata: scaffolding proyek berbantuan AI selama azd init, dan pemecahan masalah error cerdas ketika deployment gagal. Kedua fitur ini sepenuhnya berjalan di dalam terminal.

Setup dengan Copilot selama azd init

Saat menjalankan azd init, kini ada opsi “Set up with GitHub Copilot (Preview)”. Pilih itu dan Copilot akan menganalisis codebase-mu untuk menghasilkan azure.yaml, template infrastruktur, dan modul Bicep — berdasarkan kode aslimu.

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

Prasyarat:

azd 1.23.11 atau lebih baru — cek dengan azd version atau perbarui dengan azd update
Langganan GitHub Copilot aktif (Individual, Business, atau Enterprise)
GitHub CLI (gh) — azd akan meminta login jika diperlukan

Yang menurutku benar-benar berguna: ini bekerja dua arah. Membangun dari nol? Copilot membantu mengonfigurasi layanan Azure yang tepat sejak awal. Punya aplikasi yang ingin di-deploy? Arahkan Copilot ke sana dan konfigurasi akan dibuat tanpa perlu restrukturisasi kode apapun.

Yang sebenarnya dilakukan

Katakanlah kamu punya Node.js Express API dengan dependensi PostgreSQL. Daripada memutuskan manual antara Container Apps dan App Service, lalu menulis Bicep dari nol, Copilot mendeteksi stack-mu dan menghasilkan:

azure.yaml dengan pengaturan language, host, dan build yang tepat
Modul Bicep untuk Azure Container Apps
Modul Bicep untuk Azure Database for PostgreSQL

Dan menjalankan pemeriksaan awal sebelum mengubah apapun — memverifikasi direktori git bersih, meminta persetujuan alat server MCP di awal. Tidak ada yang terjadi tanpa kamu tahu persis apa yang akan berubah.

Pemecahan Masalah Error dengan Copilot

Error deployment adalah hal yang tak terhindarkan. Parameter yang hilang, masalah izin, ketersediaan SKU — dan pesan error jarang memberitahumu satu hal yang benar-benar perlu kamu ketahui: cara memperbaikinya.

Tanpa Copilot, siklusnya terlihat seperti: salin error → cari di docs → baca tiga jawaban Stack Overflow yang tidak relevan → jalankan beberapa perintah az CLI → coba lagi dan berharap. Dengan Copilot terintegrasi di azd, siklus ini runtuh. Saat perintah azd apapun gagal, langsung ditawarkan empat pilihan:

Explain — penjelasan dalam bahasa sederhana tentang apa yang salah
Guidance — instruksi langkah demi langkah untuk memperbaiki masalah
Diagnose and Guide — analisis lengkap + Copilot menerapkan perbaikan (dengan persetujuanmu) + retry opsional
Skip — tangani sendiri

Poin kuncinya: Copilot sudah memiliki konteks tentang proyekmu, perintah yang gagal, dan detail error. Sarannya spesifik untuk situasimu.

Mengatur Perilaku Default

Jika selalu memilih opsi yang sama, lewati prompt interaktif:

azd config set copilot.errorHandling.category troubleshoot

Nilai: explain, guidance, troubleshoot, fix, skip. Kamu juga bisa mengaktifkan auto-fix dan retry:

azd config set copilot.errorHandling.fix allow

Kembali ke mode interaktif kapan saja:

azd config unset copilot.errorHandling.category

Kesimpulan

Jalankan azd update untuk mendapatkan versi terbaru dan coba azd init di proyek berikutnya.

Baca pengumuman aslinya di sini.