Skip to content

Latest commit

 

History

History
1058 lines (801 loc) · 68.9 KB

File metadata and controls

1058 lines (801 loc) · 68.9 KB

AZD برای مبتدیان: یک مسیر یادگیری ساختاریافته

AZD برای مبتدیان

مشاهده‌کنندگان GitHub Forkهای GitHub ستاره‌های GitHub

Discord آژور Discord Microsoft Foundry


ترجمه‌های خودکار (همیشه به‌روز)

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

ترجیح می‌دهید به‌صورت محلی کلون کنید؟

This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use 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"

این به شما همه چیز مورد نیاز برای تکمیل دوره را با دانلود بسیار سریع‌تر می‌دهد.

🆕 چه چیز جدیدی امروز در azd

Azure Developer CLI فراتر از برنامه‌ها و APIهای وب سنتی رشد کرده است. امروز، azd ابزار واحدی برای استقرار هر برنامه‌ای در Azure است — از جمله برنامه‌های توانمند شده با هوش مصنوعی و عامل‌های هوشمند.

این برای شما چه معنایی دارد:

  • عامل‌های هوش مصنوعی اکنون به‌عنوان بارکاری‌های درجه‌یک در azd پشتیبانی می‌شوند. می‌توانید پروژه‌های عامل هوش مصنوعی را با همان جریان کاری azd initazd up که قبلاً می‌شناسید، مقداردهی اولیه، استقرار و مدیریت کنید.
  • یکپارچه‌سازی Microsoft Foundry استقرار مدل، میزبانی عامل و پیکربندی سرویس‌های AI را مستقیماً به اکوسیستم قالب‌های azd می‌آورد.
  • جریان کاری اصلی تغییر نکرده است. خواه در حال استقرار یک برنامه todo، یک میکروسرویس، یا یک راهکار چندعاملی AI باشید، دستورات یکسان هستند.

اگر قبلاً از azd استفاده کرده‌اید، پشتیبانی AI یک گسترش طبیعی است — نه یک ابزار جدا یا مسیر پیشرفته. اگر تازه شروع می‌کنید، یک جریان کاری خواهید آموخت که برای همه چیز کار می‌کند.


🚀 Azure Developer CLI (azd) چیست؟

Azure Developer CLI (azd) یک ابزار خط فرمان مناسب توسعه‌دهنده است که استقرار برنامه‌ها در Azure را ساده می‌کند. به‌جای ایجاد و اتصال دستی ده‌ها منبع Azure، می‌توانید کل برنامه‌ها را با یک دستور مستقر کنید.

جادوی azd up

# این فرمان واحد همه چیز را انجام می‌دهد:
# ✅ ایجاد همه منابع آزور
# ✅ پیکربندی شبکه و امنیت
# ✅ ساخت کد برنامه شما
# ✅ استقرار در آزور
# ✅ ارائه یک URL عملیاتی به شما
azd up

همین بود! نیازی به کلیک در Azure Portal نیست، نیازی به یادگیری قالب‌های پیچیده ARM در ابتدا نیست، هیچ پیکربندی دستی لازم نیست — فقط برنامه‌های در حال کار روی Azure.


❓ Azure Developer CLI در مقابل Azure CLI: چه تفاوتی دارند؟

این متداول‌ترین سؤالی است که مبتدیان می‌پرسند. این پاسخ ساده است:

ویژگی Azure CLI (az) Azure Developer CLI (azd)
هدف مدیریت منابع منفرد Azure استقرار برنامه‌های کامل
رویکرد متمرکز بر زیرساخت متمرکز بر برنامه
نمونه az webapp create --name myapp... azd up
منحنی یادگیری باید با سرویس‌های Azure آشنا باشید فقط برنامه‌تان را باید بدانید
مناسب برای DevOps، زیرساخت توسعه‌دهندگان، نمونه‌سازی

قیاس ساده

  • Azure CLI شبیه داشتن تمام ابزارهای لازم برای ساختن یک خانه است — چکش، اره، میخ‌ها. شما می‌توانید هر چیزی بسازید، اما باید ساخت‌وساز را بدانید.
  • Azure Developer CLI شبیه استخدام یک پیمانکار است — شما آنچه می‌خواهید را توضیح می‌دهید و او ساختن را بر عهده می‌گیرد.

چه زمانی از هرکدام استفاده کنیم

سناریو از این استفاده کنید
"می‌خواهم وب‌اپ خود را سریع مستقر کنم" azd up
"فقط نیاز دارم یک storage account ایجاد کنم" az storage account create
"دارم یک برنامه کامل AI می‌سازم" azd init --template azure-search-openai-demo
"نیاز دارم یک منبع خاص Azure را اشکال‌زدایی کنم" az resource show
"می‌خواهم استقرار آماده تولید در چند دقیقه داشته باشم" azd up --environment production

آن‌ها با هم کار می‌کنند!

AZD زیرِ قاب از Azure CLI استفاده می‌کند. می‌توانید هر دو را استفاده کنید:

# برنامه خود را با AZD مستقر کنید
azd up

# سپس منابع خاص را با Azure CLI به‌طور دقیق تنظیم کنید
az webapp config set --name myapp --always-on true

🌟 قالب‌ها را در Awesome AZD پیدا کنید

از ابتدا شروع نکنید! Awesome AZD مجموعه‌ای از قالب‌های آماده برای استقرار است:

