إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
عند إنشاء مهام لتخصيصات Microsoft Dev Box، يمكنك تحديد إجراءات محددة لمربعات التطوير للمساعدة في ضمان بيئة تطوير متسقة وفعالة. يتيح لك إنشاء مهام جديدة في كتالوج تحديد المكونات القابلة لإعادة الاستخدام المصممة خصيصا لفرق التطوير وإضافة حواجز حماية حول التكوينات الممكنة. ترشدك هذه المقالة خلال إنشاء كتالوج لمهام التخصيص وإضافة المهام وإرفاق الكتالوج بمركز تطوير أو مشروع.
المتطلبات الأساسية
لإكمال الخطوات في هذه المقالة تحتاج إليها:
- مركز تطوير تم تكوينه مع مشروع dev box.
- كتالوج موجود في GitHub أو Azure Repos.
الأذونات المطلوبة لتكوين التخصيصات
لتنفيذ الإجراءات المطلوبة لإنشاء التخصيصات وتطبيقها على مربع تطوير، تحتاج إلى الأذونات التالية:
| الإجراء | الإذن/الدور |
|---|---|
| تمكين الكتالوجات على مستوى المشروع لمركز التطوير. | مهندس النظام الأساسي مع حق الوصول للكتابة على الاشتراك. |
| تمكين إعدادات مزامنة الكتالوج لمشروع. | مهندس النظام الأساسي مع حق الوصول للكتابة على الاشتراك. |
| إرفاق كتالوج بمشروع. | أذونات مسؤول المشروع أو المساهم في المشروع. |
| إنشاء ملف تخصيص. | لم يتم تحديد أي شيء. يمكن لأي شخص إنشاء ملف تخصيص. |
| استخدم مدخل المطور لتحميل ملف YAML وتطبيقه أثناء إنشاء مربع التطوير. | مستخدم Dev Box. |
| إضافة مهام إلى كتالوج. | إذن لإضافته إلى المستودع الذي يستضيف الكتالوج. |
ما هي المهام؟
تنفذ المهمة إجراء معينا، مثل تثبيت البرامج. تتكون كل مهمة من برنامج نصي PowerShell واحد أو أكثر، جنبا إلى جنب مع ملف task.yaml الذي يوفر معلمات ويحدد كيفية تشغيل البرامج النصية. يمكنك أيضا تضمين أمر PowerShell في ملف task.yaml.
يمكنك تخزين مجموعة من المهام المنسقة في كتالوج مرفق بمركز التطوير الخاص بك، مع كل مهمة في مجلد منفصل. يدعم Dev Box استخدام مستودع GitHub أو مستودع Azure Repos ككتالوج. يفحص Dev Box مجلدا محددا من الكتالوج بشكل متكرر للعثور على تعريفات المهام.
يتوفر WinGet وPowerShell من أي مركز تطوير دون الحاجة إلى كتالوج. إذا كانت التخصيصات الخاصة بك تستخدم WinGet أو PowerShell فقط، يمكنك إنشاء مهام تستخدمها في ملف تخصيص. إذا كنت بحاجة إلى استخدام أدوات أو برامج نصية أخرى، يمكنك إنشاء مهام في كتالوج.
توفر Microsoft كتالوج التشغيل السريع لمساعدتك على البدء في التخصيصات. يتضمن مجموعة افتراضية من المهام التي تحدد الإجراءات الشائعة:
- تثبيت البرامج باستخدام مدير حزمة WinGet.
- انشر Desired State Configuration (DSC) باستخدام تكوين WinGet.
- استنساخ مستودع باستخدام
git-clone. - تكوين تطبيقات مثل تثبيت ملحقات Visual Studio.
- تشغيل البرامج النصية PowerShell.
إنشاء مهام في كتالوج
يتم تنظيم المهام، مثل تثبيت البرامج أو تشغيل البرامج النصية، في كتالوج. يمكنك إنشاء المهام وإدارتها في كتالوج، وتحديد المهام الجديدة، وإرفاق الكتالوج بمركز التطوير. باستخدام كتالوج التشغيل السريع من Microsoft، يمكنك البدء في المهام الشائعة مثل تثبيت البرامج ونشر DSC واستنساخ المستودعات وتكوين التطبيقات.
تعريف المهام الجديدة
لإنشاء مهام وتخصيصات فريق Dev Box وإدارتها، اتبع الخطوات التالية:
إنشاء مستودع لتخزين مهامك. اختياريا، يمكنك إنشاء نسخة من كتالوج التشغيل السريع في المستودع الخاص بك لاستخدامها كنقطة بداية.
إنشاء مهام في المستودع الخاص بك عن طريق تعديل البرامج النصية PowerShell الموجودة أو عن طريق إنشاء برامج نصية جديدة. لبدء إنشاء المهام، يمكنك استخدام الأمثلة في مستودع GitHub لأمثلة مركز التطوير وفي وثائق PowerShell.
قم بإرفاق المستودع الخاص بك بمركز التطوير ككتالوج.
أنشئ ملف تكوين لهذه المهام باتباع الخطوات الواردة في كتابة ملف تخصيص.
استخدام البيانات السرية من مخزن مفاتيح Azure
يمكنك استخدام البيانات السرية من Azure key vault في تكوينات YAML الخاصة بك لاستنساخ المستودعات الخاصة، أو مع أي مهمة مخصصة تقوم بتأليفها تتطلب رمزا مميزا للوصول.
يحتاج مركز التطوير الخاص بك إلى الوصول إلى مخزن المفاتيح الخاص بك. لا يدعم DevCenter علامات الخدمة، لذلك إذا تم الاحتفاظ بخزنة المفاتيح الخاصة بك، فيجب عليك السماح خدمات Microsoft الموثوق بها بتجاوز جدار الحماية.
لتكوين أسرار مخزن المفاتيح للاستخدام في تكوينات YAML الخاصة بك:
تأكد من أن الهوية المدارة لمشروع مركز التطوير الخاص بك لها دور قارئ Key Vault ودور مستخدم Key Vault Secrets على مخزن المفاتيح الخاص بك.
امنح دور مستخدم Key Vault Secrets لسر key vault لكل مستخدم أو مجموعة مستخدمين يجب أن تكون قادرة على استهلاك السر أثناء تخصيص مربع التطوير. يجب أن يتضمن المستخدم أو المجموعة الممنوحة للدور الهوية المدارة لمركز التطوير وحساب المستخدم الخاص بك وأي مستخدم أو مجموعة تحتاج إلى السر أثناء تخصيص مربع التطوير.
لمزيد من المعلومات حول استخدام أسرار خزنة المفاتيح في ملف تخصيص، راجع استنساخ مستودع خاص باستخدام ملف تخصيص.
إرفاق كتالوج
يمكنك إرفاق كتالوج بمشروع لجعل المهام في متناول فريق المطورين. لإرفاق كتالوج بمشروع، اتبع الخطوات الواردة في إضافة كتالوج وتكوينه من GitHub أو Azure Repos.