AZD Untuk Pemula: Perjalanan Belajar Terstruktur

Terjemahan Otomatis (Selalu Terbaru)

Lebih Suka Mengkloning Secara Lokal?

Repositori ini mencakup 50+ terjemahan bahasa yang secara signifikan menambah ukuran download. Untuk mengkloning tanpa terjemahan, gunakan 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"
Ini memberi Anda semua yang Anda butuhkan untuk menyelesaikan kursus dengan unduhan yang jauh lebih cepat.

🆕 Apa yang Baru di azd Hari Ini

Azure Developer CLI telah berkembang melampaui aplikasi web dan API tradisional. Hari ini, azd adalah alat tunggal untuk menerapkan semua jenis aplikasi ke Azure—termasuk aplikasi bertenaga AI dan agen cerdas.

Ini artinya bagi Anda:

Agen AI sekarang menjadi beban kerja azd utama. Anda dapat menginisialisasi, menerapkan, dan mengelola proyek agen AI menggunakan alur kerja azd init → azd up yang sudah Anda kenal.
Integrasi Microsoft Foundry membawa penyebaran model, hosting agen, dan konfigurasi layanan AI langsung ke ekosistem template azd.
Alur kerja inti tidak berubah. Baik Anda menerapkan aplikasi todo, sebuah microservice, atau solusi AI multi-agen, perintahnya sama.

Jika Anda pernah menggunakan azd sebelumnya, dukungan AI adalah perpanjangan alami—bukan alat terpisah atau jalur lanjutan. Jika Anda memulai dari awal, Anda akan mempelajari satu alur kerja yang bekerja untuk semuanya.

🚀 Apa itu Azure Developer CLI (azd)?

Azure Developer CLI (azd) adalah alat baris perintah yang ramah pengembang yang memudahkan penerapan aplikasi ke Azure. Alih-alih secara manual membuat dan menghubungkan puluhan sumber daya Azure, Anda dapat menerapkan seluruh aplikasi dengan satu perintah.

Keajaiban `azd up`

# Perintah tunggal ini melakukan semuanya:
# ✅ Membuat semua sumber daya Azure
# ✅ Mengonfigurasi jaringan dan keamanan
# ✅ Membangun kode aplikasi Anda
# ✅ Menerapkan ke Azure
# ✅ Memberikan Anda URL yang berfungsi
azd up

Itu dia! Tidak perlu mengklik Portal Azure, tidak perlu mempelajari template ARM yang kompleks terlebih dahulu, tidak perlu konfigurasi manual - hanya aplikasi yang berjalan di Azure.

❓ Azure Developer CLI vs Azure CLI: Apa Bedanya?

Ini adalah pertanyaan paling umum yang diajukan pemula. Berikut jawaban sederhananya:

Fitur	Azure CLI (`az`)	Azure Developer CLI (`azd`)
Tujuan	Mengelola sumber daya Azure individual	Menerapkan aplikasi lengkap
Mindset	Berfokus pada infrastruktur	Berfokus pada aplikasi
Contoh	`az webapp create --name myapp...`	`azd up`
Kurva Pembelajaran	Harus tahu layanan Azure	Cukup tahu aplikasi Anda
Terbaik Untuk	DevOps, Infrastruktur	Pengembang, Prototyping

Analogi Sederhana

Azure CLI seperti memiliki semua alat untuk membangun sebuah rumah - palu, gergaji, paku. Anda bisa membangun apa saja, tetapi Anda perlu tahu konstruksi.
Azure Developer CLI seperti menyewa kontraktor - Anda menjelaskan apa yang Anda inginkan, dan mereka menangani pembangunannya.

Kapan Menggunakan Masing-Masing

Skenario	Gunakan Ini
"Saya ingin menerapkan web app saya dengan cepat"	`azd up`
"Saya perlu membuat hanya akun penyimpanan"	`az storage account create`
"Saya sedang membangun aplikasi AI lengkap"	`azd init --template azure-search-openai-demo`
"Saya perlu men-debug sumber daya Azure tertentu"	`az resource show`
"Saya ingin deployment siap produksi dalam beberapa menit"	`azd up --environment production`

Mereka Bekerja Bersama!

AZD menggunakan Azure CLI di bawah kap. Anda dapat menggunakan keduanya:

# Terapkan aplikasi Anda dengan AZD
azd up

# Kemudian sesuaikan sumber daya tertentu dengan Azure CLI
az webapp config set --name myapp --always-on true

🌟 Temukan Template di Awesome AZD

Jangan mulai dari nol! Awesome AZD adalah koleksi komunitas dari template siap-terdeploy:

Sumber Daya	Deskripsi
🔗 Galeri Awesome AZD	Jelajahi 200+ template dengan penyebaran satu-klik
🔗 Kirim Template	Kontribusikan template Anda sendiri ke komunitas
🔗 Repositori GitHub	Beri bintang dan jelajahi sumbernya

Template AI Populer dari Awesome AZD

# Obrolan RAG dengan Model Microsoft Foundry + Pencarian AI
azd init --template azure-search-openai-demo

# Aplikasi Obrolan AI Cepat
azd init --template openai-chat-app-quickstart

# Agen AI dengan Agen Foundry
azd init --template get-started-with-ai-agents

🎯 Memulai dalam 3 Langkah

Sebelum Anda mulai, pastikan mesin Anda siap untuk template yang ingin Anda terapkan:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Jika pemeriksaan yang diperlukan gagal, perbaiki itu terlebih dahulu dan kemudian lanjutkan dengan panduan cepat ini.

Langkah 1: Instal AZD (2 menit)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

Langkah 2: Autentikasi untuk AZD