منبع توضیحات
🔗 Awesome AZD Gallery مرور بیش از 200 قالب و استقرار با یک کلیک
🔗 Submit a Template قالب خود را به جامعه ارسال کنید
🔗 GitHub Repository ستاره دهید و کد منبع را کاوش کنید

قالب‌های محبوب AI از Awesome AZD

# گفتگوی RAG با مدل‌های Microsoft Foundry + جستجوی هوش مصنوعی
azd init --template azure-search-openai-demo

# برنامه سریع گفتگوی هوش مصنوعی
azd init --template openai-chat-app-quickstart

# عوامل هوش مصنوعی با عوامل Foundry
azd init --template get-started-with-ai-agents

🎯 شروع در 3 مرحله

قبل از شروع، مطمئن شوید ماشین شما برای قالبی که می‌خواهید مستقر کنید آماده است:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

اگر هر بررسی ضروری‌ای شکست خورد، ابتدا آن را رفع کنید و سپس با شروع سریع ادامه دهید.

مرحله 1: نصب AZD (2 دقیقه)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

مرحله 2: احراز هویت برای AZD

# اختیاری است اگر می‌خواهید از دستورات Azure CLI به طور مستقیم در این دوره استفاده کنید
az login

# برای جریان‌های کاری AZD الزامی است
azd auth login

اگر مطمئن نیستید کدام یک را نیاز دارید، جریان راه‌اندازی کامل را در نصب و راه‌اندازی دنبال کنید.

مرحله 3: اولین برنامه‌تان را مستقر کنید

# مقداردهی اولیه از یک الگو
azd init --template todo-nodejs-mongo

# استقرار در آزور (همه چیز را ایجاد می‌کند!)
azd up

🎉 همین بود! برنامه شما اکنون روی Azure زنده است.

پاک‌سازی (فراموش نکنید!)

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

📚 چگونه از این دوره استفاده کنید

این دوره برای یادگیری تدریجی طراحی شده است — از جایی شروع کنید که با آن راحت هستید و به‌تدریج پیش بروید:

تجربه شما از اینجا شروع کنید
کاملاً تازه‌وارد به Azure فصل 1: بنیاد
با Azure آشنا، تازه‌کار با AZD فصل 1: بنیاد
می‌خواهید اپلیکیشن‌های AI را مستقر کنید فصل 2: توسعه اول AI
می‌خواهید تمرین عملی داشته باشید 🎓 کارگاه تعاملی - آزمایشگاه هدایت‌شده ۳-۴ ساعته
به الگوهای تولید نیاز دارید فصل 8: تولید و الگوهای سازمانی

راه‌اندازی سریع

  1. این مخزن را فورک کنید: Forkهای GitHub
  2. آن را کلون کنید: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. کمک بگیرید: جامعه Discord آژور

ترجیح می‌دهید به‌صورت محلی کلون کنید؟

This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use 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'

این به شما همه چیز مورد نیاز برای تکمیل دوره را با دانلود بسیار سریع‌تر می‌دهد.

مرور کلی دوره

با طی کردن فصل‌های ساختاریافته که برای یادگیری تدریجی طراحی شده‌اند، بر Azure Developer CLI (azd) مسلط شوید. تمرکز ویژه بر استقرار برنامه‌های AI با یکپارچه‌سازی Microsoft Foundry.

چرا این دوره برای توسعه‌دهندگان مدرن ضروری است

بر اساس دیدگاه‌های جامعه Discord مایکروسافت فاندری، 45% توسعه‌دهندگان می‌خواهند از AZD برای بارهای کاری AI استفاده کنند اما با چالش‌هایی مواجه می‌شوند از جمله:

  • معماری‌های پیچیده چندخدمتی برای AI
  • بهترین شیوه‌های استقرار AI در تولید
  • یکپارچه‌سازی و پیکربندی سرویس‌های AI در Azure
  • بهینه‌سازی هزینه برای بارهای کاری AI
  • رفع‌اشکال مسائل مربوط به استقرارهای خاص AI

اهداف یادگیری

با تکمیل این دوره ساختاریافته، شما:

  • تسلط بر مبانی AZD: مفاهیم پایه، نصب و پیکربندی
  • استقرار برنامه‌های AI: استفاده از AZD با سرویس‌های Microsoft Foundry
  • پیاده‌سازی زیرساخت به‌عنوان کد: مدیریت منابع Azure با قالب‌های Bicep
  • عیب‌یابی استقرارها: حل مشکلات رایج و دیباگ
  • بهینه‌سازی برای تولید: امنیت، مقیاس‌پذیری، مانیتورینگ و مدیریت هزینه
  • ساخت راهکارهای چندعاملی: استقرار معماری‌های پیچیده AI

قبل از شروع: حساب‌ها، دسترسی و پیش‌فرض‌ها

قبل از شروع فصل 1، مطمئن شوید موارد زیر مهیا هستند. مراحل نصب در ادامه این راهنما فرض می‌کنند این موارد پایه از قبل تأمین شده‌اند.

  • یک اشتراک Azure: می‌توانید از یک اشتراک موجود از محل کار یا حساب شخصی خود استفاده کنید، یا یک نسخه آزمایشی رایگان ایجاد کنید تا شروع کنید.
  • اجازه ایجاد منابع Azure: برای بیشتر تمرین‌ها، باید حداقل دسترسی Contributor روی اشتراک یا گروه منابع هدف داشته باشید. بعضی فصل‌ها ممکن است همچنین فرض کنند که می‌توانید گروه‌های منابع، شناسه‌های مدیریت‌شده، و انتصابات RBAC ایجاد کنید.
  • یک حساب GitHub: این برای فورک کردن مخزن، پیگیری تغییرات خود و استفاده از GitHub Codespaces برای کارگاه مفید است.
  • پیش‌نیازهای زمان اجرای قالب: برخی قالب‌ها نیاز به ابزارهای محلی مانند Node.js، Python، Java، یا Docker دارند. قبل از شروع، ابزار اعتبارسنج تنظیمات را اجرا کنید تا کمبود ابزارها را زود متوجه شوید.
  • آشنایی پایه با ترمینال: لازم نیست متخصص باشید، اما باید با اجرای دستوراتی مانند git clone, azd auth login, و azd up راحت باشید.

