PublishPipelineArtifact@1 - Attività Pubblica artefatti pipeline 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.

Input

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 Artefatti 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'elemento non può contenere \, /", :, <, >, |, *o ?.

publishLocation - Percorso di pubblicazione 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. 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 - Copia parallela
boolean. facoltativo. 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.

parallelCount - Conteggio parallelo
string. facoltativo. 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 delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input 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 artefatti di compilazione se si usa Azure DevOps Server o TFS 2018. Se lo 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 publish parole chiave e download sono collegamenti per le attività PublishPipelineArtifact@1 e DownloadPipelineArtifact@2. Per altri dettagli, vedere steps.publish e steps.download .

Suggerimento

È possibile usare il file con estensione 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 l'utente corrente?

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

Per informazioni sui diversi tipi di variabili, vedere Definire variabili, variabili predefinitee variabili di rilascio e artefatti classici.

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

R: I processi di distribuzione non hanno il contesto dei rami di origine e pertanto non sono appropriati per la pubblicazione di elementi. 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
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.199.0 o versione successiva
Categoria attività	Utilità

Vedi anche

• Cercare di iniziare a usare gli artefatti di compilazione? Vedere Artefatti in Azure Pipelines.