إنشاء بيئة باستخدام Azure Developer CLI

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

Azure Developer CLI (AZD) هي أداة مفتوحة المصدر تعمل على تسريع الوقت الذي تستغرقه للحصول على التطبيق الخاص بك من بيئة التطوير المحلية إلى Azure. يوفر AZD أفضل الممارسات، وأوامر سهلة الاستخدام للمطورين يتم تعيينها إلى المراحل الرئيسية في سير العمل، سواء كنت تعمل في المحطة الطرفية أو المحرر أو بيئة التطوير المتكاملة (IDE) أو CI/CD (التكامل المستمر/النشر المستمر).

لمعرفة كيفية إعداد AZD للعمل مع بيئات نشر Azure، راجع استخدام Azure Developer CLI مع بيئات نشر Azure.

المتطلبات الأساسية

ينبغي عليك:

• كن على دراية ببيئات نشر Azure. راجع ما هي بيئات نشر Azure؟ والمفاهيم الرئيسية لبيئات نشر Azure.
• إنشاء مركز تطوير وتكوينه باستخدام مشروع وأنواع بيئة وكتالوج. استخدم المقالة التالية كإرشادات:
  • التشغيل السريع: إنشاء وتكوين مركز تطوير لبيئات نشر Azure.
• كتالوج مرفق بمركز التطوير الخاص بك.

الاستعداد للعمل مع AZD

عند العمل مع AZD للمرة الأولى، هناك بعض مهام الإعداد لمرة واحدة التي تحتاج إلى إكمالها. تتضمن هذه المهام تثبيت Azure Developer CLI، وتسجيل الدخول إلى حساب Azure الخاص بك، وتمكين دعم AZD لبيئات نشر Azure.

تثبيت ملحق Azure Developer CLI ل Visual Studio Code

عند تثبيت azd، يتم تثبيت أدوات azd ضمن نطاق azd بدلا من عموميا، وتتم إزالتها إذا تم إلغاء تثبيت azd. يمكنك تثبيت azd في Visual Studio Code أو من سطر الأوامر.

Visual Studio Code

لتمكين ميزات Azure Developer CLI في Visual Studio Code، قم بتثبيت ملحق Azure Developer CLI، الإصدار v0.8.0-alpha.1-beta.3173884. حدد أيقونة الملحقات في شريط النشاط، وابحث عن Azure Developer CLI، ثم حدد Install.

Azure Developer CLI

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Visual Studio

في Visual Studio 2022 17.3 Preview 2 أو أحدث، يمكنك تمكين التكامل مع azd كميزة معاينة.

لتمكين ميزة azd، انتقل إلى Tools>Options>Environment>Preview Features وحدد Integration with azd، وAzure Developer CLI.

عند تمكين الميزة، يمكنك استخدام Azure Developer CLI من المحطة الطرفية التي تختارها على Windows أو Linux أو macOS.

تسجيل الدخول باستخدام Azure Developer CLI

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

سجل الدخول إلى AZD باستخدام لوحة الأوامر:

Visual Studio Code

يتم عرض إخراج الأوامر الصادرة من لوحة الأوامر في azd dev terminal مثل المثال التالي:

Azure Developer CLI

سجل الدخول إلى Azure في CLI باستخدام الأمر التالي:

 azd auth login

Visual Studio

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

لفتح موجه أوامر المطور:

1. من القائمة أدوات، حدد Terminal.

2. في نافذة Terminal ، حدد Developer Command Prompt.

   

سجل الدخول إلى AZD باستخدام الوحدة الطرفية لأوامر المطور:

 azd auth login

تمكين دعم AZD ل ADE

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

Visual Studio Code

Azure Developer CLI

 azd config set platform.type devcenter

Visual Studio

 azd config set platform.type devcenter

إنشاء بيئة من التعليمات البرمجية الموجودة

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

تهيئة تطبيق جديد

