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 |