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

Pliki archiwum korzystające z 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. Wymagane. Wartość domyślna: $(Build.BinariesDirectory).

Nazwa folderu głównego lub ścieżki pliku do plików do dodania do archiwum. W przypadku folderów wszystkie elementy w nazwanym folderze są dodawane do archiwum.

includeRootFolder - Wstępna nazwa 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 rozpoczną się o 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.

archiveType - Typ archiwum
string. Wymagane. Dozwolone wartości: zip, 7z, tar, wim. Wartość domyślna: zip.

Określa format kompresji. Prawidłowe formaty obejmują:

• zip -Domyślny. 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, , normalmaximum, fast, fastest, . none Wartość domyślna: normal.

Ustaw poziom kompresji lub None utwórz nieskompresowany plik 7z.

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

Ustaw format kompresji lub wybierz opcję None utworzenia nieskompresowanego pliku 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. Wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Określ nazwę pliku archiwum do utworzenia. Aby na przykład utworzyć polecenie 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 falsewartości na , do istniejącego archiwum zostaną dodane nieskompresowane pliki tar.

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

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

verbose - Wymuszanie pełnych danych wyjściowych
boolean. Wartość domyślna: false.

W przypadku ustawienia wartości true wymusza użycie pełnych danych wyjściowych przy użyciu narzędzi. Zastępuje ustawienie "quiet".

quiet - Wymuś ciche wyjście
boolean. Wartość domyślna: false.

Jeśli jest ustawiona wartość true, wymusza użycie cichych danych wyjściowych przy użyciu narzędzi. To verbose ustawienie (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 sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

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 w	Agent, DeploymentGroup
Wymagania	Brak
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 ustawialne	To zadanie ma uprawnienia do ustawiania następujących zmiennych: Ustawienie zmiennych jest wyłączone
Wersja agenta	2.182.1 lub nowsza
Kategoria zadania	Narzędzie