ArchiveFiles@2 - Attività Archivia file v2

Archiviare i file usando formati di compressione, ad esempio .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.

Ingressi dati

rootFolderOrFile - cartella o file radice 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 - nome della cartella radice anteporta 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 archivio
string. Obbligatorio. Valori consentiti: zip, 7z, tar, wim. Valore predefinito: zip

Specifica un formato di compressione. I formati validi includono:

• zip : impostazione predefinita. Scegliere questo formato per tutti i tipi compatibili con zip, ad esempio .zip, .jar, .war, .ear
• 7z - Formato zip 7, (.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 7z
string. Opzionale. 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 di .7z non compresso.

tarCompression - compressione Tar
string. Opzionale. Usare quando archiveType = tar. Valori consentiti: gz, bz2, xz, none. Valore predefinito: gz

Impostare un formato di compressione o scegliere None per 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 per 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 - Sostituisci 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 - Forza 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 - Forza 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 delle attività

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

Variabili di output

Nessuno.

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
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni
variabili impostabili	Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: L'impostazione delle variabili è disabilitata
Versione dell'agente	2.182.1 o versione successiva
Categoria attività	Utilità