# Opsional jika Anda berencana menggunakan perintah Azure CLI langsung dalam kursus ini
az login

# Diperlukan untuk alur kerja AZD
azd auth login

Jika Anda tidak yakin yang mana yang Anda perlukan, ikuti alur pengaturan penuh di Instalasi & Pengaturan.

Langkah 3: Terapkan Aplikasi Pertama Anda

# Inisialisasi dari sebuah template
azd init --template todo-nodejs-mongo

# Deploy ke Azure (membuat semuanya!)
azd up

🎉 Selesai! Aplikasi Anda sekarang aktif di Azure.

Pembersihan (Jangan Lupa!)

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

📚 Cara Menggunakan Kursus Ini

Kursus ini dirancang untuk pembelajaran bertahap - mulailah dari tempat Anda merasa nyaman dan tingkatkan secara bertahap:

Pengalaman Anda	Mulai Di Sini
Baru di Azure	Bab 1: Foundation
Tahu Azure, baru di AZD	Bab 1: Foundation
Ingin menerapkan aplikasi AI	Bab 2: AI-First Development
Ingin praktik langsung	🎓 Workshop Interaktif - lab berpemandu 3-4 jam
Perlu pola produksi	Bab 8: Produksi & Perusahaan

Pengaturan Cepat

Fork Repositori Ini:
Kloning: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
Dapatkan Bantuan: Komunitas Discord Azure

Lebih Suka Mengkloning Secara Lokal?

Repositori ini mencakup 50+ terjemahan bahasa yang secara signifikan menambah ukuran download. Untuk mengkloning tanpa terjemahan, gunakan 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'
Ini memberi Anda semua yang Anda butuhkan untuk menyelesaikan kursus dengan unduhan yang jauh lebih cepat.

Ikhtisar Kursus

Kuasi Azure Developer CLI (azd) melalui bab-bab terstruktur yang dirancang untuk pembelajaran bertahap. Fokus khusus pada penerapan aplikasi AI dengan integrasi Microsoft Foundry.

Mengapa Kursus Ini Penting untuk Pengembang Modern

Berdasarkan wawasan komunitas Microsoft Foundry Discord, 45% pengembang ingin menggunakan AZD untuk beban kerja AI tetapi menghadapi tantangan dengan:

Arsitektur AI multi-layanan yang kompleks
Praktik terbaik penerapan AI ke produksi
Integrasi dan konfigurasi layanan AI Azure
Optimisasi biaya untuk beban kerja AI
Menyelesaikan masalah khusus deployment AI

Tujuan Pembelajaran

Dengan menyelesaikan kursus terstruktur ini, Anda akan:

Menguasai Dasar AZD: Konsep inti, instalasi, dan konfigurasi
Menerapkan Aplikasi AI: Menggunakan AZD dengan layanan Microsoft Foundry
Mengimplementasikan Infrastruktur sebagai Kode: Mengelola sumber daya Azure dengan template Bicep
Menangani Masalah Deployment: Memecahkan masalah umum dan melakukan debug
Mengoptimalkan untuk Produksi: Keamanan, penskalaan, pemantauan, dan manajemen biaya
Membangun Solusi Multi-Agen: Menerapkan arsitektur AI yang kompleks

Sebelum Anda Mulai: Akun, Akses, dan Asumsi

Sebelum Anda memulai Bab 1, pastikan Anda memiliki hal-hal berikut. Langkah instalasi di bagian selanjutnya dari panduan ini mengasumsikan dasar-dasar ini sudah ditangani.

Langganan Azure: Anda dapat menggunakan langganan yang sudah ada dari tempat kerja atau akun Anda sendiri, atau membuat uji coba gratis untuk memulai.
Izin untuk membuat sumber daya Azure: Untuk sebagian besar latihan, Anda harus memiliki setidaknya akses Contributor pada langganan atau grup sumber daya target. Beberapa bab juga mungkin mengasumsikan Anda dapat membuat grup sumber daya, managed identities, dan penugasan RBAC.
Akun GitHub: Ini berguna untuk mem-fork repositori, melacak perubahan Anda sendiri, dan menggunakan GitHub Codespaces untuk lokakarya.
Prasyarat runtime template: Beberapa template membutuhkan alat lokal seperti Node.js, Python, Java, atau Docker. Jalankan setup validator sebelum memulai sehingga Anda mendeteksi alat yang hilang lebih awal.
Keterbiasaan terminal dasar: Anda tidak perlu menjadi ahli, tetapi Anda harus nyaman menjalankan perintah seperti git clone, azd auth login, dan azd up.

Bekerja di langganan enterprise? Jika lingkungan Azure Anda dikelola oleh administrator, konfirmasi terlebih dahulu bahwa Anda dapat menyebarkan sumber daya di langganan atau grup sumber daya yang akan Anda gunakan. Jika tidak, minta langganan sandbox atau akses Contributor sebelum Anda mulai.

Baru di Azure? Mulailah dengan trial Azure Anda sendiri atau langganan pay-as-you-go di https://aka.ms/azurefreetrial sehingga Anda dapat menyelesaikan latihan secara menyeluruh tanpa menunggu persetujuan tingkat tenant.

🗺️ Peta Kursus: Navigasi Cepat berdasarkan Bab

Setiap bab memiliki README khusus dengan tujuan pembelajaran, panduan cepat, dan latihan:

