مشاركة عبر

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

  • مقالة

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

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

إنشاء بيئة

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

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

إشعار

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

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

    az login

  2. تثبيت ملحق Azure مركز التطوير ل CLI.

    az extension add --name devcenter --upgrade

  3. سرد جميع مشاريع Azure Deployment Environments التي لديك حق الوصول إليها:

    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

إشعار

يمكنك استخدام --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 --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"

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