PublishBuildArtifacts@1: tarea Publicar artefactos de compilación v1

Use esta tarea en una canalización de compilación para publicar artefactos de compilación en Azure Pipelines, TFS o un recurso compartido de archivos.

Si usa Azure DevOps Services, se recomienda usar descargar artefactos de canalización y publicar artefactos de canalización para obtener un rendimiento más rápido.

Sintaxis

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #MaxArtifactSize: '0' # string. Max Artifact Size. Default: 0.
    #TargetPath: # string. Required when ArtifactType = FilePath. File share path. 
    #Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
    #ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
  # Advanced
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

Entradas

ruta de acceso de PathtoPublish - para publicar
string. Obligatorio. Valor predeterminado: $(Build.ArtifactStagingDirectory).

Especifica la ruta de acceso de carpeta o archivo que se va a publicar. Puede ser una ruta de acceso completa o una ruta de acceso relativa a la raíz del repositorio. No se admiten caracteres comodín. se admiten variables de. Ejemplo: $(Build.ArtifactStagingDirectory). Para obtener más información, consulte Artefactos en canalizaciones: información general.

ArtifactName - nombre del artefacto
string. Obligatorio. Valor predeterminado: drop.

Especifica el nombre del artefacto que se va a crear en la ubicación de publicación. No se permiten los siguientes caracteres especiales: +, %, {, }

publishLocation - ubicación de publicación de artefactos
Alias de entrada: ArtifactType. string. Obligatorio. Valores permitidos: Container (Azure Pipelines), FilePath (recurso compartido de archivos). Valor predeterminado: Container.

Especifica si se debe almacenar el artefacto en Azure Pipelines (contenedor) o copiarlo en un recurso compartido de archivos (FilePath) al que se debe tener acceso desde el agente de compilación. El alias de entrada: ArtifactType es un nombre alternativo para publishLocation y se puede usar indistintamente. Para más información, consulte Artifacts in Azure Pipelines.

MaxArtifactSize - tamaño máximo de artefacto
string. Valor predeterminado: 0.

Límite máximo en el tamaño de los artefactos que se van a publicar en bytes. Coloque 0 si no desea establecer ningún límite.

TargetPath - ruta de acceso del recurso compartido de archivos
string. Obligatorio cuando ArtifactType = FilePath.

Especifica la ruta de acceso al recurso compartido de archivos donde desea copiar los archivos. La ruta de acceso debe ser una ruta de acceso completa o una ruta de acceso válida en relación con el directorio raíz del repositorio. No se admite la publicación de artefactos desde un agente de Linux o macOS en un recurso compartido de archivos. Ejemplo: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - de copia en paralelo
boolean. Opcional. Use cuando ArtifactType = FilePath. Valor predeterminado: false.

Especifica si se van a copiar archivos en paralelo mediante varios subprocesos para un mayor rendimiento potencial. Si esta configuración no está habilitada, se usará un único subproceso.

ParallelCount - recuento paralelo
string. Opcional. Use cuando ArtifactType = FilePath && Parallel = true. Valor predeterminado: 8.

Especifica el grado de paralelismo (el número de subprocesos) usado para realizar la copia. El valor debe ser al menos 1 y no mayor que 128. Elija un valor basado en las funcionalidades de CPU del agente de compilación.

StoreAsTar - Tar del artefacto antes de cargar
boolean. Valor predeterminado: false.

Agrega todos los archivos de la ruta de acceso de publicación a un archivo tar antes de cargarlos. Esto le permite conservar los permisos de archivo UNIX. Use extractTars opción de la tareaDownloadBuildArtifacts para extraer automáticamente los elementos descargados. Esta configuración se omite en los agentes de Windows.

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

Nota:

No puede usar Bin, App_Data y otros nombres de carpeta reservados por IIS como un nombre de artefacto porque este contenido no se proporciona en respuesta a las solicitudes web. Consulte ASP.NET estructura de carpetas del proyecto web para obtener más detalles.

Ejemplos

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilació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	Cualquiera
variables settable	Cualquiera
Versión del agente	1.91.0 o superior
Categoría de tarea	Utilidad

Consulte también

• Referencia de patrones de coincidencia de archivos
• Uso de esta tarea para publicar artefactos
• Aprenda a usar de registros detallados de para solución de problemas de.