در حال کار در یک اشتراک سازمانی؟ اگر محیط Azure شما توسط یک مدیر مدیریت می‌شود، پیش از زمان تأیید کنید که می‌توانید در اشتراک یا گروه منابعی که قصد استفاده از آن را دارید، منابع مستقر کنید. در غیر این صورت، قبل از شروع درخواست یک اشتراک سندباکس یا دسترسی Contributor کنید.

تازه‌کار با Azure؟ با نسخه آزمایشی Azure خود یا اشتراک pay-as-you-go در https://aka.ms/azurefreetrial شروع کنید تا بتوانید تمرین‌ها را از ابتدا تا انتها بدون انتظار برای تأییدات سطح تننت انجام دهید.

🗺️ نقشه دوره: ناوبری سریع بر اساس فصل

هر فصل دارای README اختصاصی با اهداف آموزشی، شروع سریع، و تمرین‌ها است:

Chapter Topic Lessons Duration Complexity
فصل 1: بنیاد شروع کار مفاهیم پایه AZD | نصب | اولین پروژه 30-45 دقیقه
فصل 2: توسعه هوش مصنوعی برنامه‌های AI-اول یکپارچگی Foundry | عوامل هوش مصنوعی | استقرار مدل | کارگاه 1-2 ساعت ⭐⭐
فصل 3: پیکربندی احراز هویت و امنیت پیکربندی | احراز هویت و امنیت 45-60 دقیقه ⭐⭐
فصل 4: زیرساخت IaC و استقرار راهنمای استقرار | تأمین منابع 1-1.5 ساعت ⭐⭐⭐
فصل 5: چندعامل راه‌حل‌های عامل هوش مصنوعی سناریوی خرده‌فروشی | الگوهای هماهنگی 2-3 ساعت ⭐⭐⭐⭐
فصل 6: پیش از استقرار برنامه‌ریزی و اعتبارسنجی بررسی‌های پیش‌پرواز | برنامه‌ریزی ظرفیت | انتخاب SKU | Application Insights 1 ساعت ⭐⭐
فصل 7: رفع اشکال دیباگ و رفع خطا مسائل رایج | اشکال‌زدایی | مسائل AI 1-1.5 ساعت ⭐⭐
فصل 8: تولید الگوهای سازمانی روش‌های تولید 2-3 ساعت ⭐⭐⭐⭐
🎓 کارگاه آزمایش عملی مقدمه | انتخاب | اعتبارسنجی | بازشکافی | پیکربندی | سفارشی‌سازی | جمع‌آوری منابع | جمع‌بندی 3-4 ساعت ⭐⭐

مدت زمان کل دوره: ~10-14 ساعت | پیشرفت مهارت: مبتدی → آماده برای تولید


📚 فصل‌های آموزشی

مسیر یادگیری خود را بر اساس سطح تجربه و اهداف انتخاب کنید

🚀 فصل 1: بنیاد و شروع سریع

پیش‌نیازها: اشتراک Azure، دانش پایه خط فرمان
مدت زمان: 30-45 دقیقه
پیچیدگی: ⭐

آنچه می‌آموزید

  • درک اصول خط فرمان توسعه‌دهنده Azure (AZD)
  • نصب AZD روی پلتفرم خود
  • اولین استقرار موفق شما

منابع یادگیری

تمرین‌های عملی

# بررسی سریع نصب
azd version

# اولین برنامهٔ خود را مستقر کنید
azd init --template todo-nodejs-mongo
azd up

💡 نتیجه فصل: استقرار موفق یک برنامه وب ساده در Azure با استفاده از AZD

✅ اعتبارسنجی موفقیت:

# پس از اتمام فصل ۱، باید بتوانید:
azd version              # نسخهٔ نصب‌شده را نشان می‌دهد
azd init --template todo-nodejs-mongo  # پروژه را مقداردهی اولیه می‌کند
azd up                  # روی Azure مستقر می‌کند
azd show                # آدرس URL برنامه در حال اجرا را نمایش می‌دهد
# برنامه در مرورگر باز می‌شود و کار می‌کند
azd down --force --purge  # منابع را پاک‌سازی می‌کند

📊 زمان مورد نیاز: 30-45 دقیقه
📈 سطح مهارت پس از: قادر به استقرار برنامه‌های پایه به‌صورت مستقل 📈 سطح مهارت پس از: قادر به استقرار برنامه‌های پایه به‌صورت مستقل


🤖 فصل 2: توسعه AI-اول (پیشنهاد شده برای توسعه‌دهندگان AI)

پیش‌نیازها: تکمیل فصل 1
مدت زمان: 1-2 ساعت
پیچیدگی: ⭐⭐

آنچه می‌آموزید

  • یکپارچگی Microsoft Foundry با AZD
  • استقرار برنامه‌های مجهز به هوش مصنوعی
  • درک تنظیمات سرویس‌های AI

