ExtractFiles@1: tarea Extraer archivos v1

Use esta tarea para extraer una variedad de archivos de archivo y compresión, como .7z, .rar, .tar.gz y .zip.

Sintaxis

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

Entradas

archiveFilePatterns - de archivos de archivo de archivo
string. Obligatorio. Valor predeterminado: **/*.zip.

Especifica las rutas de acceso o patrones de archivo de los archivos de archivo que se van a extraer. Admite varias líneas de patrones de minimatch. Obtenga más información sobre la tarea Extraer archivos .

Especifica los patrones para que coincidan con los archivos que desea extraer. De forma predeterminada, los patrones se inician en la carpeta raíz del repositorio (igual que si hubiera especificado $(Build.SourcesDirectory).
Especifica los filtros de patrón, uno por línea, que coinciden con los archivos que se van a extraer. Por ejemplo:

• test.zip extrae el archivo test.zip en la carpeta raíz.
• test/*.zip extrae todos los archivos .zip de la carpeta test.
• **/*.tar extrae todos los archivos .tar de la carpeta raíz y las subcarpetas.
• **/bin/*.7z extrae todos los archivos .7z de cualquier subcarpeta denominada "bin".
  El patrón se usa para coincidir solo con las rutas de acceso de archivo de archivo, no las rutas de acceso de carpeta y no el contenido de archivo que se va a extraer. Por lo tanto, debe especificar patrones, como **/bin/** en lugar de **/bin.

carpeta de destino de destinationFolder -
string. Obligatorio.

Especifica la carpeta de destino en la que se deben extraer los archivos de archivo. Use variables si los archivos no están en el repositorio. Por ejemplo: $(agent.builddirectory).

cleanDestinationFolder - carpeta Limpiar destino antes de extraer
boolean. Valor predeterminado: true.

Especifica la opción de eliminar todo el contenido del directorio de destino (limpio) antes de extraer el contenido del archivo en él.

overwriteExistingFiles - Sobrescribir archivos existentes
boolean. Valor predeterminado: false.

Especifica la opción de sobrescribir los archivos existentes en el directorio de destino si ya existen. Si la opción es false, el script pregunta si quiere sobrescribirlos.

pathToSevenZipTool - ruta de acceso a la utilidad 7z
string.

Especifica la ruta de acceso personalizada a la utilidad 7z. Por ejemplo, C:\7z\7z.exe en Windows y /usr/local/bin/7z en MacOS/Ubuntu. Si no se especifica en Windows, se usará la versión 7zip predeterminada proporcionada con una tarea.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para extraer archivos de archivos en una carpeta de destino mediante patrones de coincidencia. Se admite una gama de formatos de archivo estándar, incluidos .zip, .jar, .war, .ear, .tar, .7z, etc.

Para obtener más información sobre los patrones de coincidencia de archivos, consulte la referencia de patrones de coincidencia de archivos .

Ejemplos

Extracción de todos los archivos .zip de forma recursiva

En este ejemplo se extraerán todos los archivos .zip de forma recursiva, incluidos los archivos raíz y los archivos de las subcarpetas.

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

Extracción de todos los archivos .zip de la subcarpeta

En este ejemplo se extraerán test/one.zip y test/two.zip, pero dejará test/nested/three.zip.

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

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Esta tarea se ejecuta con las restricciones de comandos siguientes: restringido
variables settable	Esta tarea tiene permiso para establecer las siguientes variables: La configuración de variables está deshabilitada.
Versión del agente	2.182.1 o superior
Categoría de tarea	Utilidad

Consulte también

• Referencia de patrones de coincidencia de archivos