Bab	Topik	Pelajaran	Durasi	Kompleksitas
Bab 1: Dasar	Memulai	Dasar AZD \| Instalasi \| Proyek Pertama	30-45 menit	⭐
Bab 2: Pengembangan AI	Aplikasi Berfokus AI	Integrasi Microsoft Foundry \| AI Agents \| Penerapan Model AI \| Workshop	1-2 jam	⭐⭐
Bab 3: Konfigurasi	Auth & Keamanan	Konfigurasi \| Auth & Keamanan	45-60 menit	⭐⭐
Bab 4: Infrastruktur	IaC & Penyebaran	Panduan Penyebaran \| Provisioning	1-1.5 jam	⭐⭐⭐
Bab 5: Multi-Agent	Solusi Agen AI	Skenario Retail \| Pola Koordinasi	2-3 jam	⭐⭐⭐⭐
Bab 6: Pra-Penyebaran	Perencanaan & Validasi	Pemeriksaan Preflight \| Perencanaan Kapasitas \| Pemilihan SKU \| App Insights	1 jam	⭐⭐
Bab 7: Pemecahan Masalah	Debug & Perbaikan	Masalah Umum \| Debugging \| Masalah AI	1-1.5 jam	⭐⭐
Bab 8: Produksi	Pola Enterprise	Praktik Produksi	2-3 jam	⭐⭐⭐⭐
🎓 Workshop	Lab Praktik	Pendahuluan \| Pemilihan \| Validasi \| Dekonstruksi \| Konfigurasi \| Kustomisasi \| Pembongkaran Infrastruktur \| Penutupan	3-4 jam	⭐⭐

Total Durasi Kursus: ~10-14 jam | Perkembangan Keterampilan: Pemula → Siap Produksi

📚 Bab Pembelajaran

Pilih jalur pembelajaran Anda berdasarkan tingkat pengalaman dan tujuan

🚀 Bab 1: Dasar & Panduan Cepat

Prasyarat: langganan Azure, pengetahuan dasar baris perintah
Durasi: 30-45 menit
Kompleksitas: ⭐

Yang Akan Anda Pelajari

Memahami dasar-dasar Azure Developer CLI
Menginstal AZD di platform Anda
Penyebaran pertama Anda yang berhasil

Sumber Pembelajaran

🎯 Mulai Di Sini: Apa itu Azure Developer CLI?
📖 Teori: Dasar AZD - Konsep inti dan terminologi
⚙️ Pengaturan: Instalasi & Pengaturan - Panduan spesifik platform
🛠️ Praktik: Proyek Pertama Anda - Tutorial langkah demi langkah
📋 Referensi Cepat: Ringkasan Perintah

Latihan Praktis

# Pemeriksaan instalasi cepat
azd version

# Terapkan aplikasi pertama Anda
azd init --template todo-nodejs-mongo
azd up

💡 Hasil Bab: Berhasil menerapkan aplikasi web sederhana ke Azure menggunakan AZD

✅ Validasi Keberhasilan:

# Setelah menyelesaikan Bab 1, Anda seharusnya dapat:
azd version              # Menampilkan versi yang terpasang
azd init --template todo-nodejs-mongo  # Menginisialisasi proyek
azd up                  # Menerapkan ke Azure
azd show                # Menampilkan URL aplikasi yang sedang berjalan
# Aplikasi terbuka di browser dan berfungsi
azd down --force --purge  # Membersihkan sumber daya

📊 Investasi Waktu: 30-45 menit
📈 Tingkat Keterampilan Setelah: Dapat menerapkan aplikasi dasar secara mandiri 📈 Tingkat Keterampilan Setelah: Dapat menerapkan aplikasi dasar secara mandiri

🤖 Bab 2: Pengembangan Berfokus AI (Direkomendasikan untuk Pengembang AI)

Prasyarat: Bab 1 selesai
Durasi: 1-2 jam
Kompleksitas: ⭐⭐

Yang Akan Anda Pelajari

Integrasi Microsoft Foundry dengan AZD
Menyebarkan aplikasi bertenaga AI
Memahami konfigurasi layanan AI

Sumber Pembelajaran

🎯 Mulai Di Sini: Integrasi Microsoft Foundry
🤖 Agen AI: Panduan AI Agents - Menyebarkan agen cerdas dengan AZD
📖 Pola: Penerapan Model AI - Menyebarkan dan mengelola model AI
🛠️ Workshop: AI Workshop Lab - Menyiapkan solusi AI Anda agar siap AZD
🎥 Panduan Interaktif: Materi Workshop - Pembelajaran berbasis browser dengan MkDocs * DevContainer Environment
📋 Template: Template Microsoft Foundry
📝 Contoh: Contoh Penyebaran AZD

Latihan Praktis

# Terapkan aplikasi AI pertama Anda
azd init --template azure-search-openai-demo
azd up

# Coba template AI tambahan
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Hasil Bab: Menyebarkan dan mengonfigurasi aplikasi chat bertenaga AI dengan kemampuan RAG

✅ Validasi Keberhasilan:

# Setelah Bab 2, Anda seharusnya bisa:
azd init --template azure-search-openai-demo
azd up
# Menguji antarmuka obrolan AI
# Mengajukan pertanyaan dan mendapatkan jawaban berbasis AI beserta sumbernya
# Memverifikasi integrasi pencarian berfungsi
azd monitor  # Periksa apakah Application Insights menampilkan telemetri
azd down --force --purge

📊 Investasi Waktu: 1-2 jam
📈 Tingkat Keterampilan Setelah: Dapat menerapkan dan mengonfigurasi aplikasi AI siap produksi
💰 Kesadaran Biaya: Memahami biaya pengembangan $80-150/bulan, biaya produksi $300-3500/bulan

💰 Pertimbangan Biaya untuk Penerapan AI

Lingkungan Pengembangan (Perkiraan $80-150/bulan):

