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 descargar artefactos de canalización y publicar artefactos de canalización para un rendimiento más rápido.

Syntax

# 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

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

Especifica la ruta de acceso de la carpeta o del 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. Ejemplo: $(Build.ArtifactStagingDirectory). Para 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 acceder desde el agente de compilación. Para obtener más información, consulte Artefactos en Azure Pipelines.

MaxArtifactSize - Tamaño máximo del 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. Necesario 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 - Copia paralela
boolean. Opcional. Use cuando ArtifactType = FilePath. Valor predeterminado: false.

Especifica si se van a copiar archivos en paralelo mediante varios subprocesos para obtener 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) utilizado 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 el 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 la 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 las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Nota:

No puede usar Bin, App_Data y otros nombres de carpeta reservados por IIS como nombre de artefacto porque este contenido no se atiende en respuesta a las solicitudes web. Consulte Estructura de carpetas de proyecto web de ASP.NET para más información.

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
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	1.91.0 o superior
Categoría de la tarea:	Utilidad

Consulte también

• Referencia de patrones de coincidencia de archivos
• Cómo usar esta tarea para publicar artefactos
• Aprenda a usar registros detallados para solucionar problemas.