إنشاء و العمل مع عملاء البناء

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

قبل البدء

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

• يتم استضافة عميل البناء علي جهاز البناء. ولذلك، يجب عليك تكوين جهاز البناء قبل بنائك و العمل مع عميل البناء. كل بنية يمكن أن يستضيف الجهاز واحد أو أكثر بنية العوامل. لمزيد من المعلومات، راجع تكوين جهاز بناء.

في هذا الموضوع

• الأذونات المطلوبة.

• إنشاء عميل بناء

• تعديل عميل البناء

• مربع حوار خصائص عميل البناء

  • المزيد حول خاصية دليل العمل

• تثبيت برامج إضافية

  • تثبيت البرامج المطلوبة للتحويل البرمجي للتعليمة البرمجية

  • تثبيت البرامج المطلوبة لتنفيذ المهام الأخرى

• تعيين علامات التبويب لعميل البناء

• قم بإزالة عميل بناء

الأذونات المطلوبة.

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

إنشاء عميل بناء

لإنشاء عميل بناء

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

2. انقر فوق ابدأ ، انقر فوق كافة البرامج انقر فوق Microsoft Team Foundation Server 2010 و انقر فوق وحدة تحكم إدارة أساس الفريق .

   تظهر وحدة تحكم إدارة Team Foundation .

3. في جزء الشجرة قم بتوسيع اسم الخادم، ثم قم بتوسيع إنشاء أساس الفريق .

   تظهر معلومات حول جهاز الإنشاء في جزء المحتويات.

   إذا لم تظهر رسالة تكوين "الخدمة بنية" for… ، راجع تكوين جهاز بناء.

4. انقر فوق عامل جديد .

   يظهر مربع الحوار خصائص عميل البناء . للحصول على مزيد من المعلومات، راجع خصائص عميل البناء . لاحقاً في هذا الموضوع.

5. عند اانتهاءك من تعديل خصائص العميل، انقر فوق موافق .

6. إذا ظهر الارتباط ابدأ مباشرة أسفل اسم عميل البناء انقر فوقه.

تعديل عميل البناء

يمكنك تعديل عميل بناء إما من جهاز العميل أو مباشرة علي جهاز البناء الذي يستضيف عميل البناء.

لتعديل عميل البناء من جهاز العميل

1. في Visual Studio Application Lifecycle Management 2010 ،افتح قائمة الانشاء ، ثم انقر فوق إدارة أجهزة تحكم بنية.

   يظهر مربع حوار إدارة أجهزة تحكم إنشاء .

2. انقر فوق عميل البناء الذي يرغب في تعديلها، ثم انقر فوق خصائص .

   يظهر مربع الحوار خصائص عميل البناء .

لتعديل عميل البناء على جهاز البناء

1. قم بتسجيل الدخول إلى جهاز البناء الذي يقوم بتشغيل عميل البناء الذي تريد تعديله.

2. انقر فوق ابدأ ، انقر فوق كافة البرامج انقر فوق Microsoft Team Foundation Server 2010 و انقر فوق وحدة تحكم إدارة أساس الفريق .

   تظهر وحدة تحكم إدارة Team Foundation .

3. في جزء الشجرة قم بتوسيع اسم الخادم، ثم قم بتوسيع إنشاء أساس الفريق .

4. مباشرةً تحت اسم عميل البناء الذي تريد تعديله انقر فوق خصائص.

   يظهر مربع الحوار خصائص عميل البناء .

مربع حوار خصائص عميل البناء

في مربع حوار خصائص عميل البناء ، يمكنك عرض أو تغيير اسم العرض و الوصف بالإضافة إلى الخصائص الأخرى التي تؤثر على أداء عميل البناء.

اسم العرض ، الوصف

توفر اسماً و وصفاً يساعد أعضاء الفريق على التعرف بسهولة عميل البناء و الحصول على معلومات هامة حوله.

وحدة التحكم

تحديد وحدة تحكم البناء التي تريدها أن تتحكم في عميل البناء هذا. يمكن تشغيل وحدة تحكم البناء على نفس جهاز البناء كعميل البناء هذا أو على جهاز بناء مختلف.

اسم الكمبيوتر

يعرض هذا المربع اسم جهاز البناء الذي يستضيف عميل البناء هذا.

Working Directory (الدليل المشغّل)

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