Microsoft Foundry Models (Pay-as-you-go): $0-50/bulan (berdasarkan penggunaan token)
AI Search (tingkat Basic): $75/bulan
Container Apps (Consumption): $0-20/bulan
Storage (Standard): $1-5/bulan

Lingkungan Produksi (Perkiraan $300-3,500+/bulan):

Microsoft Foundry Models (PTU untuk kinerja konsisten): $3,000+/bulan ATAU Pay-as-you-go dengan volume tinggi
AI Search (tingkat Standard): $250/bulan
Container Apps (Dedicated): $50-100/bulan
Application Insights: $5-50/bulan
Storage (Premium): $10-50/bulan

💡 Tips Optimisasi Biaya:

Gunakan Free Tier Microsoft Foundry Models untuk pembelajaran (Azure OpenAI 50,000 token/bulan termasuk)
Jalankan azd down untuk melepaskan sumber daya ketika tidak sedang mengembangkan
Mulai dengan penagihan berbasis konsumsi, naikkan ke PTU hanya untuk produksi
Gunakan azd provision --preview untuk memperkirakan biaya sebelum penyebaran
Aktifkan auto-scaling: bayar hanya untuk penggunaan aktual

Pemantauan Biaya:

# Periksa estimasi biaya bulanan
azd provision --preview

# Pantau biaya aktual di Azure Portal
az consumption budget list --resource-group <your-rg>

⚙️ Bab 3: Konfigurasi & Otentikasi

Prasyarat: Bab 1 selesai
Durasi: 45-60 menit
Kompleksitas: ⭐⭐

Yang Akan Anda Pelajari

Konfigurasi dan manajemen lingkungan
Praktik terbaik autentikasi dan keamanan
Penamaan dan organisasi sumber daya

Sumber Pembelajaran

📖 Konfigurasi: Panduan Konfigurasi - Pengaturan lingkungan
🔐 Keamanan: Pola autentikasi dan managed identity - Pola autentikasi
📝 Contoh: Contoh Aplikasi Database - Contoh Database AZD

Latihan Praktis

Konfigurasikan beberapa lingkungan (dev, staging, prod)
Siapkan autentikasi managed identity
Terapkan konfigurasi spesifik lingkungan

💡 Hasil Bab: Mengelola beberapa lingkungan dengan autentikasi dan keamanan yang tepat

🏗️ Bab 4: Infrastructure as Code & Penyebaran

Prasyarat: Bab 1-3 selesai
Durasi: 1-1.5 jam
Kompleksitas: ⭐⭐⭐

Yang Akan Anda Pelajari

Pola penyebaran lanjutan
Infrastructure as Code dengan Bicep
Strategi provisioning sumber daya

Sumber Pembelajaran

📖 Penyebaran: Panduan Penyebaran - Alur kerja lengkap
🏗️ Provisioning: Provisioning Resources - Manajemen sumber daya Azure
📝 Contoh: Contoh Container App - Penyebaran tercontainerisasi

Latihan Praktis

Buat template Bicep kustom
Sebarkan aplikasi multi-layanan
Terapkan strategi penyebaran blue-green

💡 Hasil Bab: Menyebarkan aplikasi multi-layanan yang kompleks menggunakan template infrastruktur kustom

🎯 Bab 5: Solusi AI Multi-Agent (Lanjutan)

Prasyarat: Bab 1-2 selesai
Durasi: 2-3 jam
Kompleksitas: ⭐⭐⭐⭐

Yang Akan Anda Pelajari

Pola arsitektur multi-agen
Orkestrasi dan koordinasi agen
Penyebaran AI siap produksi

Sumber Pembelajaran

🤖 Proyek Unggulan: Solusi Multi-Agent Retail - Implementasi lengkap
🛠️ Paket ARM: Paket Template ARM - Penyebaran sekali klik
📖 Arsitektur: Pola koordinasi multi-agen - Pola

Latihan Praktis

# Menerapkan solusi multi-agen ritel lengkap
cd examples/retail-multiagent-arm-template
./deploy.sh

# Jelajahi konfigurasi agen
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Hasil Bab: Menyebarkan dan mengelola solusi AI multi-agen siap produksi dengan agen Customer dan Inventory

🔍 Bab 6: Validasi & Perencanaan Pra-Penyebaran

Prasyarat: Bab 4 selesai
Durasi: 1 jam
Kompleksitas: ⭐⭐

Apa yang Akan Anda Pelajari

Perencanaan kapasitas dan validasi sumber daya
Strategi pemilihan SKU
Pemeriksaan pra-penerbangan dan otomatisasi

Sumber Belajar

📊 Perencanaan: Capacity Planning - Validasi sumber daya
💰 Pemilihan: SKU Selection - Pilihan yang hemat biaya
✅ Validasi: Pre-flight Checks - Skrip terotomatisasi

Latihan Praktis

Jalankan skrip validasi kapasitas
Optimalkan pilihan SKU untuk biaya
Terapkan pemeriksaan pra-deploy terotomatisasi

💡 Hasil Bab: Validasi dan optimalkan penyebaran sebelum eksekusi

🚨 Bab 7: Pemecahan Masalah & Debugging

Prasyarat: Selesaikan salah satu bab penyebaran
Durasi: 1-1.5 jam
Kompleksitas: ⭐⭐

Apa yang Akan Anda Pelajari

Pendekatan debugging sistematis
Masalah umum dan solusinya
Pemecahan masalah khusus AI

Sumber Belajar

🔧 Masalah Umum: Common Issues - FAQ dan solusi
🕵️ Debugging: Debugging Guide - Strategi langkah demi langkah
🤖 Masalah AI: AI-Specific Troubleshooting - Masalah layanan AI

Latihan Praktis

Diagnosis kegagalan penyebaran
Selesaikan masalah otentikasi
Debug konektivitas layanan AI

