إنشاء بيئة والوصول إليها باستخدام Azure CLI

توضح هذه المقالة كيفية إنشاء بيئة والوصول إليها في مشروع بيئات توزيع Azure موجود باستخدام Azure CLI.

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

Category	احتياج
Installation	ملحق Azure CLI لبيئات توزيع Azure.
إجراء	إكمال إنشاء مركز تطوير وتكوينه باستخدام Azure CLI.
إجراء	إكمال إنشاء مشروع وتكوينه باستخدام Azure CLI.
الأذونات	لإنشاء بيئة: دور مستخدم بيئات النشر أو دور مسؤول مشروع DevCenter أو دور مضمن له أذونات مناسبة.

إنشاء بيئة

يؤدي إنشاء بيئة تلقائيا إلى إنشاء الموارد المطلوبة ومجموعة موارد لتخزينها. يتبع اسم مجموعة الموارد النمط {projectName}-{environmentName}. يمكنك عرض مجموعة الموارد في مدخل Microsoft Azure.

أكمل الخطوات التالية في Azure CLI لإنشاء بيئة وتكوين الموارد. يمكنك عرض المخرجات كما هو محدد في قالب Azure Resource Manager المحدد (قالب ARM).

Note

يمكن فقط للمستخدمين الذين لديهم دور مستخدم بيئات النشر أو دور مسؤول مشروع DevCenter أو دور مضمن لديه أذونات مناسبة إنشاء بيئة. يمكن للمستخدمين الذين لديهم دور قارئ بيئات النشر عرض بيئاتهم وبيئاتهم التي أنشأها الآخرون.

1. سجل الدخول إلى Azure CLI:

   az login
   

2. قم بتثبيت ملحق مركز تطوير Azure أو ترقيته لواجهة سطر الأوامر (CLI):

   az extension add --name devcenter --upgrade
   

3. ضع قائمة بجميع مشاريع بيئات توزيع Azure التي يمكنك الوصول إليها:

   az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
   

4. قم بتكوين الاشتراك الافتراضي كاشتراك يحتوي على المشروع:

   az account set --subscription <subscriptionName>
   

5. قم بتكوين مجموعة الموارد الافتراضية كمجموعة الموارد التي تحتوي على المشروع:

   az config set defaults.group=<resourceGroupName>
   

6. قم بإدراج نوع البيئات التي يمكنك إنشاؤها في مشروع معين:

   az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table
   

7. سرد تعريفات البيئة المتوفرة لمشروع معين:

   az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table
   

8. قم بإنشاء بيئة باستخدام تعريف البيئة (قالب البنية التحتية كتعليمات برمجية تم تعريفه في ملف environment.yaml ) من قائمة تعريفات البيئة المتوفرة:

   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
   

   إذا كان تعريف البيئة المحدد يتطلب أي معلمات، فاستخدم --parameters المعلمات وقم بتوفيرها كسلسلة JSON أو ملف JSON. على سبيل المثال:

   $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
       --parameters $params
   

Note

يمكنك استخدامها --help لعرض مزيد من التفاصيل حول أي أمر وسيطات مقبولة وأمثلة. على سبيل المثال، استخدم az devcenter dev environment create --help لعرض مزيد من التفاصيل حول إنشاء بيئة.

استكشاف أخطاء الأذونات وإصلاحها

يجب أن يكون لديك دور مستخدم بيئات النشر أو دور مسؤول مشروع DevCenter أو دور مضمن يحتوي على الأذونات المطلوبة لإنشاء بيئة.

إذا لم يكن لديك الأذونات الصحيحة، فلن يتم إنشاء البيئة. قد تظهر رسالة خطأ مثل المثال التالي:

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

لحل المشكلة، قم بتعيين الأذونات الصحيحة: امنح حق الوصول إلى فريق التطوير.

الوصول إلى بيئة

للوصول إلى بيئة:

1. سرد البيئات الموجودة المتوفرة في مشروع معين:

    az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
   

2. عرض نقاط نهاية الوصول إلى موارد مختلفة كما هو محدد في مخرجات قالب ARM.

3. الوصول إلى الموارد المحددة باستخدام نقاط النهاية.

نشر بيئة

az devcenter dev environment deploy --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

حذف بيئة

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

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

• إضافة كتالوج وتكوينه من GitHub أو Azure DevOps
• إضافة تعريف بيئة وتكوينه