تهيئة تطبيق جديد بإنشاء الملفات والمجلدات المطلوبة ل AZD للعمل مع التطبيق الخاص بك.

يستخدم AZD ملف azure.yaml لتعريف البيئة. يعرف ملف azure.yaml التطبيقات وأنواع موارد Azure التي يستخدمها التطبيق ويصفها. لمعرفة المزيد حول azure.yaml، راجع مخطط Azure.yaml الخاص ب Azure Developer CLI.

Visual Studio Code

1. في Visual Studio Code، افتح المجلد الذي يحتوي على التعليمات البرمجية للتطبيق الخاص بك.

2. افتح لوحة الأوامر، وأدخل Azure Developer CLI init، ثم من القائمة، حدد Azure Developer CLI (azd): init.

   

3. في قائمة القوالب، للمتابعة دون تحديد قالب، اضغط على ENTER مرتين.

4. في المحطة الطرفية AZD، حدد استخدام التعليمات البرمجية في الدليل الحالي.

   

5. azd init يحدد الخدمات المعرفة في التعليمات البرمجية للتطبيق الخاص بك ويطالبك بتأكيد الخدمة ومتابعتها أو إزالتها أو إضافة خدمة. حدد تأكيد ومتابعة تهيئة تطبيقي.

   

6. azd init يستمر في جمع المعلومات لتكوين تطبيقك. بالنسبة لهذا التطبيق المثال، تتم مطالبتك باسم مثيل قاعدة بيانات MongoDB والمنافذ التي تستمع إليها الخدمات.

   

7. أدخل اسما لبيئة AZD المحلية.

   

8. azd init يعرض قائمة المشاريع التي يمكنك الوصول إليها. تحديد المشروع للبيئة الخاصة بك

   

9. azd init يعرض قائمة بتعريفات البيئة في المشروع. حدد تعريف بيئة.

   

   ينشئ AZD موارد المشروع، بما في ذلك ملف azure.yaml في جذر مشروعك.

Azure Developer CLI

1. في CLI، انتقل إلى المجلد الذي يحتوي على التعليمات البرمجية للتطبيق الخاص بك.

2. قم بتشغيل الأمر التالي لتهيئة التطبيق الخاص بك وتوفير المعلومات عند مطالبتك:

   azd init
   

3. في المحطة الطرفية AZD، حدد استخدام التعليمات البرمجية في الدليل الحالي.

   

   يقوم AZD بفحص الدليل الحالي وجمع المزيد من المعلومات اعتمادا على نوع التطبيق الذي تقوم ببناءه. اتبع المطالبات لتكوين بيئة AZD.

4. azd init يحدد الخدمات المعرفة في التعليمات البرمجية للتطبيق الخاص بك ويطالبك بتأكيد الخدمة ومتابعتها أو إزالتها أو إضافة خدمة. حدد تأكيد ومتابعة تهيئة تطبيقي.

   

5. azd init يستمر في جمع المعلومات لتكوين تطبيقك. بالنسبة لهذا التطبيق المثال، تتم مطالبتك باسم مثيل قاعدة بيانات MongoDB والمنافذ التي تستمع إليها الخدمات.

   

6. أدخل اسما لبيئة AZD المحلية.

   

7. azd init يعرض قائمة المشاريع التي يمكنك الوصول إليها. حدد المشروع للبيئة الخاصة بك.

   

8. azd init يعرض قائمة بتعريفات البيئة في المشروع. حدد تعريف بيئة.

   

   ينشئ AZD موارد المشروع، بما في ذلك ملف azure.yaml في جذر مشروعك.

Visual Studio

1. في CLI، انتقل إلى المجلد الذي يحتوي على التعليمات البرمجية للتطبيق الخاص بك.

2. قم بتشغيل الأمر التالي لتهيئة التطبيق الخاص بك وتوفير المعلومات عند مطالبتك:

   azd init
   

