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

Entradas

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

Especifica las rutas de acceso de archivo o los patrones 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 que deben coincidir 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 de prueba.
  • **/*.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 hacer coincidir solo 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.

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

Especifica las rutas de acceso de archivo o los patrones 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.


destinationFolder - Carpeta de destino
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 - Limpiar la carpeta de destino antes de extraer
boolean. Valor predeterminado: true.

Especifica la opción de limpiar el directorio de destino antes de extraer el contenido del archivo en él.


overwriteExistingFiles - Sobrescribir los 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 predeterminada 7zip proporcionada con una tarea.


Opciones de control de tareas

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

Variables de salida

Ninguno.

Comentarios

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

Extraer todos los archivos de .zip de forma recursiva

En este ejemplo se extraerán todos los archivos de .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á 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
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Esta tarea se ejecuta con las siguientes restricciones de comandos: restringido
Variables que se pueden establecer 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 la tarea: Utilidad
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente Todas las versiones de agente compatibles.
Categoría de la tarea: Utilidad

Consulte también