PublishBuildArtifacts@1 - Pubblicare elementi di compilazione v1 attività

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 Scarica artefatti della pipeline e Pubblica artefattidella pipeline per 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.

Input

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

Specifica il percorso della cartella o del file da pubblicare. Questo può essere un percorso completo o un percorso relativo alla radice del repository. I caratteri jolly non sono supportati. Le variabili sono supportate. Esempio: $(Build.ArtifactStagingDirectory). Per altre informazioni, vedere Artefatti nelle pipeline - panoramica.

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

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

publishLocation - Percorso di pubblicazione degli artefatti
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. Per altre informazioni, vedere Artefatti in Azure Pipelines.

MaxArtifactSize - Dimensioni massime dell'artefatto
string. Valore predefinito: 0.

Limite massimo per le dimensioni degli artefatti da pubblicare in byte. Inserire 0 se non si vuole 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 a una condivisione file non è supportata. Esempio: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

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

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

Specifica il grado di parallelismo (numero di thread) usati 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 del caricamento
boolean. Valore predefinito: false.

Aggiunge tutti i file dal percorso di pubblicazione a un archivio tar prima del caricamento. Ciò consente di mantenere le autorizzazioni di file UNIX. Usare extractTars l'opzione dell'attivitàDownloadBuildArtifacts per estrarre automaticamente gli elementi scaricati. Questa impostazione viene ignorata sugli agenti Di 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 servito in risposta alle richieste Web. Per altre informazioni, vedere ASP.NET Struttura cartella progetto Web .

Esempio

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
Esecuzione 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	1.91.0 o versione successiva
Categoria attività	Utilità

Vedi anche

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