تكوين تخصيصات الفريق

استخدم ميزة تخصيصات Microsoft Dev Box لتبسيط إعداد بيئات التطوير المستندة إلى السحابة. قد يكون بدء مشروع جديد أو الانضمام إلى فريق جديد أمرا معقدا ويستغرق وقتا طويلا. تستخدم تخصيصات الفريق ملف تعريف الصورة (imagedefinition.yaml) للتثبيت المسبق للأدوات واستنساخ المستودعات وتعيين الإعدادات لكل مربع تطوير في مجموعة. من خلال تخصيصات الفريق، يمكن للمسؤولين توفير محطات عمل جاهزة للترميز مع التطبيقات والأدوات والمستودعات ومكتبات التعليمات البرمجية والحزم والبرامج النصية للإنشاء. توضح لك هذه المقالة كيفية إنشاء ملف تعريف صورة واختباره وتحريره لمربع التطوير الخاص بك في Visual Studio Code.

يمكنك استخدام التخصيصات في Dev Box بطريقتين. تنشئ تخصيصات الفريق تكوينا مشتركا للفريق. تنشئ تخصيصات المستخدم تكوينا شخصيا لمطور فردي. تلخص القائمة التالية الاختلافات بين أنواع التخصيص هذه.

• تخصيصات الفريق: يتم تعريفها مرة واحدة، ويتم تطبيقها على كل مربع تطوير في تجمع عبر imagedefinition.yaml في كتالوج.
• تخصيصات المستخدم: YAML الشخصي الذي تم تحميله أثناء إنشاء الصندوق ؛ يؤثر فقط على هذا المربع واحد.
• استخدام الفريق من أجل الاتساق والامتثال. استخدم المستخدم للتفضيلات الشخصية.

لمعرفة المزيد، راجع تخصيصات Microsoft Dev Box.

قم بتكوين تخصيصات الفريق باتباع الخطوات التالية:

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

منتج	المتطلبات
صندوق التطوير في Microsoft	- قم بإعداد مركز تطوير باستخدام تجمع صندوق التطوير ومشروع مربع التطوير حتى تتمكن من إنشاء مربع تطوير. - قم بإرفاق كتالوج بمركز التطوير مع المهام التي يمكنك استخدامها في ملف تعريف الصورة. إذا لم يكن لديك كتالوج، فشاهد إضافة كتالوج وتكوينه من GitHub أو Azure Repos. -اذونات - لإنشاء مربع تطوير: انضم إلى مجموعة أمان Dev Box Users لمشروع واحد على الأقل. - لتمكين الكتالوجات على مستوى المشروع لمركز التطوير: مهندس منصة مع حق الوصول للكتابة على الاشتراك. - لتمكين إعدادات مزامنة الكتالوج لمشروع: مهندس منصة مع حق الوصول للكتابة على الاشتراك. - لإرفاق كتالوج بمشروع: أذونات مسؤول مشروع مركز التطوير أو المساهم على المشروع.
تعليمة Visual Studio برمجية	- قم بتثبيت أحدث إصدار

إنشاء ملف تعريف صورة

لتحديد الأدوات والحزم والتكوينات التي يحتاجها فريقك، قم بإنشاء ملف تعريف صورة بتنسيق YAML يسرد المهام المطلوبة لبيئة مربع التطوير الخاصة بك.

استخدام المهام المضمنة أو كتالوج للمهام المخصصة

المهام هي إجراءات قابلة لإعادة الاستخدام تأتي من العناصر الأولية المضمنة (WinGet وPowerShell وGit-Clone) أو من كتالوج تقوم بإرفاقه بمشروع مركز التطوير. اختر المصدر الذي يناسب احتياجات التخصيص ومتطلبات المشروع على أفضل وجه.

