PublishPipelineArtifact@1 - Publier des artefacts de pipeline v1

Utilisez cette tâche pour publier (charger) un fichier ou un répertoire en tant qu’artefact nommé pour l’exécution actuelle.

Syntaxe

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # 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.
    #properties: # string. Custom properties.

Entrées

targetPath - chemin d’accès au fichier ou au répertoire
Alias d’entrée : path. string. Obligatoire. Valeur par défaut : $(Pipeline.Workspace).

Spécifie le chemin d’accès du fichier ou du répertoire à publier. Peut être absolu ou relatif au répertoire de travail par défaut. Peut inclure variables, mais les caractères génériques ne sont pas pris en charge. Pour plus d’informations, consultez Artefacts dans Azure Pipelines.

nom d’artefact artifact -
Alias d’entrée : artifactName. string.

Spécifie le nom de l’artefact à publier. Il peut s’agir de n’importe quel nom que vous choisissez, par exemple drop. S’il n’est pas défini, la valeur par défaut est un ID unique limité au travail.

Important

Le nom de l’artefact ne peut pas contenir \, /, ", :, <, >, |, *ou ?.

publishLocation - l’emplacement de publication de l’artefact
Alias d’entrée : artifactType. string. Obligatoire. Valeurs autorisées : pipeline (Azure Pipelines), filepath (partage de fichiers A). Valeur par défaut : pipeline.

Spécifie s’il faut stocker l’artefact dans Azure Pipelines ou le copier dans un partage de fichiers qui doit être accessible à partir de l’agent de pipeline.

fileSharePath - chemin d’accès au partage de fichiers
string. Obligatoire lorsque artifactType = filepath.

Spécifie le partage de fichiers dans lequel les fichiers d’artefact sont copiés. Cela peut inclure des variables, par exemple \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). La publication d’artefacts à partir d’un agent Linux ou macOS sur un partage de fichiers n’est pas prise en charge, par exemple \\server\folderName.

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 est 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, ou le nombre de threads utilisés, pour effectuer la copie. La valeur doit être comprise entre 1 et 128.

properties - propriétés personnalisées
string.

Spécifie les propriétés personnalisées à associer à l’artefact. Utilisez une chaîne JSON valide avec le préfixe user- sur toutes les clés.

Options de contrôle de tâche

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

Variables de sortie

Aucun.

Remarques

La publication n’est pas prise en charge dans les pipelines de mise en production classiques.

Remarque

La publication d’artefacts de pipeline n’est pas prise en charge localement. Utilisez publier des artefacts de build si vous utilisez Azure DevOps Server ou TFS 2018. Si vous l’utilisez sur Azure DevOps Server, vous recevrez un message d’erreur similaire à Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

Les mots clés publish et download sont des raccourcis pour les tâches PublishPipelineArtifact@1 et DownloadPipelineArtifact@2. Pour plus d’informations, consultez steps.publish et steps.download.

Conseil / Astuce

Vous pouvez utiliser le fichier .artifactignore pour contrôler les fichiers qui seront publiés.

J’ai des problèmes avec la publication de mes artefacts. Comment puis-je afficher les journaux détaillés ?

Pour activer les journaux détaillés de votre pipeline :

1. Modifiez votre pipeline et sélectionnez Variables
2. Ajoutez une nouvelle variable avec le nom System.Debug et la valeur true
3. Sauvegarder

Quelles variables sont disponibles pour moi ?

R : $(Build.SourcesDirectory) et $(Agent.BuildDirectory) ne sont que quelques-unes des variables que vous pouvez utiliser dans votre pipeline. Les variables sont disponibles sous forme d’expressions ou de scripts.

Consultez Définir des variables, variables prédéfinies, et variables de version classique et d’artefacts pour en savoir plus sur les différents types de variables.

La tâche me permet de publier des artefacts dans le travail de déploiement dans le pipeline yaml, mais je ne suis pas en mesure de l’utiliser dans le pipeline en aval ?

R : Les travaux de déploiement n’ont pas le contexte des branches sources et ne sont donc pas appropriés pour la publication d’artefacts. Ils ont été principalement conçus pour consommer des artefacts. Une solution de contournement consiste à isoler cette logique dans un travail distinct (avec des dépendances sur vos travaux de déploiement).

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, Build Classique, Version 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	2.199.0 ou version ultérieure
Catégorie de tâche	Utilité

Voir aussi

• Vous cherchez à bien démarrer avec les artefacts de build ? (cf. Artefacts dans Azure Pipelines).