PublishBuildArtifacts@1 - Publier des artefacts de build v1

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 les artefacts de pipeline et publier des artefacts de pipeline pour accélérer les performances.

Syntaxe

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

Entrées

chemin d’accès PathtoPublish - de publication de
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 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. variables sont prises en charge. Exemple : $(Build.ArtifactStagingDirectory). Pour plus d’informations, consultez Artefacts dans les pipelines - vue d’ensemble.

nom d’artefact ArtifactName -
string. Obligatoire. Valeur par défaut : drop.

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

publishLocation - l’emplacement de publication de l’artefact
Alias d’entrée : ArtifactType. string. Obligatoire. Valeurs autorisées : Container (Azure Pipelines), FilePath (partage de fichiers A). 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. L’alias d’entrée : ArtifactType est un autre nom pour publishLocation et peut être utilisé de manière interchangeable. 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. 0 si vous ne souhaitez pas définir de limite.

TargetPath - chemin d’accès au partage de fichiers
string. Obligatoire lorsque ArtifactType = FilePath.

Spécifie le chemin d’accès au partage de fichiers dans lequel vous souhaitez copier les fichiers. Le chemin doit être un chemin complet ou un chemin valide par rapport 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 - de copie parallèle
boolean. Optionnel. 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 sera utilisé.

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

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

StoreAsTar - Tar l’artefact avant de charger
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 option de la tâcheDownloadBuildArtifacts pour extraire automatiquement les éléments téléchargés. Ce paramètre est ignoré sur les agents Windows.

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.

Remarques

Remarque

Vous ne pouvez pas utiliser bin, App_Data et d’autres noms de dossiers réservés par IIS comme nom d’artefact, car ce contenu n’est pas servi en réponse aux demandes web. Pour plus d’informations, consultez ASP.NET structure de dossiers de projet web.

Exemples

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

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, build classique
Exécutions sur	Agent, DeploymentGroup
demandes	Aucun
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	N'importe quel
variables settables	N'importe quel
Version de l’agent	1.91.0 ou version ultérieure
Catégorie de tâche	Utilité

Voir aussi

• Informations de référence sur les modèles de correspondance de fichiers
• Comment utiliser cette tâche pour publier des artefacts
• Découvrez comment utiliser journaux détaillés pour résolution des problèmes.