PublishBuildArtifacts@1 - Pubblicare gli artefatti di compilazione v1

Usare questa attività in una pipeline di compilazione per pubblicare elementi di compilazione in Azure Pipelines, TFS o una condivisione file.

Se si usa Azure DevOps Services, è consigliabile usare Download Pipeline Artifacts e Publish Pipeline Artifacts per ottenere prestazioni più veloci.

Sintassi

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

Ingressi dati

PathtoPublish - Percorso di pubblicazione
string. Obbligatorio. Valore predefinito: $(Build.ArtifactStagingDirectory)

Specifica il percorso della cartella o del file da pubblicare. Può trattarsi di un percorso completo o di un percorso relativo alla radice del repository. I caratteri jolly non sono supportati. sono supportate variabili. Esempio: $(Build.ArtifactStagingDirectory). Per altre informazioni, vedere Artifacts in pipelines - Overview.

ArtifactName - nome artefatto
string. Obbligatorio. Valore predefinito: drop

Specifica il nome dell'artefatto da creare nel percorso di pubblicazione. Non sono consentiti i caratteri speciali seguenti: +, %, {, }

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

Specifica se archiviare l'artefatto in Azure Pipelines (contenitore) o copiarlo in una condivisione file (FilePath) accessibile dall'agente di compilazione. Alias di input: ArtifactType è un nome alternativo per publishLocation e può essere usato in modo intercambiabile. Per altre informazioni, vedere Artefatti in Azure Pipelines.

MaxArtifactSize - max artifact size
string. Valore predefinito: 0

Limite massimo per le dimensioni degli artefatti da pubblicare in byte. Inserisci 0 se non vuoi impostare alcun limite.

TargetPath - percorso condivisione file
string. Obbligatorio quando ArtifactType = FilePath.

Specifica il percorso della condivisione file in cui si desidera copiare i file. Il percorso deve essere un percorso completo o un percorso valido relativo alla directory radice del repository. La pubblicazione di elementi da un agente Linux o macOS in una condivisione file non è supportata. Esempio: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

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 singolo thread.

conteggio parallelo ParallelCount -
string. Opzionale. Usare quando ArtifactType = FilePath && Parallel = true. Valore predefinito: 8

Specifica il grado di parallelismo (il numero di thread) utilizzato per eseguire la copia. Il valore deve essere almeno 1 e non maggiore di 128. Scegliere un valore in base alle funzionalità della CPU dell'agente di compilazione.

StoreAsTar - tar dell'artefatto prima di caricare
boolean. Valore predefinito: false

Aggiunge tutti i file dal percorso di pubblicazione a un archivio tar prima del caricamento. In questo modo è possibile mantenere le autorizzazioni per i file UNIX. Usare extractTars opzione dell'attivitàDownloadBuildArtifacts per estrarre automaticamente gli elementi scaricati. Questa impostazione viene ignorata sugli agenti Windows.

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:

Nota

Non è possibile usare Bin, App_Data e altri nomi di cartelle riservati da IIS come nome artefatto perché questo contenuto non viene fornito in risposta alle richieste Web. Per altri dettagli, vedere ASP.NET struttura di cartelle del progetto Web.

Esempi

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

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build 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	1.91.0 o versione successiva
Categoria attività	Utilità

Vedere anche

• Informazioni di riferimento per i criteri di corrispondenza dei file
• Come usare questa attività per pubblicare elementi
• Informazioni su come usare log dettagliati per la risoluzione dei problemi .