مشاركة عبر

استخدام Azure Developer CLI مع بيئات نشر Azure

  • مقالة

في هذه المقالة، ستتعرف على Azure Developer CLI (azd) وكيفية عمله مع Azure Deployment Environments (ADE) لتوفير البنية الأساسية للتطبيق ونشر التعليمات البرمجية للتطبيق إلى البنية الأساسية الجديدة.

Azure Developer CLI (azd) هي أداة سطر أوامر مفتوحة المصدر توفر أوامر سهلة الاستخدام للمطور تعين المراحل الرئيسية في سير العمل الخاص بك. يمكنك التثبيت azd محليا على جهازك أو استخدامه في بيئات أخرى.

باستخدام ADE، يمكنك إنشاء بيئات من تعريف بيئة في كتالوج مرفق بمركز التطوير الخاص بك. azdبإضافة ، يمكنك نشر التعليمات البرمجية للتطبيق الخاص بك إلى البنية الأساسية الجديدة.

azd كيف يعمل مع ADE؟

azd يعمل مع ADE لتمكينك من إنشاء بيئات من حيث تعمل.

باستخدام ADE و azd، يمكن للمطورين الفرديين الذين يعملون مع بنية أساسية فريدة ورمز يريدون تحميله إلى السحابة إنشاء بيئة من مجلد محلي. يمكنهم استخدام azd لتوفير بيئة ونشر التعليمات البرمجية الخاصة بهم بسلاسة.

على نطاق واسع، يتيح لك استخدام ADE معا azd توفير طريقة للمطورين لإنشاء البنية الأساسية للتطبيق ورمزه. يمكن لفريقك إنشاء بيئات ADE متعددة من نفس azd تعريف البيئة المتوافقة، وتوفير التعليمات البرمجية إلى السحابة بطريقة متسقة.

فهم azd القوالب

تم تصميم أوامر Azure Developer CLI للعمل مع قوالب قياسية. كل قالب هو مستودع تعليمات برمجية يلتزم باصطلاحات ملفات ومجلدات محددة. تحتوي القوالب على الأصول التي azd تحتاج إلى توفير بيئة نشر Azure. عند تشغيل أمر مثل azd up، تستخدم الأداة أصول القالب لتنفيذ خطوات سير العمل المختلفة، مثل توفير الموارد أو نشرها إلى Azure.

فيما يلي بنية قالب نموذجية:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

تتضمن جميع azd القوالب الأصول التالية:

  • المجلد infra - لا يتم استخدام المجلد infra في azd مع ADE. يحتوي على جميع البنية الأساسية Bicep أو Terraform كملفات تعليمات برمجية لقالب azd. يوفر ADE البنية الأساسية كملفات تعليمات برمجية للقالب azd . لا تحتاج إلى تضمين هذه الملفات في القالب الخاص بك azd .

  • ملف azure.yaml - ملف تكوين يحدد خدمة واحدة أو أكثر في مشروعك ويرسمها إلى موارد Azure للنشر. على سبيل المثال، قد تقوم بتعريف خدمة واجهة برمجة التطبيقات وخدمة واجهة ويب أمامية، لكل منها سمات تعينها إلى موارد Azure مختلفة للنشر.

  • مجلد .azure - يحتوي على تكوينات Azure الأساسية ومتغيرات البيئة، مثل موقع نشر الموارد أو معلومات الاشتراك الأخرى.

  • مجلد src - يحتوي على جميع التعليمات البرمجية المصدر للتطبيق القابلة للنشر. توفر بعض azd القوالب أصول البنية الأساسية فقط وتترك دليل src فارغا لك لإضافة التعليمات البرمجية للتطبيق الخاص بك.

