ArchiveFiles@2 - أرشفة ملفات v2 المهمة

أرشفة الملفات باستخدام تنسيقات الضغط مثل .7z و.tar و.gz .zip.

بناء الجملة

# Archive files v2
# Compress files into .7z, .tar.gz, or .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #sevenZipCompression: 'normal' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: normal.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.
    #verbose: false # boolean. Force verbose output. Default: false.
    #quiet: false # boolean. Force quiet output. Default: false.

الإدخالات

rootFolderOrFile - المجلد الجذر أو الملف المراد أرشفته
string. مطلوب القيمة الافتراضية: $(Build.BinariesDirectory).

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

includeRootFolder - إلحاق اسم المجلد الجذر إلى مسارات الأرشيف
boolean. القيمة الافتراضية: true.

إلحاق اسم المجلد الجذر بمسارات الملفات في الأرشيف. وإلا، ستبدأ جميع مسارات الملفات بمستوى واحد أقل.

على سبيل المثال، إذا كان المجلد الجذر هو: /home/user/output/classes/ ومسار الملف: com/acme/Main.class. سيحتوي الأرشيف الناتج على: classes/com/acme/Main.class. وإلا، سيحتوي الأرشيف الناتج على: com/acme/Main.class.

archiveType - نوع الأرشيف
string. مطلوب القيم المسموح بها: zip، 7z، ، tarwim. القيمة الافتراضية: zip.

تحديد تنسيق ضغط. تتضمن التنسيقات الصالحة ما يلي:

• zip -الافتراضي. اختر هذا التنسيق لجميع الأنواع المتوافقة مع الرمز البريدي مثل .zip و.jar و.war و.ear
• 7z - تنسيق 7-Zip، (.7z)
• tar - تنسيق tar، استخدم لقطران مضغوطة بما في ذلك .tar.gz، .tar.bz2، .tar.xz
• wim - تنسيق wim، .wim

على سبيل المثال، لإنشاء أرشيف باسم foo.jar:

• تحديد تنسيق الضغط zip
• حدد اسم ملف الأرشيف المراد إنشاؤه: foo.jar

sevenZipCompression - ضغط 7z
string. ‏‏اختياري. استخدم عندما archiveType = 7z. القيم المسموح بها: ultra، maximum، normal، fast، fastest. none القيمة الافتراضية: normal.

قم بتعيين مستوى الضغط أو None لإنشاء ملف .7z غير مضغوط.

tarCompression - ضغط القطران
string. ‏‏اختياري. استخدم عندما archiveType = tar. القيم المسموح بها: gz، bz2، ، xznone. القيمة الافتراضية: gz.

قم بتعيين تنسيق ضغط أو اختر None إنشاء ملف .tar غير مضغوط.

• gz - التنسيق الافتراضي لضغط gzip (.tar.gz، .tar.tgz، .taz)
• bz2 - ضغط bzip2 (.tar.bz2، .tz2، .tbz2)
• xz - ضغط xz (.tar.xz، .txz)

archiveFile - أرشفة الملف المراد إنشاؤه
string. مطلوب القيمة الافتراضية: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

حدد اسم ملف الأرشيف المراد إنشاؤه. على سبيل المثال، لإنشاء foo.tgz:

• تعيين نوع الأرشيف: tar
• تعيين ضغط القطران: gz

replaceExistingArchive - استبدال الأرشيف الموجود
boolean. القيمة الافتراضية: true.

بشكل افتراضي، يقوم بالكتابة فوق أرشيف موجود. وإلا، عند التعيين إلى false، تتم إضافة ملفات tar غير المضغوطة إلى الأرشيف الموجود.

تنسيقات الملفات المدعومة التي يمكن إضافتها إلى أرشيف موجود:

• zip
• 7z
• tar - غير مضغوط فقط
• wim

verbose - فرض الإخراج المطول
boolean. القيمة الافتراضية: false.

إذا تم تعيينه إلى true، يفرض على الأدوات استخدام الإخراج المطول. يتجاوز إعداد "الهدوء".

quiet - فرض إخراج هادئ
boolean. القيمة الافتراضية: false.

إذا تم تعيينه إلى true، يفرض على الأدوات استخدام الإخراج الهادئ. يمكن للإعداد verbose (أو ما يعادله) تجاوز هذا الإعداد.

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

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

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

لا شيء

الملاحظات

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

المتطلبات

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