مشاركة عبر

ShellScript@2 - مهمة البرنامج النصي Shell v2

  • مقالة

استخدم هذه المهمة لتشغيل برنامج نصي shell باستخدام bash.

بناء الجملة

# Shell script v2
# Run a shell script using Bash.
- task: ShellScript@2
  inputs:
    scriptPath: # string. Required. Script Path. 
    #args: # string. Arguments. 
  # Advanced
    #disableAutoCwd: false # boolean. Specify Working Directory. Default: false.
    #cwd: # string. Optional. Use when disableAutoCwd = true. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

# Shell Script v2
# Run a shell script using bash.
- task: ShellScript@2
  inputs:
    scriptPath: # string. Required. Script Path. 
    #args: # string. Arguments. 
  # Advanced
    #disableAutoCwd: false # boolean. Specify Working Directory. Default: false.
    #cwd: # string. Optional. Use when disableAutoCwd = true. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

الإدخالات

scriptPath - مسار البرنامج النصي
string. مطلوب

يحدد المسار النسبي من جذر المستودع إلى ملف البرنامج النصي shell الذي تريد تشغيله.


args - الحجج
string.

يحدد الوسيطات التي تريد تمريرها إلى البرنامج النصي.


disableAutoCwd - تحديد دليل العمل
boolean. القيمة الافتراضية: false.

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


cwd - دليل العمل
string. ‏‏اختياري. استخدم عندما disableAutoCwd = true.

يحدد دليل العمل حيث يتم تشغيل البرنامج النصي. إذا تركت القيمة فارغة، تستخدم المهمة جذر المستودع (البنية) أو البيانات الاصطناعية (الإصدار)، وهو $(System.DefaultWorkingDirectory).


failOnStandardError - فشل عند الخطأ القياسي
boolean. القيمة الافتراضية: false.

إذا كانت القيمة هي true، فستفشل المهمة إذا تمت كتابة الأخطاء في دفق StandardError.


خيارات التحكم بالمهمة

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

متغيرات الإخراج

لا شيء

الملاحظات

أين يمكنني التعرف على نصوص Bash النصية؟

كيف أعمل تعيين متغير بحيث يمكن قراءته بواسطة البرامج النصية والمهام اللاحقة؟

لمعرفة المزيد حول تعريف متغيرات البناء في برنامج نصي، راجع تعريف متغيرات البناء وتعديلها في برنامج نصي.

لمعرفة المزيد حول تعريف متغيرات الإصدار في برنامج نصي، راجع تعريف متغيرات الإصدار وتعديلها في برنامج نصي

أمثلة

إنشاء test.sh في جذر المستودع الخاص بك. نوصي بإنشاء هذا الملف من بيئة Linux (مثل جهاز Linux حقيقي أو نظام Windows الفرعي لـ Linux‬) بحيث تكون نهايات الأسطر صحيحة. أيضا، لا تنس قبل chmod +x test.sh تثبيته.

#!/bin/bash
echo "Hello World"
echo "AGENT_WORKFOLDER is $AGENT_WORKFOLDER"
echo "AGENT_WORKFOLDER contents:"
ls -1 $AGENT_WORKFOLDER
echo "AGENT_BUILDDIRECTORY is $AGENT_BUILDDIRECTORY"
echo "AGENT_BUILDDIRECTORY contents:"
ls -1 $AGENT_BUILDDIRECTORY
echo "SYSTEM_HOSTTYPE is $SYSTEM_HOSTTYPE"
echo "Over and out."

أضف المهمة التالية إلى البنية الأساسية لبرنامج ربط العمليات التجارية لتشغيل البرنامج النصي السابق.

- task: ShellScript@2
  inputs:
    scriptPath: 'test.sh'

المتطلبات

المتطلب الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب يجب أن يكون لدى العوامل المستضافة ذاتيا قدرات تطابق الطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: sh
القدرات لا تلبي هذه المهمة أي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل جميع إصدارات العامل المدعومة.
فئة المهمة الأداة المساعدة