تتضمن معظم azd القوالب أيضا بشكل اختياري مجلدا واحدا أو أكثر من المجلدات التالية:

  • مجلد .devcontainer - يسمح لك بإعداد بيئة حاوية Dev لتطبيقك. هذا نهج بيئة تطوير شائعة غير خاصة ب azd.

  • مجلد .github - يحتفظ بملفات سير عمل CI/CD لإجراءات GitHub، وهو موفر CI/CD الافتراضي ل azd.

  • مجلد .azdo - إذا قررت استخدام Azure Pipelines ل CI/CD، فحدد ملفات تكوين سير العمل في هذا المجلد.

azd الكتالوجات المتوافقة

تتكون كتالوجات Azure Deployment Environments من تعريفات البيئة: قوالب IaC التي تحدد موارد البنية الأساسية التي يتم توفيرها لبيئة التوزيع. يستخدم Azure Developer CLI تعريفات البيئة في الكتالوج المرفق بمركز التطوير لتوفير بيئات جديدة.

إشعار

حاليا، يعمل Azure Developer CLI مع قوالب ARM المخزنة في كتالوج مركز تطوير بيئات نشر Azure.

لدعم بعض خدمات حوسبة Azure بشكل صحيح، يتطلب Azure Developer CLI المزيد من إعدادات التكوين في قالب IaC. على سبيل المثال، يجب وضع علامة على مضيفي خدمة التطبيق بمعلومات محددة بحيث azd تعرف كيفية العثور على المضيفين ونشر التطبيق لهم.

يمكنك مشاهدة قائمة بخدمات Azure المدعومة هنا: خدمات حساب Azure المدعومة (المضيف).

جعل كتالوج ADE متوافقا مع azd

لتمكين فرق التطوير الخاصة بك لنا azd باستخدام ADE، تحتاج إلى إنشاء تعريف بيئة في الكتالوج الخاص بك متوافق مع azd. يمكنك إنشاء تعريف بيئة متوافق جديد azd، أو يمكنك استخدام تعريف بيئة موجود من كتالوج مركز تطوير بيئات نشر Azure. إذا اخترت استخدام تعريف بيئة موجود، فستحتاج إلى إجراء بعض التغييرات لجعله متوافقا مع azd.

تتضمن التغييرات ما يلي:

  • إذا كنت تقوم بتعديل قالب موجود azd ، فقم بإزالة infra المجلد. يستخدم ADE الملفات التالية لإنشاء البنية الأساسية:
    • قالب ARM (azuredeploy.json.)
    • ملف التكوين الذي يعرف المعلمات (environment.yaml أو manifest.yaml)
  • ضع علامة على الموارد في azure.yaml بمعلومات محددة بحيث azd تعرف كيفية العثور على المضيفين ونشر التطبيق لهم.
  • تكوين إعدادات مركز التطوير مثل متغيرات azd البيئة وتكوين azd البيئة وتكوين المشروع وتكوين المستخدم.

لمعرفة المزيد حول كيفية جعل تعريف بيئة ADE متوافقا مع azd، راجع جعل مشروعك متوافقا مع Azure Developer CLI.

تمكين azd الدعم في ADE

لتمكين azd الدعم باستخدام ADE، تحتاج إلى تعيين platform.type إلى devcenter. يسمح azd هذا التكوين بالاستفادة من مكونات مركز التطوير الجديدة لحالة البيئة البعيدة وتوفيرها، ويعني أنه سيتم تجاهل المجلد infra في القوالب بشكل فعال. بدلا من ذلك، azd سوف تستخدم أحد قوالب البنية الأساسية المحددة في كتالوج مركز التطوير لتوفير الموارد.

لتمكين azd الدعم، قم بتشغيل الأمر التالي:

 azd config set platform.type devcenter

استكشاف azd الأوامر

عند تمكين ميزة مركز التطوير، يتغير السلوك الافتراضي لبعض أوامر azd الشائعة للعمل مع هذه البيئات البعيدة. لمزيد من المعلومات، راجع العمل مع بيئات نشر Azure.

المحتوى ذو الصلة