PublishPipelineArtifact@1 - Attività Publish Pipeline Artifacts v1

Usare questa attività per pubblicare (caricare) un file o una directory come artefatto denominato per l'esecuzione corrente.

Sintassi

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

Ingressi dati

targetPath - percorso file o directory
Alias di input: path. string. Obbligatorio. Valore predefinito: $(Pipeline.Workspace)

Specifica il percorso del file o della directory da pubblicare. Può essere assoluto o relativo alla directory di lavoro predefinita. Può includere variabili , ma i caratteri jolly non sono supportati. Per altre informazioni, vedere Artifacts in Azure Pipelines.

artifact - nome artefatto
Alias di input: artifactName. string.

Specifica il nome dell'artefatto da pubblicare. Può essere qualsiasi nome scelto, ad esempio drop. Se non è impostato, il valore predefinito è un ID univoco con ambito per il processo.

Importante

Il nome dell'artefatto non può contenere \, /, ", :, <, >, |, *o ?.

publishLocation - percorso di pubblicazione dell'artefatto
Alias di input: artifactType. string. Obbligatorio. Valori consentiti: pipeline (Azure Pipelines), filepath (condivisione file). Valore predefinito: pipeline

Specifica se archiviare l'artefatto in Azure Pipelines o copiarlo in una condivisione file che deve essere accessibile dall'agente della pipeline.

fileSharePath - percorso condivisione file
string. Obbligatorio quando artifactType = filepath.

Specifica la condivisione file in cui vengono copiati i file degli artefatti. Ciò può includere variabili, ad esempio \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). La pubblicazione di elementi da un agente Linux o macOS in una condivisione file non è supportata, ad esempio \\server\folderName.

parallel - di copia parallela
boolean. Opzionale. Usare quando artifactType = filepath. Valore predefinito: false

Specifica se copiare i file in parallelo usando più thread per una maggiore velocità effettiva potenziale. Se questa impostazione non è abilitata, verrà usato un thread.

conteggio parallelo parallelCount -
string. Opzionale. Usare quando artifactType = filepath && parallel = true. Valore predefinito: 8

Specifica il grado di parallelismo, o il numero di thread utilizzati, per eseguire la copia. Il valore deve essere compreso tra 1 e 128.

properties - proprietà personalizzate
string.

Specifica le proprietà personalizzate da associare all'artefatto. Usare una stringa JSON valida con il prefisso user- in tutte le chiavi.

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

La pubblicazione non è supportata nelle pipeline di versione classica.

Nota

Gli artefatti della pipeline di pubblicazione non sono supportati in locale. Usare Pubblica elementi di compilazione se si usa Azure DevOps Server o TFS 2018. Se si usa in Azure DevOps Server, verrà visualizzato un messaggio di errore simile a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

Le parole chiave publish e download sono collegamenti per le attività di PublishPipelineArtifact@1 e DownloadPipelineArtifact@2. Per altre informazioni, vedere steps.publish e steps.download.

Suggerimento

È possibile usare il file artifactignore per controllare quali file verranno pubblicati.

Si verificano problemi con la pubblicazione degli artefatti. Come è possibile visualizzare i log dettagliati?

Per abilitare i log dettagliati per la pipeline:

1. Modificare la pipeline e selezionare Variabili
2. Aggiungere una nuova variabile con il nome System.Debug e il valore true
3. Salva

Quali variabili sono disponibili per me?

R: $(Build.SourcesDirectory) e $(Agent.BuildDirectory) sono solo poche delle variabili che è possibile usare nella pipeline. Le variabili sono disponibili come espressioni o script.

Vedere Definire variabili, variabili predefinitee variabili di rilascio e artefatti classici per informazioni sui diversi tipi di variabili.

L'attività consente di pubblicare elementi nel processo di distribuzione nella pipeline yaml, ma non è possibile usarli nella pipeline downstream?

R: I processi di distribuzione non hanno il contesto dei rami di origine e quindi non sono appropriati per la pubblicazione degli artefatti. Sono stati progettati principalmente per utilizzare gli artefatti. Una soluzione alternativa consiste nell'isolare tale logica in un processo separato (con dipendenze dai processi di distribuzione).

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	2.199.0 o versione successiva
Categoria attività	Utilità

Vedere anche

• Per iniziare a usare gli artefatti di compilazione, Vedere Artefatti in Azure Pipelines.