Compartir a través de


ArchiveFiles@2: tarea Archivar archivos v2

Archive archivos con formatos de compresión como .7z, .tar, .gz y .zip.

Archive archivos con formatos de compresión como .7z, .rar, .tar., .gz y .zip.

Sintaxis

# 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.
# 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: '5' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: 5.
    #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.
# 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.
    #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.
# Archive Files v2
# Archive files using compression formats such as .7z, .rar, .tar.gz, and .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.
    #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.

Entradas

rootFolderOrFile - Carpeta raíz o archivo que se va a archivar
string. Obligatorio. Valor predeterminado: $(Build.BinariesDirectory).

Nombre de la carpeta raíz o la ruta de acceso del archivo a los archivos que se van a agregar al archivo. En el caso de las carpetas, todo lo que hay en la carpeta con nombre se agrega al archivo.


includeRootFolder - Anteponer el nombre de la carpeta raíz a las rutas de acceso de archivo
boolean. Valor predeterminado: true.

Antepone el nombre de la carpeta raíz a las rutas de acceso de archivo del archivo. De lo contrario, todas las rutas de acceso de archivo iniciarán un nivel inferior.

Por ejemplo, si la carpeta raíz es: /home/user/output/classes/ y la ruta de acceso del archivo: com/acme/Main.class. El archivo resultante contendrá: classes/com/acme/Main.class. De lo contrario, el archivo resultante contendrá: com/acme/Main.class.


archiveType - Tipo de archivo
string. Obligatorio. Valores permitidos: zip, 7z, tar, wim. Valor predeterminado: zip.

Especifica un formato de compresión. Entre los formatos válidos se incluyen:

  • zip -Predeterminado. Elija este formato para todos los tipos compatibles con zip, como .zip, .jar, .war, .ear
  • 7z - Formato 7-Zip, (.7z)
  • tar - formato tar, se usa para tars comprimidos, incluidos .tar.gz, .tar.bz2, .tar.xz
  • wim - formato wim, .wim

Por ejemplo, para crear un archivo denominado foo.jar:

  • Selección del formato de compresión zip
  • Especifique el nombre del archivo de archivo que se va a crear: foo.jar

sevenZipCompression - Compresión 7z
string. Opcional. Use cuando archiveType = 7z. Valores permitidos: ultra, maximum, normal, fast, fastest, . none Valor predeterminado: normal.

Establezca el nivel de compresión o None para crear un archivo .7z sin comprimir.


sevenZipCompression - Compresión 7z
string. Opcional. Use cuando archiveType = 7z. Valores permitidos: ultra, maximum, normal, fast, fastest, . none Valor predeterminado: 5.

Establezca un formato de compresión o None para crear un archivo .7z sin comprimir.


tarCompression - Compresión tar
string. Opcional. Use cuando archiveType = tar. Valores permitidos: gz, bz2, xz, none. Valor predeterminado: gz.

Establezca un formato de compresión o elija None crear un archivo .tar sin comprimir.

  • gz - Formato predeterminado para la compresión gzip (.tar.gz, .tar.tgz, .taz)
  • bz2 - compresión bzip2 (.tar.bz2, .tz2, .tbz2)
  • xz - compresión xz (.tar.xz, .txz)

archiveFile - Archivo de archivo que se va a crear
string. Obligatorio. Valor predeterminado: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Especifique el nombre del archivo de archivo que se va a crear. Por ejemplo, para crear foo.tgz:

  • Establezca el tipo de archivo: tar
  • Establecer compresión tar: gz

replaceExistingArchive - Reemplazar el archivo existente
boolean. Valor predeterminado: true.

De forma predeterminada, sobrescribe un archivo existente. De lo contrario, cuando se establece en false, los archivos tar sin comprimir se agregan al archivo existente.

Formatos de archivo admitidos que se pueden agregar a un archivo existente:

  • zip
  • 7z
  • tar - Solo sin comprimir
  • wim

verbose - Forzar salida detallada
boolean. Valor predeterminado: false.

Si se establece en true, obliga a las herramientas a usar la salida detallada. Invalida la configuración "quiet".


quiet - Forzar salida silenciosa
boolean. Valor predeterminado: false.

Si se establece en true, obliga a las herramientas a usar la salida silenciosa. La verbose configuración (o equivalente) puede invalidar esta configuración.


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 crear un archivo de archivo a partir de una carpeta de origen. Se admiten formatos de archivo estándar, incluidos .zip, .jar, .war, .ear, .tar, .7z, etc.

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