• استخدم WinGet وPowerShell والمهام المضمنة Git-Clone. تدعم مراكز تطوير Dev Box مهام PowerShell وWinGet خارج الصندوق. إذا كانت التخصيصات تتطلب PowerShell أو WinGet أو Git-Clone فقط، فيمكنك البدء في هذه المهام المضمنة وإنشاء ملف تعريف الصورة. لمزيد من المعلومات، راجع إنشاء ملف تعريف صورة.

  هام

  المهمة المضمنة في WinGet ليست هي نفسها المهمة القابلة للتنفيذ WinGet. تستند المهمة المضمنة في WinGet إلى PowerShell WinGet cmdlet.

• استخدم كتالوج لتعريف المهام المخصصة. قم بإنشاء المهام المخصصة الخاصة بك. لجعل المهام المخصصة متاحة لمؤسستك بأكملها، قم بإرفاق كتالوج يحتوي على تعريفات مهام مخصصة بمركز التطوير الخاص بك. يدعم Dev Box كتالوجات Azure Repos وGitHub. نظرا لأن المهام محددة فقط في مركز التطوير، قم بتخزين المهام وتعريفات الصور في مستودعات منفصلة.

  لمعرفة المزيد حول تعريف المهام المخصصة، راجع تكوين المهام لتخصيصات Dev Box.

سير عمل يعمل بنظام الذكاء الاصطناعي

يدعم Dev Box سير عمل وكيل مع وضع عامل GitHub Copilot. استخدم مطالبات اللغة الطبيعية لإنشاء ملف تعريف الصورة (imagedefinition.yaml). يسهل GitHub Copilot إعداد بيئة Dev Box الخاصة بك لأنك تصف احتياجاتك بشكل محادثة بدلا من إنشاء ملفات YAML يدويا.

يتيح لك سير العمل الوكيل Dev Box ما يلي:

• تقليد بيئة التطوير الحالية - قم بإنشاء تعريف يطابق تكوين جهازك الحالي أو تغييره.
• استخدام سياق المستودع - إنشاء تعريف أو تغييره في سياق مستودع GitHub معين.
• استخدام تعليمات اللغة الطبيعية - قم بإنشاء ملف تعريف صورة عن طريق وصف بيئة التطوير التي تريدها.

إشعار

يدعم سير العمل الوكيل المهام البدائية ل Dev Box فقط، بما في ذلك WinGet وPowerShell وGit-Clone.

إنشاء ملف تعريف الصورة

1. افتح Visual Studio Code.

2. قم بتثبيت ملحق Dev Box.

   افتح الملحقات (Ctrl + Shift + X) ، وابحث عن Dev Box ، وقم بتثبيت الامتداد.

   

3. قم بتثبيت ملحق GitHub Copilot الذي تم إعداده في VS Code.

4. تأكد من تمكين وضع الوكيل عن طريق تعيين chat.agent.enabled في محرر الإعدادات. يتطلب هذا الإعداد Visual Studio Code 1.99 أو أحدث.

5. افتح دردشة Copilot في VS Code.

   • تأكد من تحديد أدوات Dev Box مسبقا ضمن تحديد الأدوات.

     

     

   • حدد وضع الوكيل، واختر الطراز: Claude 3.5 Sonnet.

     

6. توفير مطالبات باللغة الطبيعية، مثل:

   • "أريد إعداد مربع تطوير يحتوي على جميع الأدوات والحزم المطلوبة للعمل على مستودع [اسم الريبو] هذا."

   • "أريد التثبيت المسبق ل Visual Studio 2022 Enterprise و Visual Studio Code و Git و .NET SDK 8 و Node.js LTS و Docker Desktop على مربع التطوير ، واستنساخ [عنوان URL] الخاص ب Repo الخاص بالفريق في مربع التطوير."

   • "أريد إعداد صندوق تطوير مع جميع أدوات وحزم التطوير المثبتة على جهازي الحالي."

   تلميح

   استنساخ وفتح المستودع المحدد في Visual Studio Code إذا كنت تريد إنشاء التعريف في سياق المستودع.

7. اتبع المطالبات لتكوين الحزم.

   • عند المطالبة، حدد متابعة لمتابعة إعداد الحزمة.

   • يقوم Copilot بإنشاء ملف imagedefinition.yaml .

