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

  • Článek

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

Pokud používáte Azure DevOps Services, pro zajištění vyššího výkonu doporučujeme použít možnost Stáhnout artefakty kanálu a Publikovat artefakty kanálu.

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

Syntax

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

Vstupy

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

Určuje cestu ke složce nebo souboru, které se mají publikovat. Může se jednat o plně kvalifikovanou cestu nebo cestu relativní ke kořenovému adresáři úložiště. Zástupné znaky se nepodporují. Podporují se proměnné . Příklad: $(Build.ArtifactStagingDirectory). Další informace najdete v tématu Artefakty v kanálech – přehled.


ArtifactName - Název artefaktu
string. Povinná hodnota. 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ů
Alias vstupu: ArtifactType. string. Povinná hodnota. Povolené hodnoty: Container (Azure Pipelines) FilePath (sdílená složka). Výchozí hodnota: Container.

Určuje, jestli se má artefakt uložit v Azure Pipelines (kontejner), nebo jestli ho chcete zkopírovat do sdílené složky (FilePath), která musí být přístupná z agenta sestavení. Další informace najdete v tématu Artefakty v Azure Pipelines.


publishLocation - Umístění publikování artefaktů
Alias vstupu: ArtifactType. string. Povinná hodnota. Povolené hodnoty: Container (Azure Pipelines/TFS), FilePath (sdílená složka). Výchozí hodnota: Container.

Určuje, jestli se má artefakt uložit v Azure Pipelines (kontejner), nebo jestli ho chcete zkopírovat do sdílené složky (FilePath), která musí být přístupná z agenta sestavení. Další informace najdete v tématu Artefakty v Azure Pipelines.


MaxArtifactSize - Maximální velikost artefaktu
string. Výchozí hodnota: 0.

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


TargetPath - Cesta ke sdílené složce
string. Vyžaduje se, když 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 vašeho úložiště. Publikování artefaktů z agenta pro Linux nebo macOS do sdílené složky se nepodporuje. Příklad: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).


Parallel - Paralelní kopírování
boolean. Nepovinný parametr. Použijte, když ArtifactType = FilePath. Výchozí hodnota: false.

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


ParallelCount - Počet paralelních procesů
string. Nepovinný parametr. Použijte, když 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 - Před nahráním artefaktu dehtujte
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. Pomocí extractTars možnosti úlohyDownloadBuildArtifacts extrahujte stažené položky automaticky. Toto nastavení je ignorováno u agentů systému Windows.


FileCopyOptions - Možnosti kopírování souborů
string. Nepovinný parametr. Použijte, když ArtifactType = FilePath.

Předá příkaz Robocopy další možnosti. Například rekurzivní minimatch vzor **/*.


Možnosti ovládání úloh

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

Výstupní proměnné

Žádné

Poznámky

Poznámka

Názvy složek bin,App_Data a dalších složek rezervovaných službou IIS nelze použít jako název artefaktu, protože tento obsah není obsluhován jako odpověď na webové požadavky. Další podrobnosti najdete v tématu struktura složek webového projektu ASP.NET .

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ý build
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ů Všechny
Nastavitelné proměnné Všechny
Verze agenta 1.91.0 nebo vyšší
Kategorie úloh Nástroj

Viz také