JenkinsDownloadArtifacts@1 - Tâche De téléchargement d’artefacts jenkins v1
Utilisez cette tâche pour télécharger les artefacts produits par un travail Jenkins.
Syntax
# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
inputs:
jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection.
jobName: # string. Required. Job name.
#jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type.
saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
# Advanced
jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
#jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
#itemPattern: '**' # string. Item Pattern. Default: **.
#downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
#startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from.
#artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName.
# Propagated Artifacts
#propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
#artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
#ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription.
#storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name.
#containerName: # string. Required when propagatedArtifacts == true. Container Name.
#commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.
# Jenkins Download Artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
inputs:
jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection.
jobName: # string. Required. Job name.
#jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type.
saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
# Advanced
jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
#jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
#itemPattern: '**' # string. Item Pattern. Default: **.
#downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
#startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from.
#artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName.
# Propagated Artifacts
#propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
#artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
#ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription.
#storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name.
#containerName: # string. Required when propagatedArtifacts == true. Container Name.
#commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.
Entrées
jenkinsServerConnection
- Connexion au service Jenkins
Alias d’entrée : serverEndpoint
. string
. Obligatoire.
Spécifie la connexion de service pour votre instance Jenkins. Pour créer une connexion de service, cliquez sur le lien Gérer.
jobName
- Nom du travail
string
. Obligatoire.
Spécifie le nom du travail Jenkins à partir duquel télécharger les artefacts. Il doit correspondre exactement au nom du travail sur le serveur Jenkins.
jenkinsJobType
- Type de travail Jenkins
string
. facultatif. Utilisez quand jobName = invalidjobName
.
Spécifie automatiquement le type de travail Jenkins.
saveTo
- Enregistrer dans
string
. Obligatoire. Valeur par défaut : jenkinsArtifacts
.
Spécifie le répertoire dans lequel les artefacts Jenkins sont téléchargés et enregistrés. Ce répertoire est créé s’il n’existe pas.
jenkinsBuild
- Télécharger les artefacts produits par
string
. Obligatoire. Valeurs autorisées : LastSuccessfulBuild
(Dernière build réussie), BuildNumber
(Numéro de build). Valeur par défaut : LastSuccessfulBuild
.
Télécharge les artefacts produits par la dernière build réussie ou à partir d’un instance de build spécifique.
jenkinsBuildNumber
- Numéro de build Jenkins
string
. Nécessaire lorsque jenkinsBuild == BuildNumber
. Valeur par défaut : 1
.
Télécharge les artefacts produits par cette build.
itemPattern
- Modèle d’élément
string
. Valeur par défaut : **
.
Spécifie les fichiers à télécharger en tant que modèle de mini-correspondance multiligne. Plus d’informations sur les modèles de correspondance de fichiers.
Le modèle **
par défaut télécharge tous les fichiers sur tous les artefacts produits par le travail Jenkins. Pour télécharger tous les fichiers dans la suppression de l’artefact, utilisez drop/**
.
downloadCommitsAndWorkItems
- Télécharger les commits et les éléments de travail
boolean
. Valeur par défaut : false
.
Permet de télécharger les commits et les détails de l’élément de travail associés au travail Jenkins.
startJenkinsBuildNumber
- Télécharger des commits et des éléments de travail à partir de
string
. facultatif. Utilisez quand downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber
.
Démarre le numéro de build pour le téléchargement des commits et des éléments de travail. S’ils sont fournis, tous les commits et les éléments de travail entre le numéro de build de début et le numéro de build donné comme entrée pour télécharger les artefacts sont téléchargés.
artifactDetailsFileNameSuffix
- Commit et WorkItem FileName
string
. facultatif. Utilisez quand downloadCommitsAndWorkItems == invalid
.
Spécifie le suffixe de nom de fichier pour les commits et les pièces jointes d’éléments de travail. Les pièces jointes sont créées avec commits_{suffix}.json
et workitem_{suffix}.json
. Si cette entrée n’est pas fournie, les pièces jointes sont créées avec les noms commits.json
et workitems.json
.
propagatedArtifacts
- Les artefacts sont propagés vers Azure
boolean
. Valeur par défaut : false
.
Utilisez cette entrée si des artefacts Jenkins ont été propagés vers Azure. Pour charger des artefacts Jenkins sur Azure, reportez-vous à ce plug-in Jenkins.
artifactProvider
- Fournisseur d’artefacts
string
. Nécessaire lorsque propagatedArtifacts == notValid
. Valeurs autorisées : azureStorage
(Stockage Azure). Valeur par défaut : azureStorage
.
Spécifie le fournisseur de stockage externe utilisé dans le travail Jenkins pour charger les artefacts.
ConnectedServiceNameARM
- Abonnement Azure
string
. Nécessaire lorsque propagatedArtifacts == true
.
Spécifie l’abonnement Azure Resource Manager pour les artefacts.
storageAccountName
- Nom du compte de stockage
string
. Nécessaire lorsque propagatedArtifacts == true
.
Spécifie les comptes de stockage Azure Classic ou Resource Manager. Sélectionnez le nom du compte de stockage dans lequel les artefacts sont propagés.
containerName
- Nom du conteneur
string
. Nécessaire lorsque propagatedArtifacts == true
.
Spécifie le nom du conteneur dans le compte de stockage où les artefacts sont chargés.
commonVirtualPath
- Chemin d’accès virtuel commun
string
. facultatif. Utilisez quand propagatedArtifacts == true
.
Spécifie le chemin d’accès aux artefacts à l’intérieur du conteneur de stockage Azure.
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
Utilisez cette tâche pour télécharger les artefacts produits par un travail Jenkins.
Configuration requise
Condition requise | Description |
---|---|
Types de pipelines | YAML, build classique, version 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 | 2.144.0 ou version ultérieure |
Catégorie de la tâche | Utilitaire |
Condition requise | Description |
---|---|
Types de pipelines | YAML, build classique, version 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 commande | Quelconque |
Variables paramétrables | Quelconque |
Version de l’agent | Toutes les versions d’agent prises en charge. |
Catégorie de la tâche | Utilitaire |