8. صقل بمزيد من المطالبات.

   • استمر في التفاعل مع العامل حتى تظهر الأدوات والحزم التي تريدها في الملف.

كود Visual Studio

قم بإنشاء ملفات تعريف الصورة واختبارها باستخدام Visual Studio Code. بالإضافة إلى استخدام المهام المضمنة، استخدم ملحق Dev Box في Visual Studio Code لاكتشاف المهام المخصصة المتوفرة من خلال مركز التطوير الخاص بك.

1. قم بإنشاء مربع تطوير أو استخدم مربع تطوير موجود للاختبار.

2. في مربع تطوير الاختبار، قم بتثبيت Visual Studio Code، ثم قم بتثبيت ملحق Dev Box.

3. قم بتنزيل مثال لملف تعريف صورة YAML من مستودع العينات، وافتحه في Visual Studio Code.

4. اكتشف المهام المتوفرة في الكتالوج باستخدام لوحة الأوامر: حدد عرض> مربع تطويرلوحة>الأوامر: سرد المهام المتوفرة لمربع التطوير هذا.

   

5. اختبار التخصيص في Visual Studio Code باستخدام لوحة الأوامر: حدد عرض> مربع تطويرلوحة>الأوامر: تطبيق مهام التخصيصات.

   

6. يتم تشغيل ملف تعريف الصورة وتطبيق المهام المحددة على مربع تطوير الاختبار. افحص التغييرات وتحقق من محطة Visual Studio Code الطرفية بحثا عن أي أخطاء أو تحذيرات تم إنشاؤها أثناء تنفيذ المهمة.

7. عند تشغيل ملف تعريف الصورة بنجاح، قم بتحميله إلى الكتالوج.

تخصيص مربع التطوير الخاص بك باستخدام ملفات Desired State Configuration الموجودة

تكوين الحالة المطلوبة (DSC) هو نظام أساسي للإدارة في PowerShell يتيح لك إدارة بيئة التطوير الخاصة بك باستخدام التكوين كتعليمات برمجية. استخدم DSC لتحديد الحالة المطلوبة لمربع التطوير الخاص بك، بما في ذلك عمليات تثبيت البرامج والتكوينات والإعدادات.

يوضح هذا المثال ملف تعريف صورة مربع التطوير الذي يستدعي ملف WinGet DSC موجود:

tasks:
    - name: winget
      parameters:
          configure: "projectConfiguration.dsc.yaml"

تعرف على المزيد في تكوين WinGet.

تحميل ملف تعريف الصورة إلى مستودع

يمكنك استخدام مستودع GitHub أو Azure Repos كتالوج لتسهيل الوصول إلى ملف تعريف الصورة من مشروع مربع التطوير. يمكن أن يحتوي كل مشروع على كتالوج يخزن ملفات تعريف صور متعددة، والتي يمكنك تكوينها على مخازن المجموعات لتتماشى مع احتياجات فرق المطورين.

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

تكوين تعريفات الصور على مستوى المشروع

تساعدك المشاريع على إدارة موارد Dev Box بكفاءة. يمكنك تعيين كل فريق مطور مشروعه الخاص لتنظيم الموارد بشكل فعال. قم بإنشاء تعريفات صور متعددة في مستودع الكتالوج الخاص بك، كل منها في مجلده الخاص لاستهداف فرق المطورين المختلفة ضمن مشروعك.

تمكين الكتالوجات على مستوى المشروع

قم بتمكين الكتالوجات على مستوى المشروع على مستوى مركز التطوير قبل إضافة كتالوج إلى مشروع. لتمكين الكتالوجات على مستوى المشروع على مستوى مركز التطوير:

1. في مدخل Microsoft Azure، انتقل إلى مركز التطوير الخاص بك.

2. في القائمة اليمنى، ضمن الإعدادات، حدد إعدادات مركز التطوير.

3. ضمن كتالوجات مستوى المشروع، حدد تمكين الكتالوجات لكل مشروع، ثم حدد تطبيق.

   

