مشاركة عبر

ExtractFiles@1 - استخراج الملفات v1 المهمة

  • مقالة

استخدم هذه المهمة لاستخراج مجموعة متنوعة من ملفات الأرشيف والضغط، مثل .7z .rar و.tar.gz .zip.

بناء الجملة

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '*.zip' # string. Required. Archive file patterns. Default: *.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.

# Extract Files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '*.zip' # string. Required. Archive file patterns. Default: *.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.

الإدخالات

archiveFilePatterns - أرشفة أنماط الملفات
string. مطلوب القيمة الافتراضية: **/*.zip.

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

يحدد الأنماط لمطابقة الأرشيفات التي تريد استخراجها. بشكل افتراضي، تبدأ الأنماط في المجلد الجذر للمرجع (كما لو كنت قد حددت $(Build.SourcesDirectory).
يحدد عوامل تصفية الأنماط، واحدة لكل سطر، التي تطابق الأرشيفات لاستخراجها. على سبيل المثال:

  • test.zip يستخرج ملف test.zip في المجلد الجذر.
  • test/*.zip يستخرج جميع ملفات .zip في مجلد الاختبار.
  • **/*.tar يستخرج جميع ملفات .tar في المجلد الجذر والمجلدات الفرعية.
  • **/bin/*.7z يستخرج جميع ملفات .7z في أي مجلد فرعي يسمى "bin".
    يتم استخدام النمط لمطابقة مسارات ملفات الأرشيف فقط، وليس مسارات المجلدات، وليس أرشفة المحتويات المراد استخراجها. لذلك، يجب تحديد أنماط، مثل **/bin/** بدلا من **/bin.

archiveFilePatterns - أرشفة أنماط الملفات
string. مطلوب القيمة الافتراضية: *.zip.

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


destinationFolder - مجلد الوجهة
string. مطلوب

يحدد المجلد الوجهة الذي يجب استخراج ملفات الأرشيف فيه. استخدم المتغيرات إذا لم تكن الملفات في المستودع. على سبيل المثال: $(agent.builddirectory).


cleanDestinationFolder - تنظيف مجلد الوجهة قبل استخراج
boolean. القيمة الافتراضية: true.

يحدد خيار تنظيف الدليل الوجهة قبل استخراج محتويات الأرشيف فيه.


overwriteExistingFiles - الكتابة فوق الملفات الموجودة
boolean. القيمة الافتراضية: false.

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


pathToSevenZipTool - المسار إلى الأداة المساعدة 7z
string.

يحدد المسار المخصص إلى الأداة المساعدة 7z. على سبيل المثال، C:\7z\7z.exe على Windows وعلى /usr/local/bin/7z MacOS/Ubuntu. إذا لم يتم تحديده على Windows، فسيتم استخدام إصدار 7zip الافتراضي المتوفر مع مهمة.


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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لاستخراج الملفات من الأرشيفات إلى مجلد هدف باستخدام أنماط المطابقة. يتم دعم مجموعة من تنسيقات الأرشيف القياسية، بما في ذلك .zip و.jar و.war و.ear و.tar و.7z والمزيد.

لمزيد من المعلومات حول أنماط مطابقة الملفات، راجع مرجع أنماط مطابقة الملف.

أمثلة

استخراج جميع ملفات .zip بشكل متكرر

سيقوم هذا المثال باستخراج جميع الملفات .zip بشكل متكرر، بما في ذلك كل من الملفات الجذر والملفات من المجلدات الفرعية.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

استخراج جميع ملفات .zip من مجلد فرعي

سيقوم هذا المثال باستخراج test/one.zip و test/two.zip، ولكن سيترك test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

المتطلبات

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

راجع أيضًا