إنشاء بيئة والوصول إليها باستخدام Azure CLI
يشرح هذا الدليل كيفية إنشاء بيئة والوصول إليها في مشروع Azure Deployment Environments موجود باستخدام Azure CLI.
المتطلبات الأساسية
- تثبيت ملحق Azure CLI لبيئات نشر Azure
- إنشاء مركز تطوير وتكوينه باستخدام Azure CLI
- إنشاء مشروع وتكوينه باستخدام Azure CLI
إنشاء بيئة
يؤدي إنشاء بيئة تلقائيا إلى إنشاء الموارد المطلوبة ومجموعة موارد لتخزينها. يتبع اسم مجموعة الموارد النمط {projectName}-{environmentName}
. يمكنك عرض مجموعة الموارد في مدخل Microsoft Azure.
أكمل الخطوات التالية في Azure CLI لإنشاء بيئة وتكوين الموارد. يمكنك عرض المخرجات كما هو محدد في قالب Azure Resource Manager المحدد (قالب ARM).
إشعار
يمكن فقط للمستخدمين الذين لديهم دور مستخدم بيئات النشر أو دور مسؤول مشروع DevCenter أو دور مضمن لديه أذونات مناسبة إنشاء بيئة. يمكن للمستخدمين الذين لديهم دور قارئ بيئات النشر عرض بيئاتهم الخاصة والبيئات التي أنشأها الآخرون.
تسجيل الدخول إلى Azure CLI:
az login
تثبيت ملحق Azure مركز التطوير ل CLI.
az extension add --name devcenter --upgrade
سرد جميع مشاريع Azure Deployment Environments التي لديك حق الوصول إليها:
az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
تكوين الاشتراك الافتراضي كاشتراك يحتوي على المشروع:
az account set --subscription <subscriptionName>
تكوين مجموعة الموارد الافتراضية كمجموعة موارد تحتوي على المشروع:
az config set defaults.group=<resourceGroupName>
سرد نوع البيئات التي يمكنك إنشاؤها في مشروع معين:
az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table
سرد تعريفات البيئة المتوفرة لمشروع معين:
az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table
إنشاء بيئة باستخدام تعريف بيئة (بنية أساسية كقالب تعليمة برمجية محدد في ملف 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.
لحل المشكلة، قم بتعيين الأذونات الصحيحة: منح حق الوصول إلى فريق التطوير.
الوصول إلى بيئة
للوصول إلى بيئة:
سرد البيئات الموجودة المتوفرة في مشروع معين:
az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
عرض نقاط نهاية الوصول إلى موارد مختلفة كما هو محدد في مخرجات قالب ARM.
الوصول إلى الموارد المحددة باستخدام نقاط النهاية.
نشر بيئة
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"