💡 Hasil Bab: Mandiri mendiagnosis dan menyelesaikan masalah penyebaran umum

🏢 Bab 8: Pola Produksi & Perusahaan

Prasyarat: Bab 1-4 selesai
Durasi: 2-3 jam
Kompleksitas: ⭐⭐⭐⭐

Apa yang Akan Anda Pelajari

Strategi penyebaran produksi
Pola keamanan perusahaan
Pemantauan dan optimisasi biaya

Sumber Belajar

🏭 Produksi: Production AI Best Practices - Pola perusahaan
📝 Contoh: Microservices Example - Arsitektur kompleks
📊 Pemantauan: Application Insights integration - Pemantauan

Latihan Praktis

Terapkan pola keamanan perusahaan
Siapkan pemantauan komprehensif
Sebarkan ke produksi dengan tata kelola yang tepat

💡 Hasil Bab: Menyebarkan aplikasi siap perusahaan dengan kemampuan produksi penuh

🎓 Ikhtisar Workshop: Pengalaman Belajar Praktis

⚠️ STATUS WORKSHOP: Sedang Dikembangkan
Materi workshop saat ini sedang dikembangkan dan disempurnakan. Modul inti berfungsi, tetapi beberapa bagian lanjutan belum lengkap. Kami sedang bekerja aktif untuk menyelesaikan semua konten. Track progress →

Materi Workshop Interaktif

Pembelajaran praktis komprehensif dengan alat berbasis browser dan latihan terpandu

Materi workshop kami menyediakan pengalaman belajar terstruktur dan interaktif yang melengkapi kurikulum berbasis bab di atas. Workshop dirancang untuk pembelajaran mandiri maupun sesi yang dipandu instruktur.

🛠️ Fitur Workshop

Antarmuka Berbasis Browser: Lengkap MkDocs-powered workshop dengan pencarian, salin, dan fitur tema
Integrasi GitHub Codespaces: Pengaturan lingkungan pengembangan satu-klik
Jalur Pembelajaran Terstruktur: 8-modul latihan terpandu (3-4 jam total)
Metodologi Progresif: Pengenalan → Pemilihan → Validasi → Dekonstruksi → Konfigurasi → Kustomisasi → Pembersihan → Penutupan
Lingkungan DevContainer Interaktif: Alat dan dependensi pra-konfigurasi

📚 Struktur Modul Workshop

Workshop mengikuti metodologi progresif 8-modul yang membawa Anda dari penemuan hingga penguasaan penyebaran:

Modul	Topik	Yang Akan Anda Lakukan	Durasi
0. Introduction	Ikhtisar Workshop	Memahami tujuan pembelajaran, prasyarat, dan struktur workshop	15 menit
1. Selection	Penemuan Template	Jelajahi template AZD dan pilih template AI yang tepat untuk skenario Anda	20 menit
2. Validation	Deploy & Verify	Sebarkan template dengan `azd up` dan validasi infrastruktur berjalan	30 menit
3. Deconstruction	Memahami Struktur	Gunakan GitHub Copilot untuk menjelajahi arsitektur template, file Bicep, dan organisasi kode	30 menit
4. Configuration	azure.yaml Deep Dive	Kuasai konfigurasi `azure.yaml`, lifecycle hooks, dan variabel lingkungan	30 menit
5. Customization	Sesuaikan dengan Anda	Aktifkan AI Search, tracing, evaluasi, dan sesuaikan untuk skenario Anda	45 menit
6. Teardown	Pembersihan	Nonaktifkan sumber daya dengan aman menggunakan `azd down --purge`	15 menit
7. Wrap-up	Langkah Selanjutnya	Tinjau pencapaian, konsep kunci, dan lanjutkan perjalanan pembelajaran Anda	15 menit

Alur Workshop:

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

🚀 Memulai Workshop

# Opsi 1: GitHub Codespaces (Direkomendasikan)
# Klik "Code" → "Create codespace on main" di repositori

# Opsi 2: Pengembangan Lokal
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Ikuti petunjuk pengaturan di workshop/README.md

🎯 Hasil Pembelajaran Workshop

Dengan menyelesaikan workshop, peserta akan:

Menyebarkan Aplikasi AI Produksi: Gunakan AZD dengan layanan Microsoft Foundry
Menguasai Arsitektur Multi-Agen: Terapkan solusi agen AI yang terkoordinasi
Menerapkan Praktik Keamanan Terbaik: Konfigurasi otentikasi dan kontrol akses
Mengoptimalkan untuk Skala: Rancang penyebaran yang hemat biaya dan berkinerja
Memecahkan Masalah Penyebaran: Menyelesaikan masalah umum secara mandiri

📖 Sumber Workshop

🎥 Panduan Interaktif: Workshop Materials - Lingkungan pembelajaran berbasis browser
📋 Instruksi Modul-per-Modul:
- 0. Introduction - Ikhtisar workshop dan tujuan
- 1. Selection - Temukan dan pilih template AI
- 2. Validation - Sebarkan dan verifikasi template
- 3. Deconstruction - Jelajahi arsitektur template
- 4. Configuration - Kuasai azure.yaml
- 5. Customization - Sesuaikan untuk skenario Anda
- 6. Teardown - Bersihkan sumber daya
- 7. Wrap-up - Tinjau dan langkah selanjutnya
🛠️ Lab Workshop AI: AI Workshop Lab - Latihan berfokus pada AI
💡 Mulai Cepat: Workshop Setup Guide - Konfigurasi lingkungan

Sangat cocok untuk: Pelatihan korporat, kursus universitas, pembelajaran mandiri, dan bootcamp pengembang.

