استيراد وتصدير تعريفات المخطط باستخدام PowerShell

هام

في 11 يوليو 2026، سيتم إهمال المخططات (إصدار أولي). قم بترحيل تعريفات المخطط الحالي وتعييناته إلى مواصفات القالبومكدسات التوزيع. سيتم تحويل البيانات الاصطناعية للمخطط إلى قوالب ARM JSON أو ملفات Bicep المستخدمة لتعريف مكدسات التوزيع. لمعرفة كيفية تأليف أداة كمورد ARM، راجع:

• النهج
• RBAC
• عمليات النشر

يمكن إدارة Azure Blueprints بشكل كامل من خلال مدخل Microsoft Azure. مع تقدم المؤسسات في استخدامها لـ Azure Blueprints، يجب أن تبدأ في التفكير في تعريفات المخطط كتعليمة برمجية مدارة. غالباً ما يُشار إلى هذا المفهوم باسم البنية الأساسية كتعليمة برمجية (IaC). يوفر التعامل مع تعريفات المخطط كتعليمة برمجية مزايا إضافية تتجاوز ما يقدمه مدخل Microsoft Azure. تشمل هذه المزايا:

• مشاركة تعريفات المخطط
• النسخ الاحتياطي لتعريفات المخطط
• إعادة استخدام تعريفات المخطط في مستأجرين أو اشتراكات مختلفة
• وضع تعريفات المخطط في التحكم بالمصادر
  • الاختبار التلقائي لتعريفات المخطط في بيئات الاختبار
  • دعم مسارات المعالجة للتكامل المستمر والتوزيع المستمر (CI/CD)

مهما كانت أسبابك، فإن إدارة تعريفات المخطط كتعليمة برمجية لها ميزات. توضح هذه المقالة كيفية استخدام الأمرين Import-AzBlueprintWithArtifact وExport-AzBlueprintWithArtifact في الوحدة النمطية Az.Blueprint.

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

تفترض هذه المقالة معرفة عملية معتدلة من Azure Blueprints. إذا لم تكن قد فعلت ذلك بعد، فاعمل من خلال المقالات التالية:

• إنشاء مخطط في المدخل
• اقرأ عن مراحل التوزيع ودورة حياة المخطط
• إنشاء ووإدارة تعريفات المخططات وتعييناتها باستخدام PowerShell

إذا لم يكن مثبتاً بالفعل، فاتبع الإرشادات الموجودة في إضافة الوحدة النمطية Az.Blueprint لتثبيت الوحدة النمطية Az.Blueprint والتحقق من صحتها من معرض PowerShell.

بنية المجلد لتعريف مخطط

قبل النظر في تصدير المخططات واستيرادها، دعونا ننظر في كيفية هيكلة الملفات التي تشكّل تعريف المخطط. يجب تخزين تعريف المخطط في مجلده الخاص.

هام

إذا لم يتم تمرير أي قيمة إلى المعلمة الاسم لـ Import-AzBlueprintWithArtifact cmdlet، يتم استخدام اسم المجلد الذي يتم تخزين تعريف المخطط فيه.

جنباً إلى جنب مع تعريف المخطط، الذي يجب تسميته blueprint.json، هي البيانات الاصطناعية التي يتكون منها تعريف المخطط. يجب أن تكون كل البيانات الاصطناعية في المجلد الفرعي المسمى artifacts. معاً، يجب أن تبدو بنية تعريف مخططك كملفات JSON في المجلدات كما يلي:

.
|
|- MyBlueprint/  _______________ # Root folder name becomes default name of blueprint definition
|  |- blueprint.json  __________ # The blueprint definition. Fixed name.
|
|  |- artifacts/  ______________ # Subfolder for all blueprint artifacts. Fixed name.
|     |- artifact.json  ________ # Blueprint artifact as JSON file. Artifact named from file.
|     |- ...
|     |- more-artifacts.json

تصدير تعريف مخططك

خطوات تصدير تعريف مخططك واضحة. يمكن أن يكون تصدير تعريف المخطط مفيداً للمشاركة أو النسخ الاحتياطي أو وضعها في التحكم بالمصادر.

• المخطط [مطلوب]
  • تحديد تعريف المخطط
  • استخدم Get-AzBlueprint للحصول على العنصر المرجعي
• OutputPath [required]
  • تحديد المسار الذي تريد حفظ ملفات JSON لتعريف المخطط فيه
  • ملفات الإخراج موجودة في مجلد فرعي باسم تعريف المخطط
• الإصدار (اختياري)
  • تحديد الإصدار الذي يجب إخراجه إذا كان العنصر المرجعي المخطط يحتوي على مراجع لأكثر من إصدار واحد.

1. احصل على مرجع لتعريف المخطط للتصدير من الاشتراك الممثل كـ {subId}:

   # Login first with Connect-AzAccount if not using Cloud Shell
   
   # Get version '1.1' of the blueprint definition in the specified subscription
   $bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'MyBlueprint' -Version '1.1'
   

2. استخدم cmdlet Export-AzBlueprintWithArtifact لتصدير تعريف المخطط المحدد:

   Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'
   

استيراد تعريف مخططك

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

للحصول على أمثلة لتعريفات المخطط المضمنة، راجع مستودع Azure Blueprints GitHub.

• الاسم [مطلوب]
  • تحديد اسم تعريف المخطط الجديد
• InputPath [required]
  • تحديد المسار الذي يتم إنشاء تعريف المخطط منه
  • يجب أن تتطابق مع بنية المجلد المطلوبة
• ManagementGroupId (اختياري)
  • معرف مجموعة الإدارة لحفظ تعريف المخطط إذا لم يكن السياق الافتراضي الحالي
  • يجب تحديد إما ManagementGroupId أو SubscriptionId
• SubscriptionId (اختياري)
  • معرف الاشتراك لحفظ تعريف المخطط إذا لم يكن السياق الافتراضي الحالي
  • يجب تحديد إما ManagementGroupId أو SubscriptionId

1. استخدم cmdlet Import-AzBlueprintWithArtifact لاستيراد تعريف المخطط المحدد:

   # Login first with Connect-AzAccount if not using Cloud Shell
   
   Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'
   

بمجرد استيراد تعريف المخطط، يمكنك تعيين باستخدام PowerShell.

للحصول على معلومات حول إنشاء تعريفات مخطط متقدمة، راجع المقالات التالية:

• استخدم المعلمات الثابتة والديناميكية.
• تعلم كيفية تخصيص ترتيب تسلسل المخطط.
• حماية عمليات التوزيع باستخدام تأمين موارد المخطط.
• إدارة المخططات كتعليمة برمجية.

الخطوات التالية

• تعرف على المزيد عن دورة حياة المخطط.
• فهم كيفية استخدام المعلمات الثابتة والديناميكية.
• تعلم كيفية تخصيص ترتيب تسلسل المخطط.
• تعرف على كيفية الاستفادة من تأمين مورد المخطط.
• قدم حلولاً للمشكلات أثناء تعيين مخطط من خلال استكشاف الأخطاء وإصلاحها بشكل عام.