منابع یادگیری

تمرین‌های عملی

# اولین برنامه هوش مصنوعی خود را مستقر کنید
azd init --template azure-search-openai-demo
azd up

# قالب‌های اضافی هوش مصنوعی را امتحان کنید
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 نتیجه فصل: استقرار و پیکربندی یک برنامه چت مجهز به AI با قابلیت‌های RAG

✅ اعتبارسنجی موفقیت:

# بعد از فصل ۲، باید بتوانید:
azd init --template azure-search-openai-demo
azd up
# رابط چت هوش مصنوعی را آزمایش کنید
# سؤالات بپرسید و پاسخ‌های تولیدشده توسط هوش مصنوعی را همراه با منابع دریافت کنید
# بررسی کنید که ادغام جستجو کار می‌کند
azd monitor  # بررسی کنید که Application Insights داده‌های تله‌متری را نمایش می‌دهد
azd down --force --purge

📊 زمان مورد نیاز: 1-2 ساعت
📈 سطح مهارت پس از: قادر به استقرار و پیکربندی برنامه‌های AI آماده تولید
💰 آگاهی از هزینه: درک هزینه‌های توسعه ~$80-150/ماه، هزینه‌های تولید ~$300-3500/ماه

💰 ملاحظات هزینه برای استقرارهای AI

محیط توسعه (تخمینی $80-150/ماه):

  • مدل‌های Microsoft Foundry (پرداخت به ازای مصرف): $0-50/ماه (بر اساس مصرف توکن)
  • AI Search (رده پایه): $75/ماه
  • Container Apps (مصرفی): $0-20/ماه
  • Storage (استاندارد): $1-5/ماه

محیط تولید (تخمینی $300-3,500+/ماه):

  • مدل‌های Microsoft Foundry (PTU برای عملکرد ثابت): $3,000+/ماه یا پرداخت به ازای مصرف با حجم بالا
  • AI Search (رده استاندارد): $250/ماه
  • Container Apps (اختصاصی): $50-100/ماه
  • Application Insights: $5-50/ماه
  • Storage (پرمیوم): $10-50/ماه

💡 نکات بهینه‌سازی هزینه:

  • برای یادگیری از مدل‌های Microsoft Foundry در رده رایگان استفاده کنید (Azure OpenAI شامل 50,000 توکن/ماه)
  • برای آزادسازی منابع هنگام عدم توسعه فعال، azd down را اجرا کنید
  • با صورتحساب مبتنی بر مصرف شروع کنید، فقط برای تولید به PTU ارتقا دهید
  • از azd provision --preview برای برآورد هزینه‌ها قبل از استقرار استفاده کنید
  • مقیاس‌بندی خودکار را فعال کنید: فقط برای مصرف واقعی پرداخت کنید

نظارت بر هزینه:

# هزینه‌های ماهیانهٔ تخمینی را بررسی کنید
azd provision --preview

# هزینه‌های واقعی را در پورتال Azure نظارت کنید
az consumption budget list --resource-group <your-rg>

⚙️ فصل 3: پیکربندی و احراز هویت

پیش‌نیازها: تکمیل فصل 1
مدت زمان: 45-60 دقیقه
پیچیدگی: ⭐⭐

آنچه می‌آموزید

  • پیکربندی و مدیریت محیط‌ها
  • بهترین شیوه‌های احراز هویت و امنیت
  • نام‌گذاری و سازمان‌دهی منابع

منابع یادگیری

تمرین‌های عملی

  • پیکربندی چندین محیط (dev, staging, prod)
  • راه‌اندازی احراز هویت با شناسه مدیریت‌شده
  • پیاده‌سازی پیکربندی‌های مخصوص هر محیط

💡 نتیجه فصل: مدیریت چندین محیط با احراز هویت و امنیت مناسب


🏗️ فصل 4: زیرساخت به‌عنوان کد و استقرار

پیش‌نیازها: تکمیل فصل‌های 1-3
مدت زمان: 1-1.5 ساعت
پیچیدگی: ⭐⭐⭐

آنچه می‌آموزید

  • الگوهای پیشرفته استقرار
  • زیرساخت به‌عنوان کد با Bicep
  • استراتژی‌های تأمین منابع

منابع یادگیری

تمرین‌های عملی

  • ایجاد قالب‌های Bicep سفارشی
  • استقرار برنامه‌های چندسرویسی
  • پیاده‌سازی استراتژی‌های استقرار blue-green

💡 نتیجه فصل: استقرار برنامه‌های پیچیده چندسرویسی با استفاده از قالب‌های زیرساخت سفارشی


🎯 فصل 5: راه‌حل‌های چندعامل AI (پیشرفته)

پیش‌نیازها: تکمیل فصل‌های 1-2
مدت زمان: 2-3 ساعت
پیچیدگی: ⭐⭐⭐⭐

آنچه می‌آموزید

  • الگوهای معماری چندعامل
  • ارکستراسیون و هماهنگی عوامل
  • استقرارهای AI آماده تولید

منابع یادگیری

تمرین‌های عملی

# استقرار کامل راه‌حل چندعاملی خرده‌فروشی
cd examples/retail-multiagent-arm-template
./deploy.sh

# بررسی پیکربندی‌های عامل
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 نتیجه فصل: استقرار و مدیریت یک راه‌حل چندعامل AI آماده تولید با عوامل مشتری و موجودی


🔍 فصل 6: اعتبارسنجی و برنامه‌ریزی پیش از استقرار