لمزيد من المعلومات حول كيفية إضافة كتالوجات إلى المشاريع، راجع إضافة كتالوج وتكوينه من GitHub أو Azure Repos.

تكوين إعدادات مزامنة الكتالوج للمشروع

قم بإعداد مشروعك لمزامنة تعريفات الصور من الكتالوج. يتيح لك هذا الإعداد استخدام تعريفات الصور في الكتالوج لإنشاء تجمعات مربعات التطوير.

1. قم بتسجيل الدخول إلى بوابة Azure.

2. في مربع البحث، أدخل المشاريع. من قائمة النتائج، حدد المشاريع.

3. افتح مشروع Dev Box حيث تريد إعداد إعدادات مزامنة الكتالوج.

4. حدد Catalogs.

5. حدد Sync settings.

   

6. في جزء إعدادات المزامنة ، حدد تعريفات الصور، ثم حدد حفظ.

   

إرفاق الكتالوج الذي يحتوي على ملف تعريف الصورة

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

يعرض جزء تعريفات الصور تعريفات الصور التي يمكن لمشروعك استخدامها.

لمعرفة كيفية إرفاق الكتالوجات، راجع إضافة كتالوج وتكوينه من GitHub أو Azure Repos.

تكوين تجمع مربع تطوير لاستخدام تعريف صورة

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

اتبع هذه الخطوات لإنشاء تجمع مربع التطوير وتحديد تعريف الصورة:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. في مربع البحث، أدخل المشاريع. في قائمة النتائج، حدد المشاريع.

3. افتح مشروع Dev Box الذي تريد إقران تجمع مربع التطوير الجديد به.

4. حدد Dev box pools، ثم حدد Create.

5. في جزء Create a dev box pool ، أدخل القيم التالية:

   الإعداد	قيمة
   الاسم	أدخل اسما للتجمع. يكون اسم التجمع مرئيا للمطورين عند إنشاء مربعات التطوير. يجب أن يكون فريدا داخل المشروع.
   التعريف	يسرد هذا المربع تعريفات الصور من الكتالوجات التي يمكن الوصول إليها وتعريفات مربع التطوير. حدد ملف تعريف صورة.
   اتصال الشبكة	حدد نشر إلى شبكة مستضافة من Microsoft أو استخدم اتصال شبكة موجود.
   تمكين تسجيل الدخول الأحادي	حدد نعم للسماح بتسجيل الدخول الأحادي لمربعات التطوير في هذا التجمع. يجب إعداد تسجيل الدخول الأحادي للمؤسسة. لمزيد من المعلومات، راجع تمكين تسجيل الدخول الأحادي لمربعات التطوير.
   امتيازات منشئ مربع التطوير	حدد المسؤول المحلي أو المستخدم القياسي.
   تمكين الإيقاف التلقائي	نعم هو الافتراضي. حدد لا لإيقاف تشغيل جدول الإيقاف التلقائي. يمكنك إعداد جدول إيقاف تلقائي بعد إنشاء التجمع.
   وقت الإيقاف	حدد وقتا لإيقاف جميع مربعات التطوير في المجموعة.
   المنطقة الزمنية	حدد المنطقة الزمنية لوقت التوقف.
   الترخيص	حدد خانة الاختيار هذه للتأكد من أن مؤسستك لديها تراخيص Azure Hybrid Benefit لتطبيقها على مربعات التطوير في هذا التجمع.

   

6. حدد إنشاء.

7. تحقق من ظهور تجمع مربع التطوير الجديد في القائمة. قد تحتاج إلى تحديث الشاشة.

إنشاء مربع تطوير باستخدام مدخل المطور

للتحقق من تطبيق التخصيصات من ملف تعريف الصورة، قم بإنشاء مربع تطوير في مدخل مطور Dev Box. اتبع الخطوات الواردة في التشغيل السريع: إنشاء مربع تطوير والاتصال به باستخدام مدخل مطور Dev Box. ثم اتصل بمربع التطوير الجديد وتحقق من أن التخصيصات تعمل كما تتوقع.

