PublishBuildArtifacts@1 – Publikování úlohy artefaktů sestavení v1

Tuto úlohu použijte v kanálu buildu k publikování artefaktů sestavení do Azure Pipelines, TFS nebo sdílené složky.

Pokud používáte Azure DevOps Services, doporučujeme použít stažení artefaktů kanálu a publikování artefaktů kanálu pro zajištění rychlejšího výkonu.

Syntaxe

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

Vstupy

PathtoPublish - cesta k publikování
string. Povinné. Výchozí hodnota: $(Build.ArtifactStagingDirectory).

Určuje složku nebo cestu k souboru k publikování. Může to být plně kvalifikovaná cesta nebo cesta vzhledem ke kořenovému adresáři úložiště. Zástupné dokumentace nejsou podporovány. jsou podporovány proměnné. Příklad: $(Build.ArtifactStagingDirectory). Další informace najdete v tématu Artefakty v kanálech – přehled.

ArtifactName - název artefaktu
string. Povinné. Výchozí hodnota: drop.

Určuje název artefaktu, který se má vytvořit v umístění publikování. Nejsou povoleny následující speciální znaky: +, %, {, }

publishLocation - umístění publikování artefaktů
Vstupní alias: ArtifactType. string. Povinné. Povolené hodnoty: Container (Azure Pipelines), FilePath (sdílená složka A). Výchozí hodnota: Container.

Určuje, jestli se má artefakt uložit ve službě Azure Pipelines (kontejner), nebo ho zkopírovat do sdílené složky (FilePath), která musí být přístupná z agenta sestavení. Vstupní alias: ArtifactType je alternativním názvem publishLocation a dá se použít zaměnitelně. Další informace najdete v tématu Artefakty ve službě Azure Pipelines.

MaxArtifactSize - maximální velikost artefaktů
string. Výchozí hodnota: 0.

Maximální limit velikosti artefaktů, které se mají publikovat v bajtech. Pokud nechcete nastavit žádný limit, vložte hodnotu 0.

cesta ke sdílené složce TargetPath -
string. Požadováno při ArtifactType = FilePath.

Určuje cestu ke sdílené složce, do které chcete soubory zkopírovat. Cesta musí být plně kvalifikovaná nebo platná cesta vzhledem ke kořenovému adresáři úložiště. Publikování artefaktů z agenta Linuxu nebo macOS do sdílené složky se nepodporuje. Příklad: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - paralelní kopírování
boolean. Volitelný. Používá se při ArtifactType = FilePath. Výchozí hodnota: false.

Určuje, jestli se mají soubory kopírovat paralelně pomocí více vláken pro větší možnou propustnost. Pokud toto nastavení není povolené, použije se jedno vlákno.

ParallelCount - paralelní počet
string. Volitelný. Používá se při ArtifactType = FilePath && Parallel = true. Výchozí hodnota: 8.

Určuje stupeň paralelismu (počet vláken) použitý k provedení kopírování. Hodnota musí být alespoň 1 a nesmí být větší než 128. Zvolte hodnotu na základě možností procesoru agenta sestavení.

StoreAsTar - Tar artefakt před nahráním
boolean. Výchozí hodnota: false.

Před nahráním přidá všechny soubory z cesty publikování do archivu tar. To vám umožní zachovat oprávnění k souborům systému UNIX. Použijte extractTars možnostDownloadBuildArtifacts úkol extrahovat stažené položky automaticky. Toto nastavení je u agentů windows ignorováno.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

Poznámka:

Nelze použít bin, App_Data a jiné názvy složek rezervované službou IIS jako název artefaktu, protože tento obsah není obsluhován v reakci na webové požadavky. Další podrobnosti najdete v ASP.NET struktuře složek webového projektu.

Příklady

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení
Běží na	Agent, DeploymentGroup
požadavky	Žádný
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	1.91.0 nebo vyšší
Kategorie úkolu	Užitnost

Viz také

• Referenční informace ke vzorům porovnávání souborů
• Jak tuto úlohu používám k publikování artefaktů
• Naučte se používat podrobné protokoly pro řešení potíží.