3. في المحطة الطرفية AZD، حدد استخدام التعليمات البرمجية في الدليل الحالي.

   

   يقوم AZD بفحص الدليل الحالي وجمع المزيد من المعلومات اعتمادا على نوع التطبيق الذي تقوم ببناءه. اتبع المطالبات لتكوين بيئة AZD.

4. azd init يحدد الخدمات المعرفة في التعليمات البرمجية للتطبيق الخاص بك ويطالبك بتأكيد الخدمة ومتابعتها أو إزالتها أو إضافة خدمة. حدد تأكيد ومتابعة تهيئة تطبيقي.

   

5. azd init يستمر في جمع المعلومات لتكوين تطبيقك. بالنسبة لهذا التطبيق المثال، تتم مطالبتك باسم مثيل قاعدة بيانات MongoDB والمنافذ التي تستمع إليها الخدمات.

   

6. أدخل اسما لبيئة AZD المحلية.

   

7. azd init يعرض قائمة المشاريع التي يمكنك الوصول إليها. حدد المشروع للبيئة الخاصة بك.

   

8. azd init يعرض قائمة بتعريفات البيئة في المشروع. حدد تعريف بيئة.

   ينشئ AZD موارد المشروع، بما في ذلك ملف azure.yaml في جذر مشروعك.

توفير البنية الأساسية لبيئة نشر Azure

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

Visual Studio Code

1. في Explorer، انقر بزر الماوس الأيمن فوق azure.yaml، ثم حدد Azure Developer CLI (azd)>Provision Azure Resources (provision).

   

2. يقوم AZD بفحص Azure Deployment Environments بحثا عن المشاريع التي يمكنك الوصول إليها. في المحطة الطرفية AZD، حدد المعلومات التالية أو أدخلها:

   1. Project
   2. تعريف البيئة
   3. نوع البيئة
   4. ‏‏الموقع

3. يرشد AZD ADE لإنشاء بيئة جديدة استنادا إلى المعلومات التي قدمتها في الخطوة السابقة.

4. يمكنك عرض الموارد التي تم إنشاؤها في مدخل Microsoft Azure أو في مدخل المطور.

Azure Developer CLI

توفير التطبيق الخاص بك إلى Azure باستخدام الأمر التالي:

azd provision

1. يوفر "توفير azd" قائمة المشاريع التي يمكنك الوصول إليها. حدد المشروع الذي تريد توفير التطبيق الخاص بك إليه.

   

2. يوفر "azd provision" قائمة بتعريفات البيئة في المشروع المحدد. حدد تعريف البيئة الذي تريد استخدامه لتوفير التطبيق الخاص بك.

   

3. يوفر "توفير azd" قائمة أنواع البيئة في المشروع المحدد. حدد نوع البيئة الذي تريد استخدامه لتوفير التطبيق الخاص بك.

   

4. يرشد AZD ADE لإنشاء بيئة جديدة استنادا إلى المعلومات التي قدمتها في الخطوة السابقة.

   

5. يمكنك عرض الموارد التي تم إنشاؤها في مدخل Microsoft Azure أو في مدخل المطور.

Visual Studio

توفير التطبيق الخاص بك إلى Azure باستخدام الأمر التالي:

azd provision

1. يوفر "توفير azd" قائمة المشاريع التي يمكنك الوصول إليها. حدد المشروع الذي تريد توفير التطبيق الخاص بك إليه.

   

2. يوفر "azd provision" قائمة بتعريفات البيئة في المشروع المحدد. حدد تعريف البيئة الذي تريد استخدامه لتوفير التطبيق الخاص بك.

   

3. يوفر "توفير azd" قائمة أنواع البيئة في المشروع المحدد. حدد نوع البيئة الذي تريد استخدامه لتوفير التطبيق الخاص بك.

4. يرشد AZD ADE لإنشاء بيئة جديدة استنادا إلى المعلومات التي قدمتها في الخطوة السابقة.

5. يمكنك عرض الموارد التي تم إنشاؤها في مدخل Microsoft Azure أو في مدخل المطور.

