Azure Developer CLI وبيئات نشر Azure

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

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

باستخدام ADE، يمكنك إنشاء بيئات من تعريف بيئة في كتالوج مرفق بمركز التطوير الخاص بك، أو باستخدام نموذج قابلية توسعة 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. كما أنه يدعم قوالب IaC الأخرى، مثل Bicep وTerraform من خلال نموذج قابلية توسعة ADE. لمعرفة كيفية تكوين نموذج قابلية توسعة ADE، راجع نموذج قابلية توسعة Azure Deployment Environments.

لدعم بعض خدمات حوسبة 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 تعرف كيفية العثور على المضيفين ونشر التطبيق لهم.

لمعرفة المزيد حول كيفية جعل تعريف بيئة 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.

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

  • Last updated on