📖 Pendalaman: Kapabilitas AZD

Di luar dasar-dasarnya, AZD menyediakan fitur kuat untuk penyebaran produksi:

Penyebaran berbasis template - Gunakan template pra-bangun untuk pola aplikasi umum
Infrastructure as Code - Kelola sumber daya Azure menggunakan Bicep atau Terraform
Alur kerja terintegrasi - Sediakan, sebarkan, dan pantau aplikasi dengan mulus
Ramah pengembang - Dioptimalkan untuk produktivitas dan pengalaman pengembang

AZD + Microsoft Foundry: Sempurna untuk Penyebaran AI

Mengapa AZD untuk Solusi AI? AZD mengatasi tantangan utama yang dihadapi pengembang AI:

Template Siap-AI - Template pra-konfigurasi untuk Microsoft Foundry Models, Cognitive Services, dan beban kerja ML
Penyebaran AI yang Aman - Pola keamanan bawaan untuk layanan AI, kunci API, dan endpoint model
Pola AI Produksi - Praktik terbaik untuk penyebaran aplikasi AI yang dapat diskalakan dan hemat biaya
Alur Kerja AI End-to-End - Dari pengembangan model hingga penyebaran produksi dengan pemantauan yang tepat
Optimisasi Biaya - Alokasi sumber daya cerdas dan strategi skala untuk beban kerja AI
Integrasi Microsoft Foundry - Koneksi mulus ke katalog model dan endpoint Microsoft Foundry

🎯 Perpustakaan Template & Contoh

Unggulan: Template Microsoft Foundry

Mulai di sini jika Anda menyebarkan aplikasi AI!

Catatan: Template ini menunjukkan berbagai pola AI. Beberapa merupakan Azure Samples eksternal, yang lain adalah implementasi lokal.

Template	Bab	Kompleksitas	Layanan	Tipe
Get started with AI chat	Bab 2	⭐⭐	AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights	External
Get started with AI agents	Bab 2	⭐⭐	Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights	External
Azure Search + OpenAI Demo	Bab 2	⭐⭐	AzureOpenAI + Azure AI Search + App Service + Storage	External
OpenAI Chat App Quickstart	Bab 2	⭐	AzureOpenAI + Container Apps + Application Insights	External
Agent OpenAI Python Prompty	Bab 5	⭐⭐⭐	AzureOpenAI + Azure Functions + Prompty	External
Contoso Chat RAG	Bab 8	⭐⭐⭐⭐	AzureOpenAI + AI Search + Cosmos DB + Container Apps	External
Retail Multi-Agent Solution	Bab 5	⭐⭐⭐⭐	AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB	Local

Unggulan: Skenario Pembelajaran Lengkap

Template aplikasi siap-produksi yang dipetakan ke bab pembelajaran

Template	Bab Pembelajaran	Kompleksitas	Pembelajaran Utama
openai-chat-app-quickstart	Bab 2	⭐	Pola penyebaran AI dasar
azure-search-openai-demo	Bab 2	⭐⭐	Implementasi RAG dengan Azure AI Search
ai-document-processing	Bab 4	⭐⭐	Integrasi Document Intelligence
agent-openai-python-prompty	Bab 5	⭐⭐⭐	Kerangka agen dan pemanggilan fungsi
contoso-chat	Bab 8	⭐⭐⭐	Orkestrasi AI perusahaan
retail-multi-agent-solution	Bab 5	⭐⭐⭐⭐	Arsitektur multi-agen dengan agen Pelanggan dan Inventaris

Belajar Berdasarkan Jenis Contoh

📌 Contoh Lokal vs. Eksternal:
Contoh Lokal (di repo ini) = Siap digunakan segera
Contoh Eksternal (Azure Samples) = Clone dari repositori yang dilink

Contoh Lokal (Siap Digunakan)

Retail Multi-Agent Solution - Implementasi siap-produksi lengkap dengan template ARM
- Arsitektur multi-agen (agen Pelanggan + Inventaris)
- Pemantauan dan evaluasi komprehensif
- Penyebaran satu-klik melalui template ARM

Contoh Lokal - Aplikasi Container (Bab 2-5)

Contoh penyebaran container komprehensif di repositori ini:

Container App Examples - Panduan lengkap untuk penyebaran container
- Simple Flask API - REST API dasar dengan scale-to-zero
- Microservices Architecture - Penyebaran multi-layanan siap-produksi
- Quick Start, pola penyebaran Produksi, dan Lanjutan
- Panduan pemantauan, keamanan, dan optimisasi biaya

Contoh Eksternal - Aplikasi Sederhana (Bab 1-2)

Clone repositori Azure Samples ini untuk memulai:

Simple Web App - Node.js + MongoDB - Pola penyebaran dasar
Static Website - React SPA - Penyebaran konten statis
Container App - Python Flask - Penyebaran REST API

Contoh Eksternal - Integrasi Database (Bab 3-4)

Database App - C# + SQL - Pola konektivitas database
Functions + Cosmos DB - Alur kerja data tanpa server

Contoh Eksternal - Pola Lanjutan (Bab 4-8)

Java Microservices - Arsitektur multi-layanan
Container Apps Jobs - Pemrosesan latar belakang
Enterprise ML Pipeline - Pola ML siap produksi

Koleksi Template Eksternal

Official AZD Template Gallery - Koleksi terkurasi template resmi dan komunitas
Azure Developer CLI Templates - Dokumentasi template Microsoft Learn
Examples Directory - Contoh pembelajaran lokal dengan penjelasan rinci

📚 Sumber Belajar & Referensi

Referensi Cepat

