إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تشرح هذه المقالة كيفية إضافة تعريف بيئة أو تحديثه أو حذفه في كتالوج Azure Deployment Environments. كما يشرح كيفية الرجوع إلى صورة حاوية لنشر بيئتك.
في بيئات التوزيع، يمكنك استخدام كتالوج لتزويد فرق التطوير لديك بمجموعة منسقة من البنية الأساسية المحددة مسبقا كقوالب تعليمات برمجية (IaC) تسمى تعريفات البيئة.
يتكون تعريف البيئة من ملفين على الأقل:
- قالب من إطار عمل IaC. على سبيل المثال:
- قد يستخدم قالب Azure Resource Manager (ARM) ملفا يسمى azuredeploy.json.
- قد يستخدم ملف Bicep ملفا يسمى main.bicep.
- قد يستخدم قالب Terraform ملفا يسمى azuredeploy.tf.
- ملف تكوين يوفر بيانات تعريف حول القالب. يجب تسمية هذا الملف environment.yaml.
تستخدم فرق التطوير تعريفات البيئة التي تقدمها في الكتالوج لنشر البيئات في Azure.
توفر Microsoft نموذجا للكتالوج يمكنك استخدامه كمستودع الخاص بك. يمكنك أيضا استخدام المستودع الخاص بك، أو يمكنك نسخ تعريفات البيئة وتخصيصها في الكتالوج النموذجي.
بعد إضافة كتالوج إلى مركز التطوير الخاص بك، تقوم الخدمة بمسح مسار المجلد المحدد لتحديد المجلدات التي تحتوي على قالب وملف بيئة مقترن. يجب أن يكون مسار المجلد المحدد مجلدا يحتوي على مجلدات فرعية تحتوي على ملفات تعريف البيئة.
إضافة تعريف بيئة
لإضافة تعريف بيئة إلى كتالوج في بيئات النشر، يمكنك أولا إضافة الملفات إلى المستودع. ثم تقوم بمزامنة كتالوج مركز التطوير مع المستودع المحدث.
لإضافة تعريف بيئة:
في مستودع GitHub أو Azure DevOps ، أنشئ مجلدا فرعيا في مسار مجلد المستودع.
أضف ملفين إلى المجلد الفرعي للمستودع الجديد:
ملف قالب IaC.
بيئة كملف YAML.
يحتوي الملف environment.yaml على بيانات تعريف متعلقة بقالب IaC.
البرنامج النصي التالي هو مثال على محتويات ملف environment.yaml لقالب ARM:
name: WebApp version: 1.0.0 summary: Azure Web App Environment description: Deploys a web app in Azure without a datastore runner: ARM templatePath: azuredeploy.jsonيصف هذا الجدول الحقول الموجودة في ملف environment.yaml:
الحقل الوصف nameاسم تعريف البيئة. versionإصدار تعريف البيئة. هذا الحقل اختياري. summaryوصف موجز لتعريف البيئة. descriptionوصف مفصل لتعريف البيئة. runnerإطار عمل IaC الذي يستخدمه القالب. يمكن أن تكون ARMالقيمة أوBicep. يمكنك أيضا تحديد مسار إلى قالب مخزن في سجل حاوية.templatePathالمسار إلى ملف قالب IaC. لمعرفة المزيد حول الخيارات وأنواع البيانات التي يمكنك استخدامها في environment.yaml، راجع المعلمات وأنواع البيانات في environment.yaml.
في مركز التطوير الخاص بك، ضمن تكوين البيئة، حدد الكتالوجات. حدد المستودع، ثم حدد مزامنة.
تقوم الخدمة بفحص المستودع للعثور على تعريفات بيئة جديدة. بعد مزامنة المستودع، تتوفر تعريفات بيئة جديدة لجميع المشاريع في مركز التطوير.
استخدام صور الحاوية لنشر البيئات
تستخدم بيئات النشر صور الحاوية لتحديد كيفية نشر قوالب بيئات التوزيع. تدعم بيئات التوزيع ARM وBicep في الأصل، بحيث يمكنك تكوين تعريف بيئة ينشر موارد Azure لبيئة توزيع عن طريق إضافة ملفات القالب (azuredeploy.json وenvironment.yaml) إلى الكتالوج الخاص بك. تستخدم بيئات التوزيع بعد ذلك صورة حاوية ARM أو Bicep قياسية لإنشاء بيئة التوزيع.
يمكنك إنشاء صور حاوية مخصصة لنشر بيئة أكثر تقدما. على سبيل المثال، يمكنك تشغيل البرامج النصية قبل النشر أو بعده. تدعم بيئات النشر صور الحاويات المخصصة لعمليات نشر البيئة، والتي يمكن أن تساعد في نشر أطر عمل IaC مثل Pulumi وTerraform.
للبدء، يمكنك الحصول على عينة من صور حاوية ARM وBicep عبر Microsoft Artifact Registry (المعروف أيضا باسم Microsoft Container Registry).
لمزيد من المعلومات حول إنشاء صورة حاوية مخصصة، راجع تكوين صورة حاوية لتنفيذ عمليات النشر.
حدد صورة حاوية نموذج ARM أو Bicep
في الملف environment.yaml، تحدد الخاصية runner موقع الصورة التي تريد استخدامها. لاستخدام نموذج الصورة المنشورة في Microsoft Artifact Registry، استخدم القيم المدرجة runner في الجدول التالي.
| إطار عمل IaC |
runner قيمة |
|---|---|
| ذراع | ذراع |
| Bicep | Bicep |
| Terraform | لا توجد صورة عينة. استخدم صورة حاوية مخصصة بدلا من ذلك. |
يوضح المثال التالي خاصية runner تشير إلى نموذج صورة حاوية Bicep:
name: WebApp
version: 1.0.0
summary: Azure Web App Environment
description: Deploys a web app in Azure without a datastore
runner: Bicep
templatePath: azuredeploy.json
تحديد صورة حاوية مخصصة
لاستخدام صورة حاوية مخصصة مخزنة في مستودع، استخدم التنسيق التالي runner في ملف environment.yaml:
runner: "{YOUR_REGISTRY}.azurecr.io/{YOUR_REPOSITORY}:{YOUR_TAG}”`
قم بتحرير runner القيمة للإشارة إلى المستودع والصورة المخصصة، كما هو موضح في هذا المثال:
name: WebApp
version: 1.0.0
summary: Azure Web App Environment
description: Deploys a web app in Azure without a datastore
runner: "{YOUR_REGISTRY}.azurecr.io/{YOUR_REPOSITORY}:{YOUR_TAG}"
templatePath: azuredeploy.json
| الخاصية | الوصف |
|---|---|
| YOUR_REGISTRY | السجل الذي يخزن الصورة المخصصة. |
| YOUR_REPOSITORY | المستودع الخاص بك في هذا السجل. |
| YOUR_TAG | علامة، مثل رقم الإصدار. |
تحديد معلمات لتعريف بيئة
يمكنك تحديد معلمات لتعريفات البيئة الخاصة بك للسماح للمطورين بتخصيص بيئاتهم.
يتم تعريف المعلمات في ملف environment.yaml.
البرنامج النصي التالي هو مثال على ملف environment.yaml لقالب ARM يتضمن معلمتين: location و name.
name: WebApp
summary: Azure Web App Environment
description: Deploys a web app in Azure without a datastore
runner: ARM
templatePath: azuredeploy.json
parameters:
- id: "location"
name: "location"
description: "Location to deploy the environment resources"
default: "[resourceGroup().location]"
type: "string"
required: false
- id: "name"
name: "name"
description: "Name of the web app "
default: ""
type: "string"
required: false
لمزيد من المعلومات، راجع المعلمات وأنواع البيانات في environment.yaml.
يمكن للمطورين توفير قيم لمعلمات محددة لبيئاتهم عبر مدخل المطور.
يمكن للمطورين أيضا توفير قيم لمعلمات محددة لبيئاتهم عبر Azure CLI:
az devcenter dev environment create --environment-definition-name
--catalog-name
--dev-center
--environment-name
--environment-type
--project
[--description]
[--no-wait]
[--parameters]
[--tags]
[--user]
[--user-id]
لمعرفة المزيد حول الأمر az devcenter dev environment create ، راجع ملحق Azure CLI devcenter.
تحديث تعريف بيئة
لتعديل تكوين موارد Azure في تعريف بيئة موجود في بيئات التوزيع، قم بتحديث ملف القالب المقترن في المستودع. ينعكس التغيير على الفور عند إنشاء بيئة جديدة باستخدام تعريف البيئة المحدد. يتم تطبيق التحديث أيضا عند إعادة توزيع بيئة مقترنة بتعريف البيئة هذا.
لتحديث أي بيانات تعريف متعلقة بالقالب، قم بتعديل environment.yaml، ثم قم بتحديث الكتالوج.
حذف تعريف بيئة
لحذف تعريف بيئة، في المستودع، احذف المجلد الفرعي الذي يحتوي على ملف القالب وملف environment.yaml المقترن. ثم قم بتحديث الكتالوج.
بعد حذف تعريف بيئة، لم يعد بإمكان فرق التطوير استخدامه لنشر بيئة جديدة. تحديث مرجع تعريف البيئة لأي بيئات موجودة تستخدم تعريف البيئة المحذوفة. إذا لم يتم تحديث المرجع وإعادة نشر البيئة، يفشل النشر.