سرد البيئات الموجودة (اختياري)

تحقق من إنشاء البيئة الخاصة بك عن طريق سرد البيئات الموجودة.

Visual Studio Code

1. في Explorer، انقر بزر الماوس الأيمن فوق azure.yaml، ثم حدد Azure Developer CLI (azd)>View Local and Remote Environments (env list).

   

   تتم مطالبتك بتحديد مشروع وتعريف بيئة.

Azure Developer CLI

استخدم الأمر التالي لعرض البيئات التي لديك حق الوصول إليها: بيئة AZD المحلية وبيئة بيئات نشر Azure البعيدة.

azd env list

azd env list يطالبك بتحديد مشروع وتعريف بيئة.

Visual Studio

استخدم الأمر التالي لعرض البيئات التي لديك حق الوصول إليها: بيئة AZD المحلية وبيئة بيئات نشر Azure البعيدة.

azd env list

azd env list يطالبك بتحديد مشروع وتعريف بيئة.

نشر التعليمات البرمجية إلى بيئات نشر Azure

عند توفير البيئة الخاصة بك، يمكنك نشر التعليمات البرمجية الخاصة بك إلى البيئة.

Visual Studio Code

1. في Explorer، انقر بزر الماوس الأيمن فوق azure.yaml، ثم حدد Azure Developer CLI (azd)>Deploy Azure Resources (deploy).

   

2. يمكنك التحقق من نشر التعليمات البرمجية الخاصة بك عن طريق تحديد عناوين URL لنقطة النهاية المدرجة في المحطة الطرفية AZD.

Azure Developer CLI

انشر التعليمات البرمجية للتطبيق الخاص بك إلى بيئة بيئات نشر Azure البعيدة التي قمت بتوفيرها باستخدام الأمر التالي:

azd deploy

قد يستغرق نشر التعليمات البرمجية الخاصة بك إلى البيئة البعيدة عدة دقائق.

يمكنك عرض تقدم النشر في مدخل Microsoft Azure:

عند اكتمال النشر، يمكنك عرض الموارد التي تم توفيرها في مدخل Microsoft Azure:

يمكنك التحقق من نشر التعليمات البرمجية الخاصة بك عن طريق تحديد عناوين URL لنقطة النهاية المدرجة في المحطة الطرفية AZD.

بالنسبة لهذا التطبيق النموذجي، ترى شيئا مثل هذا:

Visual Studio

انشر التعليمات البرمجية للتطبيق الخاص بك إلى بيئة بيئات نشر Azure البعيدة التي قمت بتوفيرها باستخدام الأمر التالي:

azd deploy

قد يستغرق نشر التعليمات البرمجية الخاصة بك إلى البيئة البعيدة عدة دقائق.

يمكنك عرض تقدم النشر في مدخل Microsoft Azure:

عند اكتمال النشر، يمكنك عرض الموارد التي تم توفيرها في مدخل Microsoft Azure:

يمكنك التحقق من نشر التعليمات البرمجية الخاصة بك عن طريق تحديد عناوين URL لنقطة النهاية المدرجة في المحطة الطرفية AZD.

تنظيف الموارد

عند الانتهاء من بيئتك، يمكنك حذف موارد Azure.

Visual Studio Code

في Explorer، انقر بزر الماوس الأيمن فوق azure.yaml، ثم حدد Azure Developer CLI (azd)>Delete Deployment and Resources (down).

تأكد من رغبتك في حذف البيئة عن طريق إدخال y عند مطالبتك بذلك.

Azure Developer CLI

احذف موارد Azure باستخدام الأمر التالي:

azd down --environment <environmentName>

Visual Studio

احذف موارد Azure باستخدام الأمر التالي:

azd down --environment <environmentName>

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

• إنشاء مركز تطوير وتكوينه
• ما هو Azure Developer CLI؟
• تثبيت أو تحديث Azure Developer CLI