يتم تمكين خدمة عميل البناء

حدد خانة الاختيار هذه لتمكين عميل البناء هذا من العمل أو إلغاء تحديدها إذا أردت تعطيله و منع البناءات من أن تعّين له.

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

المزيد حول خاصية دليل العمل

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

رموز دليل العمل المميزة

وعلى الرغم من أنه يمكنك تحديد مسار قيمة حرفية للخاصية الالدليل المشغَّل (على سبيل المثال، c:\temp\بنية\)، أسلوباً أكثر مرونة استخدام الرموز المميزة لتحديد المسار. يمكنك استخدام نوعين من الرموز المميزة:

• متغيرات البيئة : متغيرات البيئة تحتوي معلومات حول بيئة النظام والمستخدم الذي قام بتسجيل الدخول.

  على سبيل المثال، قمت بتكوينها خدمة بنية Team Foundationلتعمل تحت حساب التي هو تسمى BuildSvcAcct. تحديد\بنية $ (المؤقت) ك الالدليل المشغَّل لعامل بناء تشغيل جهاز بناء الذي يقوم بتشغيل Windows Server 2008. نتيجة لذلك، عميل البناء عادةً سيستخدم- كدليل العمل الخاص به- دليلاً فعلياً يقرّب الموقع التالي: C:\Windows\ServiceProfiles\BuildSvcAcct\AppData\Local\Temp\Build.

  تلميح
  لسرد متغيرات البيئة على جهاز البناء قم بفتح موجه الأوامر واكتب set.

• متغيرات بناء أساس الفريق : يمكنك استخدام المتغيرات التالية في دليل عمل عميل البناء:

  • $(BuildAgentId): عدد صحيح يتم إنشاؤه تلقائياً يعرّف بشكل فريد عميل البناء داخل مجموعة مشروع الفريق.

  • $(BuildAgentName): الاسم المعروض الخاص بعميل البناء.

  • $(BuildDefinitionId): عدد صحيح يتم إنشاؤه تلقائياً يعرّف بشكل فريد تعريف البناء داخل مجموعة مشروع الفريق.

  • $(BuildDefinitionPath): اسم مشروع الفريق و اسم تعريف البناء مفصولين بخط مائل عكسي.

مثال دليل العمل

على سبيل المثال، لديك عميل تصنيع التي هو باسم BuildBot3. قمت بتعريف جهازي وبالطريقة التي تسمى NightlyBuild و WeeklyBuild في فريق مشروع الذي هو تسمى CoolApp. في مربع دليل العمل ، حدد القيمة التالية: $ (Temp)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath). كـ نتيجة BuildBot3 إنشاء عميل البناء ويستخدم الدلائل العمل الثاني التالية:

C:\Windows\ServiceProfiles\BuildSvcAcct\AppData\Local\Temp\BuildBot3\CoolApp\NightlyBuild

C:\Windows\ServiceProfiles\BuildSvcAcct\AppData\Local\Temp\BuildBot3\CoolApp\WeeklyBuild

تأكد من أن دليل العمل غير طويل جداً

دليل العمل الذي تحدده لا يجب أن يسبب إنتاج عميل البناء لأي مسارات فعلية أطول من 259 حرفًا. وإلا، فسوف تفشل عملية البناء و تسجل هذا الخطأ: TF10128: The path المسار الفعلي contains more than the allowed 259 characters. Type or select a shorter path. هذا الخطأ قد يفاجئك لأنه قد لا تلاحظ المسارات الفعلية عادةً التي يقوم عميل البناء بإنشائها.

لحل هذه المشكلة، يمكنك تحديد دليل العمل الذي ينتج عنه مسار فعلي أقصر. على سبيل المثال يمكنك تحديد الدليل التالي: $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), which would النتيجة في a working الدليل that approximates the following مسار: c:\bld\3\2\.

الدلائل الفرعية التي تم إنشاؤها في دليل العمل

يقوم عميل البناء بإنشاء و العمل فى الدلائل الفرعية التالية ضمن هذا المسار.

الدليل الفرعي	يستخدم لتخزين الملفات …
Sources	القراءة بواسطة عميل البناء، مثل ملفات المصدر. تم تحديد الملفات التي يقوم بتنزيلها في كل إعداد مساحة العمل تعريف البناء.
Binaries	التحويل البرمجي حسب عميل البناء, مثل التحويل البرمجي لملفات التطبيق.
TestResults	تم إنتاجه من قبل أي اختبارات يقوم بتشغيلها عميل البناء.

