ArchiveFiles@2 - Attività Archivia file v2

Archiviare i file usando formati di compressione come .7z, tar, gz e .zip.

Sintassi

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

Input

rootFolderOrFile - Cartella radice o file da archiviare
string. Obbligatorio. Valore predefinito: $(Build.BinariesDirectory).

Nome della cartella radice o del percorso del file da aggiungere all'archivio. Per le cartelle, tutti gli elementi nella cartella denominata vengono aggiunti all'archivio.

includeRootFolder - Anteporre il nome della cartella radice ai percorsi di archiviazione
boolean. Valore predefinito: true.

Antepone il nome della cartella radice ai percorsi di file nell'archivio. In caso contrario, tutti i percorsi di file inizieranno un livello inferiore.

Ad esempio, se la cartella radice è: /home/user/output/classes/ e il percorso del file: com/acme/Main.class. L'archivio risultante conterrà: classes/com/acme/Main.class. In caso contrario, l'archivio risultante conterrà: com/acme/Main.class.

archiveType - Tipo di archivio
string. Obbligatorio. Valori consentiti: zip, 7z, tar, wim. Valore predefinito: zip.

Specifica un formato di compressione. I formati validi includono:

• zip -Predefinito. Scegliere questo formato per tutti i tipi compatibili con zip, ad esempio .zip, .jar, .war, .ear
• 7z - Formato 7-Zip, (.7z)
• tar - formato tar, usare per tar compressi, tra cui .tar.gz, .tar.bz2, .tar.xz
• wim - formato wim, wim

Ad esempio, per creare un archivio denominato foo.jar:

• Selezionare il formato di compressione zip
• Specificare il nome del file di archivio da creare: foo.jar

sevenZipCompression - Compressione di 7z
string. Facoltativa. Usare quando archiveType = 7z. Valori consentiti: ultra, maximum, normal, fast, fastest, none. Valore predefinito: normal.

Impostare il livello di compressione o None per creare un file con estensione 7z non compresso.

tarCompression - Compressione tar
string. Facoltativa. Usare quando archiveType = tar. Valori consentiti: gz, bz2, xz, none. Valore predefinito: gz.

Impostare un formato di compressione o scegliere None di creare un file tar non compresso.

• gz - Formato predefinito per la compressione gzip (.tar.gz, .tar.tgz, .taz)
• bz2 - compressione bzip2 (.tar.bz2, .tz2, .tbz2)
• xz - compressione xz (.tar.xz, .txz)

archiveFile - File di archiviazione da creare
string. Obbligatorio. Valore predefinito: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Specificare il nome del file di archivio da creare. Ad esempio, per creare foo.tgz:

• Impostare il tipo di archivio: tar
• Impostare la compressione tar: gz

replaceExistingArchive - Sostituire l'archivio esistente
boolean. Valore predefinito: true.

Per impostazione predefinita, sovrascrive un archivio esistente. In caso contrario, se impostato su false, i file tar non compressi vengono aggiunti all'archivio esistente.

Formati di file supportati che possono essere aggiunti a un archivio esistente:

• zip
• 7z
• tar - Solo non compresso
• wim

verbose - Forzare l'output dettagliato
boolean. Valore predefinito: false.

Se impostato su true, forza gli strumenti a usare l'output dettagliato. Esegue l'override dell'impostazione "quiet".

quiet - Forzare l'output non interattiva
boolean. Valore predefinito: false.

Se impostato su true, forza gli strumenti a usare l'output non interattiva. L'impostazione verbose (o equivalente) può eseguire l'override di questa impostazione.

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input dell'attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

No.

Osservazioni

Usare questa attività per creare un file di archivio da una cartella di origine. I formati di archivio standard sono supportati, tra cui .zip, .jar, .war, .ear, .tar, .7z e altro ancora.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Questa attività viene eseguita usando le restrizioni di comando seguenti: con restrizioni
Variabili impostabili	Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: L'impostazione delle variabili è disabilitata
Versione agente	2.182.1 o versione successiva
Categoria attività	Utilità