پیش‌نیازها: تکمیل فصل 4
مدت زمان: 1 ساعت
پیچیدگی: ⭐⭐

آنچه خواهید آموخت

  • برنامه‌ریزی ظرفیت و تایید منابع
  • راهبردهای انتخاب SKU
  • بررسی‌های پیش‌استقرار و خودکارسازی

منابع یادگیری

تمرین‌های عملی

  • اسکریپت‌های اعتبارسنجی ظرفیت را اجرا کنید
  • انتخاب‌های SKU را برای کاهش هزینه بهینه کنید
  • بررسی‌های خودکار پیش‌استقرار را پیاده‌سازی کنید

💡 نتیجه فصل: استقرارها را قبل از اجرا اعتبارسنجی و بهینه‌سازی کنید


🚨 فصل 7: عیب‌یابی و اشکال‌زدایی

پیش‌نیازها: تکمیل هر یک از فصل‌های استقرار
مدت زمان: 1-1.5 ساعت
پیچیدگی: ⭐⭐

آنچه خواهید آموخت

  • رویکردهای سیستماتیک اشکال‌زدایی
  • مسائل رایج و راه‌حل‌ها
  • عیب‌یابی مخصوص هوش مصنوعی

منابع یادگیری

تمرین‌های عملی

  • تشخیص شکست‌های استقرار
  • رفع مشکلات احراز هویت
  • رفع اشکال در اتصال سرویس‌های هوش مصنوعی

💡 نتیجه فصل: تشخیص و حل مستقل مسائل رایج استقرار


🏢 فصل 8: الگوهای تولید و سازمانی

پیش‌نیازها: تکمیل فصل‌های 1 تا 4
مدت زمان: 2-3 ساعت
پیچیدگی: ⭐⭐⭐⭐

آنچه خواهید آموخت

  • راهبردهای استقرار در محیط تولید
  • الگوهای امنیتی سازمانی
  • نظارت و بهینه‌سازی هزینه

منابع یادگیری

تمرین‌های عملی

  • پیاده‌سازی الگوهای امنیتی سازمانی
  • راه‌اندازی نظارت جامع
  • استقرار در محیط تولید با حاکمیت مناسب

💡 نتیجه فصل: استقرار برنامه‌های آماده سازمانی با قابلیت‌های کامل تولید


🎓 مرور کارگاه: تجربه یادگیری عملی

⚠️ وضعیت کارگاه: در حال توسعه فعال
مواد کارگاه در حال حاضر در دست توسعه و پالایش هستند. ماژول‌های اصلی عملیاتی هستند، اما برخی بخش‌های پیشرفته کامل نشده‌اند. ما به‌طور فعال در حال تکمیل تمام محتوا هستیم. پیشرفت را دنبال کنید →

مواد کارگاه تعاملی

آموزش جامع دست‌اول با ابزارهای مبتنی بر مرورگر و تمرین‌های هدایت‌شده

مواد کارگاه ما تجربه‌ای ساختاریافته و تعاملی فراهم می‌کند که مکمل برنامه درسی مبتنی بر فصل‌های بالا است. این کارگاه برای هر دو حالت یادگیری خودخوان و جلسات با هدایت مدرس طراحی شده است.

🛠️ ویژگی‌های کارگاه

  • رابط مبتنی بر مرورگر: کارگاه کامل مبتنی بر MkDocs با ویژگی‌های جستجو، کپی و تم
  • ادغام GitHub Codespaces: راه‌اندازی محیط توسعه با یک کلیک
  • مسیر یادگیری ساختاریافته: تمرین‌های هدایت‌شده در 8 ماژول (جمعاً 3-4 ساعت)
  • روش‌شناسی پیش‌رونده: مقدمه → انتخاب → اعتبارسنجی → تجزیه → پیکربندی → سفارشی‌سازی → پاک‌سازی → جمع‌بندی
  • محیط DevContainer تعاملی: ابزارها و وابستگی‌های پیش‌پیکربندی‌شده

📚 ساختار ماژول‌های کارگاه

The workshop follows an 8-module progressive methodology that takes you from discovery to deployment mastery:

ماژول موضوع کارهایی که انجام خواهید داد مدت زمان
0. معرفی مرور کارگاه درک اهداف یادگیری، پیش‌نیازها، و ساختار کارگاه 15 دقیقه
1. انتخاب کشف قالب‌ها کاوش قالب‌های AZD و انتخاب قالب AI مناسب برای سناریوی شما 20 دقیقه
2. اعتبارسنجی استقرار و بررسی قالب را با azd up مستقر کرده و اعتبارسنجی کنید که زیرساخت کار می‌کند 30 دقیقه
3. تجزیه درک ساختار از GitHub Copilot برای کاوش معماری قالب، فایل‌های Bicep، و سازمان‌دهی کد استفاده کنید 30 دقیقه
4. پیکربندی بررسی عمیق azure.yaml بر پیکربندی azure.yaml، هوک‌های چرخه عمر و متغیرهای محیطی تسلط پیدا کنید 30 دقیقه
5. سفارشی‌سازی آن را متعلق به خود کنید جستجوی AI، tracing، ارزیابی را فعال کرده و برای سناریوی خود سفارشی کنید 45 دقیقه
6. پاک‌سازی پاک‌سازی منابع را به‌طور امن پاک کنید با azd down --purge 15 دقیقه
7. جمع‌بندی مراحل بعدی مرور دستاوردها، مفاهیم کلیدی، و ادامه مسیر یادگیری خود 15 دقیقه