قم بإجراء تغييرات على ملف تعريف الصورة وإنشاء مربع تطوير جديد لاختبارها. عندما تكون متأكدا من صحة التخصيصات ، قم بإنشاء صورة قابلة لإعادة الاستخدام.

استخدام البرامج النصية والملفات المعيارية في تخصيصات Dev Box

يمكن تخزين البرامج النصية والملفات المعيارية مثل البرامج النصية PowerShell أو ملفات تكوين الحالة المطلوبة (DSC) أو ملفات التكوين أو الملفات النصية أو الصور في كتالوج مشترك حتى تتمكن من إعادة استخدام تخصيصات Dev Box وتوحيدها عبر صور متعددة.

وهي مصممة من أجل:

• تعزيز إعادة الاستخدام عبر إعدادات Dev Box المتعددة
• تقليل الازدواجية والنفقات العامة للصيانة
• تمكين ممارسات التكوين المتسقة

هيكل الكتالوج

يتم نسخ الملفات الموجودة في نفس المجلد مثل imagedefinition.yaml، أو في مجلداته الفرعية، إلى مربع dev عند الإنشاء. يمكنك استخدام هذه الملفات عند تشغيل مهام التخصيص.

يوضح الرسم التخطيطي التالي بنية كتالوج للبرامج النصية والملفات المعيارية في تخصيصات Dev Box.

في المستوى الأعلى، يوجد مجلد تعريفات الصور . في الداخل ، تجد مجلدات فرعية لتعريف الصورة مثل frontend-imagedef و backend-imagedef. يحتوي مجلد frontend-imagedef على ملف برنامج نصي PowerShell. يتضمن المجلد backend-imagedef مجلدا فرعيا يحتوي على ملفات DSC. يمكنك استخدام أي من الهيكلين لتخزين البرامج النصية والملفات الأخرى.

النصوص البرمجية أو الملفات المعيارية المرجعية

يقوم ملف تعريف الصورة بتعيين قائمة بالمهام التي يتم تشغيلها في سياق النظام وuserTasks التي يتم تشغيلها بعد تسجيل الدخول الأول في مربع التطوير الجديد، في سياق المستخدم. استخدم أسماء العرض للمهام لتوضيح الغرض من كل مهمة. في ملف تعريف الصورة، ارجع إلى البرامج النصية المعيارية التي تريد تشغيلها، أو الملفات التي تريد تضمينها.

$schema: "1.0"
name: "modular-script"
image: microsoftvisualstudio_visualstudioplustools_vs-2022-ent-general-win11-m365-gen2
description: "This definition shows examples of referencing PowerShell scripts and DSC configuration files."

tasks:
  - name: ~/powershell
    displayName: "Modular Script"
    parameters:
      script: C:\ProgramData\Microsoft\DevBoxAgent\ImageDefinitions\catalog-name\modular-script\contoso.ps1
  - name: ~/winget
    displayName: "Install VS Code"
    parameters:
      configurationFile: C:\ProgramData\Microsoft\DevBoxAgent\ImageDefinitions\catalog-name\modular-script\contoso.dsc.yaml

userTasks:
  - name: ~/winget
    displayName: "Install Insomnia"
    parameters:
      configurationFile: C:\ProgramData\Microsoft\DevBoxAgent\ImageDefinitions\catalog-name\modular-script\contoso-user.dsc.yaml

يتحقق Dev Box من أن جميع المهام تشير إما إلى مهام جوهرية (مثل PowerShell أو WinGet) أو مهام متوفرة على مستوى مركز التطور. يقوم بتنزيل جميع ملفات Image Definition إلى دليل محدد في مربع التطوير الجديد ، جنبا إلى جنب مع ملفات المهام ذات الصلة. ثم يقوم بتنفيذ كل مهمة في دليل المهام الذي تم تنزيله وتحميل حالة المهمة عند الانتهاء.

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

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

تكوين تصوير مركز التطوير