تثبيت برامج إضافية

حتى يقوم عميل البناء الخاص بك بتنفيذ مهام معينة, قد تحتاج لتثبيت برامج إضافية على جهاز البناء.

تثبيت البرامج المطلوبة للتحويل البرمجي للتعليمة البرمجية

حتى يقوم عميل البناء ببناء الكثير من المشاريع الأكثر مثالية، لا برامج إضافية مطلوبة. على سبيل المثال، بدون أي برامج إضافية مثبتة يمكن لعميل البناء التحويل البرمجي لتطبيق Visual C# WPF الأساسي.

ومع ذلك، يجب عليك تثبيت برامج إضافية للتحويل البرمجي لأنواع أخرى من المشاريع. على سبيل المثال، يجب عليك تثبيت Visual Studio Application Lifecycle Management 2010 للتحويل البرمجي لمشروع إعداد.

للتأكد من أن عميل البناء يمكنه التحويل البرمجي للمشاريع الخاصة بك

• إذا كنت تقوم ببناء مشاريع التعليمة البرمجية التي يعمل عليها فريقك باستخدام Visual Studio ALM 2010، يجب عليك تثبيت أي إصدار من Visual Studio ALM 2010 يستخدمه الفريق الخاص بك على جهاز البناء الذي يعمل عليه عميل البناء.

• إذا كنت تقوم ببناء مشاريع التعليمة البرمجية التي يعمل عليها فريقك باستخدام Visual Studio Team System 2008، يجب عليك تثبيت أي إصدار من Visual Studio Team System 2008 يستخدمه الفريق الخاص بك على جهاز البناء الذي يعمل عليه عميل البناء.

• قم بتثبيت أي برامج و مكونات أخرى مثبتة في بيئة المطور و المطلوبة لبناء التطبيق الخاص بك.

تثبيت البرامج المطلوبة لتنفيذ المهام الأخرى

حتى يقوم عميل بناء بتنفيذ عدة مهام أخرى, مثل تشغيل الاختبارات, قد تحتاج برامج إضافية لتثبيتها على جهاز البناء. يعرّف الجدول التالي بعض مهام عميل البناء و البرامج المطلوبة لتنفيذ هذه المهام.

حتى يقوم عميل البناء بـ …	يجب تثبيت البرامج التالية علي كمبيوتر عميل البناء …
قم بتشغيل أنواع الاختبارات التالية: تنفيذ عن بعد، ترميز واجهة المستخدم، و تحميل و الضغط.	Visual Studio Test Professional 2010

تعيين علامات التبويب لعميل البناء

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

يمكنك تطبيق أكثر من علامة لعميل البناء. على سبيل المثال، يمكنك بنية عميل تصنيع بواسطة علامات x86 و "تحرير" للإشارة إلى عميل التي هو إعداد التحويل البرمجي لتكوين الإصدار تطبيق 32 بت.

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

قم باستخدام علامات التبويب لتمثيل قدرات عميل البناء

يقدم الجدول التالي أمثلة علامات تبويب الأسماء و قدرات عميل البناء التي قد تمثلها.

يمكنك تطبيق علامات التبويب التالية لعميل البناء …	لتعريف عميل البناء الذي يمكنه …
x86	التحويل البرمجي لتطبيقات 32-بت
x64	التحويل البرمجي لتطبيقات 64-بت
IIS	التحويل البرمجي لتطبيق ويب ASP.NET و من ثم تجهيزه و استضافته على كمبيوتر البناء الذي تم تشغيل عميل البناء عليه
الاختبار، والضغط	عميل البناء الذي قيد التشغيل على كمبيوتر البناء على Test Professional 2010 تم تعيينه لتشغيل التحميل و اختبارات الإجهاد.

استخدم علامات التبويب لموازنة تحميل عملية البناء الخاصة بك