Workshop Flow:

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

🚀 شروع کار با کارگاه

# گزینهٔ ۱: GitHub Codespaces (توصیه‌شده)
# در مخزن روی «Code» کلیک کنید → «Create codespace on main»

# گزینهٔ ۲: توسعهٔ محلی
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# دستورالعمل‌های راه‌اندازی در workshop/README.md را دنبال کنید

🎯 نتایج یادگیری کارگاه

با تکمیل کارگاه، شرکت‌کنندگان قادر خواهند بود:

  • استقرار برنامه‌های AI تولیدی: از AZD با سرویس‌های Microsoft Foundry استفاده کنید
  • تسلط بر معماری‌های چندعامله: پیاده‌سازی راه‌حل‌های هماهنگ‌شده عوامل هوش مصنوعی
  • پیاده‌سازی بهترین شیوه‌های امنیتی: پیکربندی احراز هویت و کنترل دسترسی
  • بهینه‌سازی برای مقیاس: طراحی استقرارهای مقرون‌به‌صرفه و با عملکرد مناسب
  • عیب‌یابی استقرارها: حل مستقل مسائل رایج

📖 منابع کارگاه

مناسب برای: آموزش سازمانی، دوره‌های دانشگاهی، یادگیری خودخوان، و بوت‌کمپ‌های توسعه‌دهنده.


📖 بررسی عمیق: قابلیت‌های AZD

فراتر از مبانی، AZD امکانات قدرتمندی برای استقرار در محیط تولید فراهم می‌کند:

  • استقرار مبتنی بر قالب‌ها - استفاده از قالب‌های از پیش‌ساخته برای الگوهای رایج برنامه
  • زیرساخت به‌عنوان کد - مدیریت منابع Azure با استفاده از Bicep یا Terraform
  • گردش‌های کاری یکپارچه - تامین، استقرار، و نظارت بر برنامه‌ها به‌صورت یکپارچه
  • دوستدار توسعه‌دهنده - بهینه‌شده برای بهره‌وری و تجربه توسعه‌دهنده

AZD + Microsoft Foundry: مناسب برای استقرارهای AI

چرا AZD برای راه‌حل‌های AI؟ AZD به چالش‌های اصلی توسعه‌دهندگان هوش مصنوعی پاسخ می‌دهد:

  • قالب‌های آماده AI - قالب‌های پیش‌پیکربندی‌شده برای مدل‌های Microsoft Foundry، Cognitive Services، و بارکاری ML
  • استقرارهای ایمن AI - الگوهای امنیتی داخلی برای سرویس‌های AI، کلیدهای API، و نقاط انتهایی مدل
  • الگوهای AI برای تولید - بهترین شیوه‌ها برای استقرارهای AI مقیاس‌پذیر و مقرون‌به‌صرفه
  • گردش‌های کاری انتها‌به‌انتها برای AI - از توسعه مدل تا استقرار تولید با نظارت مناسب
  • بهینه‌سازی هزینه - تخصیص هوشمند منابع و راهبردهای مقیاس‌گذاری برای بارکاری‌های AI
  • ادغام با Microsoft Foundry - اتصال یکپارچه به کاتالوگ مدل‌ها و نقاط انتهایی Microsoft Foundry

🎯 کتابخانه قالب‌ها و مثال‌ها

ویژه: قالب‌های Microsoft Foundry

اگر در حال استقرار برنامه‌های AI هستید، از اینجا شروع کنید!

توجه: این قالب‌ها الگوهای مختلف AI را نشان می‌دهند. برخی از آنها Azure Samples خارجی هستند، و برخی دیگر پیاده‌سازی‌های محلی هستند.

قالب فصل پیچیدگی خدمات نوع
شروع با چت AI فصل 2 ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights خارجی
شروع با عوامل AI فصل 2 ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights خارجی
دموی Azure Search + OpenAI فصل 2 ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage خارجی
شروع سریع برنامه چت OpenAI فصل 2 AzureOpenAI + Container Apps + Application Insights خارجی
Agent OpenAI Python Prompty فصل 5 ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty خارجی
Contoso Chat RAG فصل 8 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps خارجی
Retail Multi-Agent Solution فصل 5 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB محلی

ویژه: سناریوهای کامل یادگیری

قالب‌های آماده تولید که به فصل‌های آموزشی نگاشت شده‌اند

قالب فصل آموزشی پیچیدگی یادگیری کلیدی
openai-chat-app-quickstart فصل 2 الگوهای پایه استقرار AI
azure-search-openai-demo فصل 2 ⭐⭐ پیاده‌سازی RAG با Azure AI Search
ai-document-processing فصل 4 ⭐⭐ ادغام Document Intelligence
agent-openai-python-prompty فصل 5 ⭐⭐⭐ چارچوب عامل و فراخوانی توابع
contoso-chat فصل 8 ⭐⭐⭐ ارکستراسیون سازمانی AI
retail-multi-agent-solution فصل 5 ⭐⭐⭐⭐ معماری چندعامل با عوامل مشتری و موجودی

یادگیری بر اساس نوع مثال

📌 مثال‌های محلی در مقابل خارجی:
مثال‌های محلی (در این مخزن) = آماده استفاده بلافاصله
مثال‌های خارجی (Azure Samples) = کلون از مخازن لینک‌شده

