Tarea Archivos de archivo

  • Artículo
  • 4 minutos para leer
Argumento Descripción
rootFolderOrFile
Carpeta raíz o archivo que se archivará		 (Obligatorio) Escriba la carpeta raíz o la ruta de acceso del archivo que se agregará al archivo. Si hay una carpeta, todo lo que hay debajo de la carpeta se agregará al archivo resultante.
Valor predeterminado: $(Build.BinariesDirectory)
includeRootFolder
Anteponer el nombre de la carpeta raíz a las rutas de acceso de archivo		 (Obligatorio) Si está seleccionada, el nombre de la carpeta raíz tendrá como prefijo las rutas de acceso de archivo dentro del archivo. De lo contrario, todas las rutas de acceso de archivo se iniciarán un nivel inferior.
Por ejemplo,suponga que la carpeta raíz seleccionada es : y contiene: com/acme/Main.class .
  • Si se selecciona, el archivo resultante contendrá: classes/com/acme/Main.class
  • De lo contrario, el archivo resultante contendrá: com/acme/Main.class..
archiveType
Tipo de archivo		 (Obligatorio) Especifique el esquema de compresión utilizado. Para crear foo.jar , por ejemplo, elija zip para la compresión y especifique foo.jar como archivo de archivo que se creará. Para todos los archivos tar (incluidos los comprimidos), elija tar .
  • zip - valor predeterminado, formato zip, elija esta opción para todos los tipos compatibles con archivos ZIP (.zip, .jar, .war, .ear)
  • 7z - Formato 7-Zip, (.7z)
  • tar - formato tar, elija esta opción para tars comprimidos(.tar.gz, .tar.bz2, .tar.xz)
  • wim - formato wim, (.wim)
sevenZipCompression
7z compression		 Opcionalmente, elija un nivel de compresión o None elija crear un archivo 7z sin comprimir.
Valor predeterminado: Normal
Opciones:
  • Ultra
  • Máximo
  • Normal
  • Rápido
  • Rápido
  • Ninguno
tarCompression
Compresión tar		 Opcionalmente, elija un esquema de compresión o None cree un archivo tar sin comprimir.
  • gz - valor predeterminado, compresión gzip (.tar.gz, .tar.tgz, .taz)
  • bz2 - compresión bzip2 (.tar.bz2, .tz2, .tbz2)
  • xz - compresión xz (.tar.xz, .txz)
  • None - sin compresión, elija esta opción para crear un archivo tar sin comprimir (.tar)

Valor predeterminado: gz
archiveFile
Archivo de archivo que se creará		 (Obligatorio) Especifique el nombre del archivo de archivo que se creará.
Por ejemplo,para crear , seleccione el tipo de archivo y para la compresión targz tar.
Valor predeterminado: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
replaceExistingArchive
Reemplazo del archivo existente		 (Obligatorio) Si existe un archivo existente, especifique si desea sobrescribirlo. De lo contrario, se le agregarán archivos siempre y cuando no sea un tar comprimido.
Si se agrega a un archivo existente, se admiten estos tipos:
  • zip
  • 7z
  • tar - solo sin comprimir
  • wim
verbose
Fuerza la salida detallada		 (Opcional) Si se establece en true, obliga a las herramientas a usar la salida detallada. Invalida "quiet".
Valor predeterminado: false
quiet
Fuerza la salida silenciosa		 (Opcional) Si se establece en true, obliga a las herramientas a usar una salida silenciosa. Se puede reemplazar por "verbose".
Valor predeterminado: false

Código Abierto

Esta tarea es de código abierto en GitHub. Los comentarios y las contribuciones son bienvenidos.

Preguntas más frecuentes

P: Tengo problemas con la publicación de mis artefactos. ¿Cómo puedo ver los registros detallados?

Para habilitar registros detallados para la canalización:

  1. Editar la canalización y seleccionar Variables
  2. Agregar una nueva variable con el nombre System.Debug y el valor true
  3. Guardar

P: ¿Qué variables están disponibles para mí?

A: $(Build.SourcesDirectory) y son solo algunas de las variables que puede usar en la $(Agent.BuildDirectory) canalización. Las variables están disponibles como expresiones o scripts.

Consulte Definición de variables,variables predefinidasy variables clásicas de versión y artefactos para obtener información sobre los distintos tipos de variables.

P: La tarea me permite publicar artefactos en el trabajo de implementación en la canalización yaml, pero ¿no puedo usarlos en la canalización de nivel inferior?

A. Los trabajos de implementación no tienen el contexto de las ramas de origen y, por tanto, no son adecuados para publicar artefactos. Se han diseñado principalmente para consumir artefactos. Una solución alternativa sería aislar esa lógica en un trabajo independiente (con dependencias en los trabajos de implementación).

¿Necesito un agente?

Necesita al menos un agente para ejecutar la compilación o versión.

Tengo problemas. ¿Cómo puedo solucionarlos?

Vea Solución de problemas de compilación y versión.

No se puede seleccionar un grupo de agentes predeterminado y no se puede poner en cola la compilación o versión. ¿Cómo puedo corregirlo?

Vea Grupos de agentes.

La tarea de envío de cambios de NuGet genera el error siguiente: "Error: no se puede obtener el certificado del emisor local". ¿Cómo lo puedo corregir?

Esto se puede corregir si se añade un certificado raíz de confianza. Puede agregar la variable de entorno NODE_EXTRA_CA_CERTS=file al agente de compilación, o bien la variable de tarea NODE.EXTRA.CA.CERTS=file en la canalización. Vea la documentación de Node.js para obtener más detalles sobre esta variable. Consulte Establecimiento de variables en una canalización para obtener instrucciones sobre cómo establecer una variable en la canalización.

Utilizo TFS en el entorno local y no veo algunas de estas características. ¿Por qué no?

Algunas de estas características solo están disponibles en Azure Pipelines y todavía no lo están en el entorno local. Algunas características están disponibles en el entorno local si ha actualizado a la versión más reciente de TFS.

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Use esta tarea para crear un archivo de archivo a partir de una carpeta de origen. Se admite una variedad de formatos de archivo estándar, incluidos .zip, .jar, .war, .ear, .tar, .7z, etc.

Peticiones

Ninguno

Fragmento de código YAML

# Archive files
# Compress files into .7z, .tar.gz, or .zip
- task: ArchiveFiles@2
  inputs:
    #rootFolderOrFile: '$(Build.BinariesDirectory)' 
    #includeRootFolder: true 
    #archiveType: 'zip' # Options: zip, 7z, tar, wim
    #tarCompression: 'gz' # Optional. Options: gz, bz2, xz, none
    #archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' 
    #replaceExistingArchive: true 
    #verbose: # Optional
    #quiet: # Optional

Argumentos