PublishBuildArtifacts@1 - Tâche Publier des artefacts de build v1

  • Article

Utilisez cette tâche dans un pipeline de build pour publier des artefacts de build sur Azure Pipelines, TFS ou un partage de fichiers.

Si vous utilisez Azure DevOps Services, nous vous recommandons d’utiliser Télécharger des artefacts de pipeline et Publier des artefacts de pipeline pour des performances plus rapides.

Utilisez cette tâche dans un pipeline de build pour publier des artefacts de build sur Azure Pipelines, TFS ou un partage de fichiers.

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.

# 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.
    #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
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options. 
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

# 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.
    #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
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.

# 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.
    #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.

# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a 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.
    #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.

Entrées

PathtoPublish - Chemin d’accès à la publication
string. Obligatoire. Valeur par défaut : $(Build.ArtifactStagingDirectory).

Spécifie le chemin d’accès au dossier ou au fichier à publier. Il peut s’agir d’un chemin d’accès complet ou d’un chemin d’accès relatif à la racine du référentiel. Les caractères génériques ne sont pas pris en charge. Les variables sont prises en charge. Exemple : $(Build.ArtifactStagingDirectory). Pour plus d’informations, consultez Artefacts dans les pipelines - vue d’ensemble.


ArtifactName - Nom de l’artefact
string. Obligatoire. Valeur par défaut : drop.

Spécifie le nom de l’artefact à créer dans l’emplacement de publication. Les caractères spéciaux suivants ne sont pas autorisés : +, %, , {}


publishLocation - Emplacement de publication de l’artefact
Alias d’entrée : ArtifactType. string. Obligatoire. Valeurs autorisées : Container (Azure Pipelines), FilePath (un partage de fichiers). Valeur par défaut : Container.

Spécifie s’il faut stocker l’artefact dans Azure Pipelines (conteneur) ou le copier dans un partage de fichiers (FilePath) qui doit être accessible à partir de l’agent de build. Pour plus d’informations, consultez Artefacts dans Azure Pipelines.


publishLocation - Emplacement de publication de l’artefact
Alias d’entrée : ArtifactType. string. Obligatoire. Valeurs autorisées : Container (Azure Pipelines/TFS), FilePath (un partage de fichiers). Valeur par défaut : Container.

Spécifie s’il faut stocker l’artefact dans Azure Pipelines (conteneur) ou le copier dans un partage de fichiers (FilePath) qui doit être accessible à partir de l’agent de build. Pour plus d’informations, consultez Artefacts dans Azure Pipelines.


MaxArtifactSize - Taille maximale de l’artefact
string. Valeur par défaut : 0.

Limite maximale de la taille des artefacts à publier en octets. Mettez 0 si vous ne souhaitez définir aucune limite.


TargetPath - Chemin du partage de fichiers
string. Nécessaire lorsque ArtifactType = FilePath.

Spécifie le chemin d’accès au partage de fichiers dans lequel vous souhaitez copier les fichiers. Le chemin d’accès doit être un chemin d’accès complet ou un chemin d’accès valide relatif au répertoire racine de votre référentiel. La publication d’artefacts à partir d’un agent Linux ou macOS sur un partage de fichiers n’est pas prise en charge. Exemple : \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).


Parallel - Copie parallèle
boolean. facultatif. Utilisez quand ArtifactType = FilePath. Valeur par défaut : false.

Spécifie s’il faut copier des fichiers en parallèle à l’aide de plusieurs threads pour un débit potentiel plus élevé. Si ce paramètre n’est pas activé, un thread unique est utilisé.


ParallelCount - Nombre parallèle
string. facultatif. Utilisez quand ArtifactType = FilePath && Parallel = true. Valeur par défaut : 8.

Spécifie le degré de parallélisme (le nombre de threads) utilisé pour effectuer la copie. La valeur doit être d’au moins 1 et d’au plus 128. Choisissez une valeur basée sur les fonctionnalités de l’UC de l’agent de build.


StoreAsTar - Tar de l’artefact avant le chargement
boolean. Valeur par défaut : false.

Ajoute tous les fichiers du chemin de publication à une archive tar avant le chargement. Cela vous permet de conserver les autorisations de fichier UNIX. Utilisez extractTars l’option de la tâcheDownloadBuildArtifacts pour extraire automatiquement les éléments téléchargés. Ce paramètre est ignoré sur les agents Windows.


FileCopyOptions - Options de copie de fichiers
string. facultatif. Utilisez quand ArtifactType = FilePath.

Transmet des options supplémentaires à la commande Robocopy. Par exemple, le modèle minimatch récursif **/*.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Notes

Vous ne pouvez pas utiliser Bin, App_Data et d’autres noms de dossiers réservés par IIS en tant que nom d’artefact, car ce contenu n’est pas destiné à être utilisé en réponse aux demandes Web. Veuillez consulter Structure du dossier de projets Web ASP.NET pour plus d’informations.

Exemples

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

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 1.91.0 ou version ultérieure
Catégorie de la tâche Utilitaire

Voir aussi