ExtractFiles@1 - Estrarre file v1 attività

Usare questa attività per estrarre un'ampia gamma di file di archiviazione e compressione, ad esempio .7z, .rar, tar.gz e .zip.

Sintassi

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Input

archiveFilePatterns - Modelli di file di archiviazione
string. Obbligatorio. Valore predefinito: **/*.zip.

Specifica i percorsi o i modelli dei file di archiviazione da estrarre. Supporta più righe di modelli minimatch. Altre informazioni sull'attività Estrarre file.

Specifica i modelli che corrispondono agli archivi da estrarre. Per impostazione predefinita, i modelli iniziano nella cartella radice del repository (uguale a se è stato specificato $(Build.SourcesDirectory).
Specifica i filtri del modello, uno per riga, che corrispondono agli archivi da estrarre. Ad esempio:

• test.zip estrae il file test.zip nella cartella radice.
• test/*.zip estrae tutti i file .zip nella cartella di test.
• **/*.tar estrae tutti i file tar nella cartella radice e nelle sottocartelle.
• **/bin/*.7z estrae tutti i file con estensione 7z in qualsiasi sottocartella denominata "bin".
  Il modello viene usato per corrispondere solo ai percorsi dei file di archiviazione, non ai percorsi delle cartelle e non ai contenuti di archiviazione da estrarre. È quindi consigliabile specificare modelli, ad esempio **/bin/** anziché **/bin.

destinationFolder - Cartella di destinazione
string. Obbligatorio.

Specifica la cartella di destinazione in cui estrarre i file di archivio. Usare le variabili se i file non si trovano nel repository. Ad esempio: $(agent.builddirectory).

cleanDestinationFolder - Pulire la cartella di destinazione prima di estrarre
boolean. Valore predefinito: true.

Specifica l'opzione per pulire la directory di destinazione prima di estrarre il contenuto dell'archivio.

overwriteExistingFiles - Sovrascrivere i file esistenti
boolean. Valore predefinito: false.

Specifica l'opzione per sovrascrivere i file esistenti nella directory di destinazione se sono già presenti. Se l'opzione è false, lo script richiede file esistenti, chiedendo se si desidera sovrascriverle.

pathToSevenZipTool - Percorso dell'utilità 7z
string.

Specifica il percorso personalizzato dell'utilità 7z. Ad esempio, C:\7z\7z.exe in Windows e /usr/local/bin/7z in MacOS/Ubuntu. Se non è specificato in Windows, verrà usata la versione predefinita 7zip fornita con un'attività.

Opzioni di controllo 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

No.

Osservazioni

Usare questa attività per estrarre i file dagli archivi a una cartella di destinazione usando modelli di corrispondenza. È supportata una gamma di formati di archivio standard, tra cui .zip, .jar, .war, .ear, .tar, .7z e altro ancora.

Per altre informazioni sui modelli di corrispondenza dei file, vedere riferimento ai modelli di corrispondenza file.

Esempio

Estrarre tutti i file .zip ricorsivamente

Questo esempio estrae tutti i file .zip ricorsivamente, inclusi i file radice e i file dalle sottocartelle.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Estrarre tutti i file .zip dalla sottocartella

Questo esempio estraerà test/one.zip e test/two.zip, ma lascerà test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione 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: limitato
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à

Vedi anche

• Informazioni di riferimento per i criteri di corrispondenza dei file