مثال‌های محلی (آماده استفاده)

  • راه‌حل چندعامل خرده‌فروشی - پیاده‌سازی کامل آماده تولید با قالب‌های ARM
    • معماری چندعامل (عامل مشتری + عامل موجودی)
    • نظارت و ارزیابی جامع
    • استقرار با یک کلیک از طریق قالب ARM

مثال‌های محلی - برنامه‌های کانتینری (فصل‌های 2-5)

مثال‌های جامع استقرار کانتینر در این مخزن:

مثال‌های خارجی - برنامه‌های ساده (فصل‌های 1-2)

برای شروع، این مخازن Azure Samples را کلون کنید:

مثال‌های خارجی - یکپارچه‌سازی پایگاه‌داده (فصل‌های 3-4)

مثال‌های خارجی - الگوهای پیشرفته (فصل‌های 4-8)

مجموعه‌های قالب خارجی


📚 منابع یادگیری و مراجع

مراجع سریع

  • Command Cheat Sheet - دستورات ضروری azd مرتب‌شده بر اساس فصل
  • Glossary - اصطلاحات Azure و azd
  • FAQ - سؤال‌های متداول مرتب‌شده بر اساس فصل آموزشی
  • Study Guide - تمرین‌های جامع عملی

کارگاه‌های عملی

  • AI Workshop Lab - تبدیل راه‌حل‌های هوش مصنوعی شما به امکان استقرار با AZD (2-3 ساعت)
  • Interactive Workshop - تمرین‌های راهنمای ۸ ماژوله با MkDocs و GitHub Codespaces
    • شامل: مقدمه → انتخاب → اعتبارسنجی → تفکیک → پیکربندی → سفارشی‌سازی → پاک‌سازی → جمع‌بندی

منابع یادگیری خارجی

مهارت‌های عامل‌های هوش مصنوعی برای ویرایشگر شما

  • Microsoft Azure Skills on skills.sh - 37 مهارت عامل متن‌باز برای Azure AI، Foundry، استقرار، عیب‌یابی، بهینه‌سازی هزینه و بیشتر. آن‌ها را در GitHub Copilot، Cursor، Claude Code، یا هر عامل پشتیبانی‌شده نصب کنید:
    npx skills add microsoft/github-copilot-for-azure

🔧 راهنمای سریع عیب‌یابی

مشکل‌های رایجی که مبتدیان با آن مواجه می‌شوند و راه‌حل‌های سریع:

❌ "azd: command not found"
# ابتدا AZD را نصب کنید
# ویندوز (PowerShell):
winget install microsoft.azd

# مک‌اواس:
brew tap azure/azd && brew install azd

# لینوکس:
curl -fsSL https://aka.ms/install-azd.sh | bash

# نصب را بررسی کنید
azd version
❌ "No subscription found" or "Subscription not set"
# لیست اشتراک‌های موجود
az account list --output table

# تنظیم اشتراک پیش‌فرض
az account set --subscription "<subscription-id-or-name>"

# تنظیم برای محیط AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# تأیید
az account show
❌ "InsufficientQuota" or "Quota exceeded"
# یک منطقهٔ Azure متفاوت را امتحان کنید
azd env set AZURE_LOCATION "westus2"
azd up

# یا در محیط توسعه از SKUهای کوچکتر استفاده کنید
# فایل infra/main.parameters.json را ویرایش کنید:
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" fails halfway through
# گزینه ۱: پاک‌سازی و تلاش مجدد
azd down --force --purge
azd up

# گزینه ۲: فقط زیرساخت را اصلاح کنید
azd provision

# گزینه ۳: وضعیت دقیق را بررسی کنید
azd show

# گزینه ۴: لاگ‌ها را در Azure Monitor بررسی کنید
azd monitor --logs
❌ "Authentication failed" or "Token expired"
# برای AZD مجدداً احراز هویت کنید
azd auth logout
azd auth login

# اختیاری: اگر دستورات az را اجرا می‌کنید، Azure CLI را نیز به‌روزرسانی کنید
az logout
az login

# احراز هویت را بررسی کنید
az account show
❌ "Resource already exists" or naming conflicts
# AZD نام‌های یکتا تولید می‌کند، اما در صورت تداخل:
azd down --force --purge

# سپس با یک محیط تازه دوباره تلاش کنید
azd env new dev-v2
azd up
❌ Template deployment taking too long

زمان‌های انتظار معمول:

  • برنامه وب ساده: ۵-۱۰ دقیقه
  • برنامه با پایگاه‌داده: ۱۰-۱۵ دقیقه
  • برنامه‌های هوش مصنوعی: ۱۵-۲۵ دقیقه (تهیه منابع OpenAI کند است)
# پیشرفت را بررسی کنید
azd show

# اگر بیش از ۳۰ دقیقه گیر کرده‌اید، پرتال Azure را بررسی کنید:
azd monitor --overview
# به دنبال استقرارهای ناموفق بگردید
❌ "Permission denied" or "Forbidden"
# نقش Azure خود را بررسی کنید
az role assignment list --assignee $(az account show --query user.name -o tsv)

# شما حداقل به نقش "Contributor" نیاز دارید
# از ادمین Azure خود بخواهید که اعطا کند:
# - Contributor (برای منابع)
# - User Access Administrator (برای تخصیص نقش‌ها)
❌ Can't find deployed application URL
# نمایش همه نقاط انتهایی سرویس‌ها
azd show

# یا پورتال Azure را باز کنید
azd monitor

# سرویس خاص را بررسی کنید
azd env get-values
# به دنبال متغیرهای *_URL بگردید

📚 منابع کامل عیب‌یابی