يمكنك استخدام علامات التبويب لموازنة تحميل عمل معالجة البناء التي علي الفريق الخاص بك تنفيذها. على سبيل المثال، قد يكون لديك تعريف البنية التي هو تسمى البناء إيداع فحص من أدوات الاختيار الخاص بك. لمزيد من المعلومات، راجع كيفية: تعريف البنية التحقق من صحة التغييرات قبل إيداع. تعريف البناء هذا يعمل غالباً و يتم تشغيل مثيل واحد فقط خاص به في المرة الواحدة. لذلك، تقوم بإعداد جهاز البناء الذي لديه أجهزة عالية الأداء (مثل معالج multi-core السريع و محرك أقراص ثابتة سريع). قم بإنشاء عميل البناء تشغيل ذلك الجهاز وتعيين علامة الإيداع. إعداد تعريف البنية إلى تشغيل فقط تشغيل عميل بناء تشغيل الاختيار-في علامة.

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

ملاحظة

تعريفات البناء التي ليس لديها أي علامات تبويب مطبّقة قد يتم تعيينها أيضاً لعملاء البناء التي لديهم علامات تبويب مطبّقة. ولذلك، يجب عليك التأكد من أن كافة تعريفات البناء و كافة عملاء البناء لديهم علامات التبويب المطبّقة إذا كنت تريد إعداد عملاء البناء الذين يتم استخدامهم فقط لأنواع معينة من البناء.

لتطبيق علامة لعميل بناء على جهاز العميل

1. في قائمة البناء، انقر فوق إدارة عناصر تحكم البناء .

   يظهر مربع حوار إدارة أجهزة تحكم إنشاء .

2. قم بالنقر بزر الماوس الأيمن فوق عميل البناء الذي تريد تطبيق علامة له، ثم انقر فوق الخصائص .

   يظهر مربع الحوار خصائص عميل البناء .

3. استخدم إحدى الطرق التالية لتطبيق علامة واحدة أو أكثر:

   • قم بتحديد علامة واحد أو أكثر من القائمة.

   • انقر فوق الارتباط إضافة علامة جديدة . في مربع الحوار إضافة علامة جديدة ، اكتب العلامة التي تريد تطبيقها.

لتطبيق علامة لعميل بناء على جهاز البناء

1. قم بتسجيل الدخول إلى جهاز البناء الذي يقوم بتشغيل عميل البناء الذي تريد تعديله.

2. انقر فوق ابدأ ، انقر فوق كافة البرامج انقر فوق Microsoft Team Foundation Server 2010 و انقر فوق وحدة تحكم إدارة أساس الفريق .

   تظهر وحدة تحكم إدارة Team Foundation .

3. في جزء الشجرة قم بتوسيع اسم الخادم، ثم قم بتوسيع إنشاء أساس الفريق .

4. مباشرةً تحت اسم عميل البناء انقر فوق الخصائص .

   يظهر مربع الحوار خصائص عميل البناء .

5. استخدم إحدى الطرق التالية لتطبيق علامة واحدة أو أكثر:

   • قم بتحديد علامة واحد أو أكثر من القائمة.

   • انقر فوق الارتباط إضافة علامة جديدة . في مربع الحوار إضافة علامة جديدة ، اكتب العلامة التي تريد تطبيقها.

قم بإزالة عميل بناء

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

ملاحظة  إزالة عميل البناء لا يقوم بإلغاء تثبيت خدمة بنية Team Foundation من جهاز البناء.

لإزالة عميل بناء باستخدام جهاز العميل

1. في قائمة البناء، انقر فوق إدارة عناصر تحكم البناء .

   يظهر مربع حوار إدارة أجهزة تحكم إنشاء .

2. انقر فوق وحدة تحكم البناء أو عميل البناء الذي تريد إزالته، ثم انقر فوق إزالة .

لإزالة عميل بناء من جهاز البناء الخاصة به

1. قم بتسجيل الدخول إلى جهاز البناء الذي يقوم بتشغيل عميل البناء الذي تريد تعديله.

2. انقر فوق ابدأ ، انقر فوق كافة البرامج انقر فوق Microsoft Team Foundation Server 2010 و انقر فوق وحدة تحكم إدارة أساس الفريق .

   تظهر وحدة تحكم إدارة Team Foundation .

3. في جزء الشجرة قم بتوسيع اسم الخادم، ثم قم بتوسيع إنشاء أساس الفريق .

4. مباشرة تحت اسم العامل الإنشاء، انقر فوق إزالة.

راجع أيضًا:

موارد أخرى

إنشاء ثم العمل مع إنشاء تعريفات

إنشاء ثم العمل مع إنشاء تعريفات