ArchiveFiles@2 — zadanie Archiwizowanie plików w wersji 2

Archiwizowanie plików przy użyciu formatów kompresji, takich jak .7z, .tar, .gz i .zip.

Składnia

# 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.

Dane wejściowe

rootFolderOrFile - folder główny lub plik do archiwizacji
string. To jest wymagane. Wartość domyślna: $(Build.BinariesDirectory).

Nazwa folderu głównego lub ścieżki pliku do plików, które mają zostać dodane do archiwum. W przypadku folderów wszystkie elementy w nazwanym folderze są dodawane do archiwum.

includeRootFolder - prepend nazwy folderu głównego do ścieżek archiwum
boolean. Wartość domyślna: true.

Poprzedza nazwę folderu głównego ścieżkami plików w archiwum. W przeciwnym razie wszystkie ścieżki plików będą uruchamiać jeden poziom niższy.

Jeśli na przykład folder główny to: /home/user/output/classes/ i ścieżka pliku: com/acme/Main.class. Wynikowe archiwum będzie zawierać: classes/com/acme/Main.class. W przeciwnym razie wynikowe archiwum będzie zawierać: com/acme/Main.class.

typ archiwum archiveType -
string. To jest wymagane. Dozwolone wartości: zip, , 7ztar, wim. Wartość domyślna: zip.

Określa format kompresji. Prawidłowe formaty to:

• zip — ustawienie domyślne. Wybierz ten format dla wszystkich typów zgodnych z plikiem zip, takich jak .zip, .jar, war, .ear
• 7z — format 7-Zip (.7z)
• tar — format tar, używany do skompresowanych tars, w tym .tar.gz, .tar.bz2, .tar.xz
• wim — format wim, .wim

Aby na przykład utworzyć archiwum o nazwie foo.jar:

• Wybieranie formatu kompresji zip
• Określ nazwę pliku archiwum do utworzenia: foo.jar

sevenZipCompression - kompresja 7z
string. Opcjonalny. Użyj polecenia , gdy archiveType = 7z. Dozwolone wartości: ultra, maximum, normal, fast, fastest, none. Wartość domyślna: normal.

Ustaw poziom kompresji lub None, aby utworzyć nieskompresowany plik .7z.

tarCompression - kompresja Tar
string. Opcjonalny. Użyj polecenia , gdy archiveType = tar. Dozwolone wartości: gz, , bz2xz, none. Wartość domyślna: gz.

Ustaw format kompresji lub wybierz None, aby utworzyć nieskompresowany plik .tar.

• gz — domyślny format kompresji gzip (.tar.gz, .tar.tgz, .taz)
• bz2 — kompresja bzip2 (.tar.bz2, .tz2, .tbz2)
• xz — kompresja xz (.tar.xz, .txz)

archiveFile - plik archiwum do utworzenia
string. To jest wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Określ nazwę pliku archiwum do utworzenia. Aby na przykład utworzyć foo.tgz:

• Ustaw typ archiwum: tar
• Ustaw kompresję tar: gz

replaceExistingArchive - Zamień istniejące archiwum
boolean. Wartość domyślna: true.

Domyślnie zastępuje istniejące archiwum. W przeciwnym razie po ustawieniu wartości falsepliki tar nieskompresowane są dodawane do istniejącego archiwum.

Obsługiwane formaty plików, które można dodać do istniejącego archiwum:

• zip
• 7z
• tar — tylko nieskompresowane
• wim

verbose - Wymuś pełne dane wyjściowe
boolean. Wartość domyślna: false.

W przypadku ustawienia wartości true wymusza użycie pełnych danych wyjściowych przez narzędzia. Zastępuje ustawienie "cichy".

quiet - Wymuszanie cichych danych wyjściowych
boolean. Wartość domyślna: false.

Jeśli ustawiono wartość true, wymusza użycie cichych danych wyjściowych przez narzędzia. Ustawienie verbose (lub równoważne) może zastąpić to ustawienie.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

To zadanie służy do tworzenia pliku archiwum z folderu źródłowego. Obsługiwane są standardowe formaty archiwum, w tym .zip, .jar, war, .ear, .tar, .7z i inne.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	To zadanie jest uruchamiane przy użyciu następujących ograniczeń poleceń : ograniczone
zmienne ustawiane	To zadanie ma uprawnienia do ustawić następujące zmienne: Ustawienie zmiennych jest wyłączone
Wersja agenta	2.182.1 lub nowsza
Kategoria zadań	Użyteczność