🎓 اتمام دوره و گواهی‌نامه

پیگیری پیشرفت

پیشرفت یادگیری خود را در هر فصل پیگیری کنید:

  • فصل 1: مبانی و شروع سریع ✅
  • فصل 2: توسعه با محوریت AI ✅
  • فصل 3: پیکربندی و احراز هویت ✅
  • فصل 4: زیرساخت به‌عنوان کد و استقرار ✅
  • فصل 5: راه‌حل‌های چندعاملۀ AI ✅
  • فصل 6: اعتبارسنجی و برنامه‌ریزی پیش از استقرار ✅
  • فصل 7: عیب‌یابی و اشکال‌زدایی ✅
  • فصل 8: الگوهای تولیدی و سازمانی ✅

تأیید یادگیری

پس از اتمام هر فصل، دانش خود را با موارد زیر تأیید کنید:

  1. تمرین عملی: استقرار عملی فصل را کامل کنید
  2. بررسی دانش: بخش سؤالات متداول فصل خود را مرور کنید
  3. بحث جامعه‌ای: تجربیات خود را در Azure Discord به اشتراک بگذارید
  4. فصل بعدی: به سطح بعدی پیچیدگی بروید

مزایای اتمام دوره

پس از اتمام همه فصل‌ها، شما خواهید داشت:

  • تجربه تولیدی: استقرار برنامه‌های واقعی هوش مصنوعی در Azure
  • مهارت‌های حرفه‌ای: توانمندی‌های استقرار آماده سازمانی
  • شناخته‌شدن در جامعه: عضو فعال جامعه توسعه‌دهندگان Azure
  • پیشرفت شغلی: تخصص‌های پرتقاضا در استقرار AZD و AI

🤝 جامعه و پشتیبانی

دریافت کمک و پشتیبانی

بینش‌های جامعه از Microsoft Foundry Discord

نتایج نظرسنجی اخیر از کانال #Azure:

  • 45% از توسعه‌دهندگان می‌خواهند از AZD برای بارهای کاری AI استفاده کنند
  • چالش‌های برتر: استقرارهای چندسرویسی، مدیریت اعتبارنامه، آمادگی برای تولید
  • پُرجستجوترین‌ها: قالب‌های خاص AI، راهنماهای عیب‌یابی، بهترین شیوه‌ها

به جامعه ما بپیوندید تا:

  • تجربیات AZD + AI خود را به اشتراک بگذارید و کمک دریافت کنید
  • به پیش‌نمایش‌های اولیه قالب‌های جدید AI دسترسی پیدا کنید
  • در توسعه بهترین شیوه‌های استقرار AI مشارکت کنید
  • در توسعه ویژگی‌های آینده AI + AZD تأثیرگذار باشید

مشارکت در دوره

ما از مشارکت استقبال می‌کنیم! لطفاً راهنمای Contributing Guide را برای جزئیات بخوانید:

  • بهبود محتوا: تقویت فصل‌ها و مثال‌های موجود
  • مثال‌های جدید: افزودن سناریوها و قالب‌های دنیای واقعی
  • ترجمه: کمک به نگهداری پشتیبانی چندزبانه
  • گزارش باگ: افزایش دقت و شفافیت
  • استانداردهای جامعه: پیروی از دستورالعمل‌های جامعه فراگیر ما

📄 اطلاعات دوره

مجوز

این پروژه تحت مجوز MIT منتشر شده است - برای جزئیات فایل LICENSE را ببینید.

منابع آموزشی مرتبط مایکروسافت

تیم ما دوره‌های آموزشی جامعی دیگری نیز تولید می‌کند:

LangChain

LangChain4j برای مبتدیان LangChain.js برای مبتدیان LangChain برای مبتدیان

Azure / Edge / MCP / Agents

AZD برای مبتدیان Edge AI برای مبتدیان MCP برای مبتدیان AI Agents برای مبتدیان


سری هوش مصنوعی مولد

هوش مصنوعی مولد برای مبتدیان هوش مصنوعی مولد (.NET) هوش مصنوعی مولد (Java) هوش مصنوعی مولد (JavaScript)


یادگیری پایه

یادگیری ماشین برای مبتدیان علم داده برای مبتدیان هوش مصنوعی برای مبتدیان امنیت سایبری برای مبتدیان توسعه وب برای مبتدیان اینترنت اشیا برای مبتدیان توسعه XR برای مبتدیان


سری Copilot

Copilot برای برنامه‌نویسی جفتی با هوش مصنوعی Copilot برای C#/.NET ماجراجویی Copilot


🗺️ ناوبری دوره

🚀 آیا آماده‌اید شروع به یادگیری؟

مبتدیان: شروع کنید با فصل 1: پایه و شروع سریع
توسعه‌دهندگان هوش مصنوعی: برو به فصل 2: توسعه مبتنی بر هوش مصنوعی
توسعه‌دهندگان باتجربه: شروع کنید با فصل 3: پیکربندی و احراز هویت

گام‌های بعدی: شروع فصل 1 - مبانی AZD


Disclaimer: این سند با استفاده از سرویس ترجمهٔ مبتنی بر هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما در تلاش برای دقت هستیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است حاوی خطاها یا نادرستی‌هایی باشند. سند اصلی به زبان مبدأ باید به‌عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، ترجمهٔ حرفه‌ای انسانی توصیه می‌شود. ما در قبال هرگونه سوءتفاهم یا برداشت نادرست ناشی از استفاده از این ترجمه مسئولیتی نداریم.