Condividi tramite


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.

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

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.
# 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.
    #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
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options. 
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.
# 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.
    #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
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
# 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.
    #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.
# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a 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.
    #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.

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.


publishLocation - Percorso di pubblicazione degli artefatti
Alias di input: ArtifactType. string. Obbligatorio. Valori consentiti: Container (Azure Pipelines/TFS), 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.


FileCopyOptions - Opzioni di copia file
string. facoltativo. Usare quando ArtifactType = FilePath.

Passa altre opzioni al comando Robocopy. Ad esempio, il modello **/*di minimatch ricorsivo .


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