Command Cheat Sheet - Perintah azd penting yang diatur per bab
Glossary - Istilah Azure dan azd
FAQ - Pertanyaan umum yang diatur berdasarkan bab pembelajaran
Study Guide - Latihan praktik yang komprehensif

Lokakarya Praktik

AI Workshop Lab - Buat solusi AI Anda dapat diterapkan dengan AZD (2-3 jam)
Interactive Workshop - Latihan terpandu 8 modul dengan MkDocs dan GitHub Codespaces
- Mengikuti: Pengenalan → Pemilihan → Validasi → Dekonstruksi → Konfigurasi → Kustomisasi → Pembongkaran → Penutup

Sumber Pembelajaran Eksternal

Azure Developer CLI Documentation (https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/)
Azure Architecture Center (https://learn.microsoft.com/en-us/azure/architecture/)
Azure Pricing Calculator (https://azure.microsoft.com/pricing/calculator/)
Azure Status (https://status.azure.com/)

Keterampilan Agen AI untuk Editor Anda

Keterampilan Microsoft Azure di skills.sh - 37 keterampilan agen terbuka untuk Azure AI, Foundry, deployment, diagnostik, optimisasi biaya, dan lainnya. Instal mereka di GitHub Copilot, Cursor, Claude Code, atau agen lain yang didukung:
```
npx skills add microsoft/github-copilot-for-azure
```

🔧 Panduan Pemecahan Masalah Cepat

Masalah umum yang dihadapi pemula dan solusi cepat:

❌ "azd: command not found"

# Instal AZD terlebih dahulu
# Windows (PowerShell):
winget install microsoft.azd

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

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

# Verifikasi instalasi
azd version

❌ "No subscription found" or "Subscription not set"

# Daftar langganan yang tersedia
az account list --output table

# Tetapkan langganan default
az account set --subscription "<subscription-id-or-name>"

# Atur untuk lingkungan AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Verifikasi
az account show

❌ "InsufficientQuota" or "Quota exceeded"

# Coba wilayah Azure yang berbeda
azd env set AZURE_LOCATION "westus2"
azd up

# Atau gunakan SKU yang lebih kecil dalam pengembangan
# Sunting infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}

❌ "azd up" fails halfway through

# Opsi 1: Bersihkan dan coba lagi
azd down --force --purge
azd up

# Opsi 2: Hanya perbaiki infrastruktur
azd provision

# Opsi 3: Periksa status terperinci
azd show

# Opsi 4: Periksa log di Azure Monitor
azd monitor --logs

❌ "Authentication failed" or "Token expired"

# Autentikasi ulang untuk AZD
azd auth logout
azd auth login

# Opsional: segarkan Azure CLI juga jika Anda menjalankan perintah az
az logout
az login

# Verifikasi autentikasi
az account show

❌ "Resource already exists" or naming conflicts

# AZD menghasilkan nama unik, tetapi jika terjadi konflik:
azd down --force --purge

# Kemudian coba lagi dengan lingkungan baru
azd env new dev-v2
azd up

❌ Template deployment taking too long

Waktu tunggu normal:

Aplikasi web sederhana: 5-10 menit
Aplikasi dengan database: 10-15 menit
Aplikasi AI: 15-25 menit (Penyediaan OpenAI lambat)

# Periksa kemajuan
azd show

# Jika terjebak >30 menit, periksa Portal Azure:
azd monitor --overview
# Cari penyebaran yang gagal

❌ "Permission denied" or "Forbidden"

# Periksa peran Azure Anda
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Anda memerlukan setidaknya peran "Contributor"
# Minta admin Azure Anda untuk memberikan:
# - Contributor (untuk sumber daya)
# - User Access Administrator (untuk penetapan peran)

❌ Can't find deployed application URL

# Tampilkan semua endpoint layanan
azd show

# Atau buka Azure Portal
azd monitor

# Periksa layanan tertentu
azd env get-values
# Cari variabel *_URL

📚 Sumber Pemecahan Masalah Lengkap

Panduan Masalah Umum: Solusi Terperinci
Masalah Khusus AI: Pemecahan Masalah AI
Panduan Debugging: Debugging langkah demi langkah
Dapatkan Bantuan: Azure Discord #azure-developer-cli

🎓 Penyelesaian Kursus & Sertifikasi

Pelacakan Kemajuan

Lacak kemajuan pembelajaran Anda melalui setiap bab:

Bab 1: Dasar & Mulai Cepat ✅
Bab 2: Pengembangan Berbasis AI ✅
Bab 3: Konfigurasi & Otentikasi ✅
Bab 4: Infrastruktur sebagai Kode & Penerapan ✅
Bab 5: Solusi AI Multi-Agen ✅
Bab 6: Validasi & Perencanaan Pra-Penerapan ✅
Bab 7: Pemecahan Masalah & Debugging ✅
Bab 8: Pola Produksi & Perusahaan ✅

Verifikasi Pembelajaran

Setelah menyelesaikan setiap bab, verifikasi pengetahuan Anda dengan:

Latihan Praktik: Selesaikan penerapan praktik bab tersebut
Pemeriksaan Pengetahuan: Tinjau bagian FAQ untuk bab Anda
Diskusi Komunitas: Bagikan pengalaman Anda di Azure Discord
Bab Berikutnya: Lanjutkan ke tingkat kompleksitas berikutnya

Manfaat Penyelesaian Kursus

Setelah menyelesaikan semua bab, Anda akan memiliki:

Pengalaman Produksi: Mendeploy aplikasi AI nyata ke Azure
Keterampilan Profesional: Kemampuan penerapan siap-enterprise
Pengakuan Komunitas: Anggota aktif komunitas pengembang Azure
Kemajuan Karier: Keahlian AZD dan penerapan AI yang diminati

🤝 Komunitas & Dukungan

Dapatkan Bantuan & Dukungan

Masalah Teknis: Laporkan bug dan minta fitur
Pertanyaan Pembelajaran: Microsoft Azure Discord Community dan
Bantuan Terkait AI: Bergabung dengan
Dokumentasi: Dokumentasi resmi Azure Developer CLI

Wawasan Komunitas dari Discord Microsoft Foundry

Hasil Polling Terbaru dari Saluran #Azure:

45% pengembang ingin menggunakan AZD untuk beban kerja AI
Tantangan teratas: Deploy multi-layanan, manajemen kredensial, kesiapan produksi
Permintaan terbanyak: Template khusus AI, panduan pemecahan masalah, praktik terbaik

Bergabunglah dengan komunitas kami untuk:

Berbagi pengalaman AZD + AI dan mendapatkan bantuan
Mengakses preview awal template AI baru
Berkontribusi pada praktik terbaik penerapan AI
Mempengaruhi pengembangan fitur AI + AZD di masa depan

Berkontribusi pada Kursus

Kami menyambut kontribusi! Silakan baca Panduan Kontribusi untuk detail tentang:

Perbaikan Konten: Tingkatkan bab dan contoh yang ada
Contoh Baru: Tambahkan skenario dunia nyata dan template
Terjemahan: Bantu mempertahankan dukungan multi-bahasa
Laporan Bug: Tingkatkan akurasi dan kejelasan
Standar Komunitas: Ikuti panduan komunitas inklusif kami

📄 Informasi Kursus

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT - lihat berkas LICENSE untuk detail.

Sumber Pembelajaran Microsoft Terkait

Our team produces other comprehensive learning courses:

LangChain

Azure / Edge / MCP / Agen

Seri AI Generatif

Pembelajaran Inti

Seri Copilot

🗺️ Navigasi Kursus

🚀 Siap Memulai Belajar?

Pemula: Mulai dengan Bab 1: Fondasi & Mulai Cepat
Pengembang AI: Langsung ke Bab 2: Pengembangan Berbasis AI
Pengembang Berpengalaman: Mulai dengan Bab 3: Konfigurasi & Otentikasi

Langkah Selanjutnya: Mulai Bab 1 - Dasar-dasar AZD →

Penafian: Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI Co-op Translator. Meskipun kami berupaya mencapai akurasi, harap diperhatikan bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidaktepatan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang berwenang. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh penerjemah manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau salah penafsiran yang timbul dari penggunaan terjemahan ini.

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

AZD Untuk Pemula: Perjalanan Belajar Terstruktur

Terjemahan Otomatis (Selalu Terbaru)

🆕 Apa yang Baru di azd Hari Ini

🚀 Apa itu Azure Developer CLI (azd)?

Keajaiban azd up

❓ Azure Developer CLI vs Azure CLI: Apa Bedanya?

Analogi Sederhana

Kapan Menggunakan Masing-Masing

Mereka Bekerja Bersama!

🌟 Temukan Template di Awesome AZD

Template AI Populer dari Awesome AZD

🎯 Memulai dalam 3 Langkah

Langkah 1: Instal AZD (2 menit)

Langkah 2: Autentikasi untuk AZD

Langkah 3: Terapkan Aplikasi Pertama Anda

Pembersihan (Jangan Lupa!)

📚 Cara Menggunakan Kursus Ini

Pengaturan Cepat

Ikhtisar Kursus

Mengapa Kursus Ini Penting untuk Pengembang Modern

Tujuan Pembelajaran

Sebelum Anda Mulai: Akun, Akses, dan Asumsi

🗺️ Peta Kursus: Navigasi Cepat berdasarkan Bab

📚 Bab Pembelajaran

🚀 Bab 1: Dasar & Panduan Cepat

Yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktis

🤖 Bab 2: Pengembangan Berfokus AI (Direkomendasikan untuk Pengembang AI)

Yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktis

💰 Pertimbangan Biaya untuk Penerapan AI

⚙️ Bab 3: Konfigurasi & Otentikasi

Yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktis

🏗️ Bab 4: Infrastructure as Code & Penyebaran

Yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktis

🎯 Bab 5: Solusi AI Multi-Agent (Lanjutan)

Yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktis

🔍 Bab 6: Validasi & Perencanaan Pra-Penyebaran

Apa yang Akan Anda Pelajari

Sumber Belajar

Latihan Praktis

🚨 Bab 7: Pemecahan Masalah & Debugging

Apa yang Akan Anda Pelajari

Sumber Belajar

Latihan Praktis

🏢 Bab 8: Pola Produksi & Perusahaan

Apa yang Akan Anda Pelajari

Sumber Belajar

Latihan Praktis

🎓 Ikhtisar Workshop: Pengalaman Belajar Praktis

Materi Workshop Interaktif

🛠️ Fitur Workshop

📚 Struktur Modul Workshop

🚀 Memulai Workshop

🎯 Hasil Pembelajaran Workshop

📖 Sumber Workshop

📖 Pendalaman: Kapabilitas AZD

AZD + Microsoft Foundry: Sempurna untuk Penyebaran AI

🎯 Perpustakaan Template & Contoh

Unggulan: Template Microsoft Foundry

Unggulan: Skenario Pembelajaran Lengkap

Belajar Berdasarkan Jenis Contoh

Contoh Lokal (Siap Digunakan)

Contoh Lokal - Aplikasi Container (Bab 2-5)

Contoh Eksternal - Aplikasi Sederhana (Bab 1-2)

Contoh Eksternal - Integrasi Database (Bab 3-4)

Keajaiban `azd up`