Publikování a stažení artefaktů sestavení

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Poznámka:

Pro zajištění rychlejšího výkonu doporučujeme použít stažení artefaktů kanálu a publikování artefaktů kanálu.

Azure Artifacts umožňuje týmům používat informační kanály a upstreamové zdroje ke správě jejich závislostí. Azure Pipelines můžete použít k publikování a stahování různých typů artefaktů v rámci pracovního postupu CI/CD.

Publikování artefaktů

Artefakty je možné publikovat v libovolné fázi kanálu. K publikování balíčků můžete použít YAML nebo klasický editor Azure DevOps.

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '**/$(BuildConfiguration)/**/?(*.exe|*.dll|*.pdb)'
    targetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop

• pathToPublish: cesta k artefaktu. Může to být absolutní nebo relativní cesta. Zástupné kóty nejsou podporované.
• artifactName: název artefaktu.

Poznámka:

Při publikování artefaktu se ujistěte, že nepoužíváte jeden z názvů rezervovaných složek. Další podrobnosti najdete v tématu Složky aplikací.

Klasické

Přidejte do kanálu úlohu Publikovat artefakty sestavení a vyplňte požadovaná pole. Ujistěte se, že je soubor v kořenovém adresáři úložiště.

Příklad: Použití více úkolů

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '**/$(BuildConfiguration)/**/?(*.exe|*.dll|*.pdb)'
    targetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop1
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop2

• pathToPublish: cesta k artefaktu. Může to být absolutní nebo relativní cesta. Zástupné kóty nejsou podporované.
• artifactName: název artefaktu.

Klasické

Do kanálů můžete přidat více úloh Publikovat artefakty sestavení. Ujistěte se, že je soubor v kořenovém adresáři úložiště.

Příklad: Kopírování a publikování binárních souborů

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '**/$(BuildConfiguration)/**/?(*.exe|*.dll|*.pdb)'
    targetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop

• sourceFolder: složka obsahující soubory, které chcete kopírovat. Pokud necháte toto prázdné, kopírování se provede z $(Build.SourcesDirectory).
• obsah: Cesty k souborům, které se mají zahrnout jako součást kopie.
• targetFolder: cílová složka.
• pathToPublish: složka nebo cesta k souboru k publikování. Může to být absolutní nebo relativní cesta. Zástupné kóty nejsou podporované.
• artifactName: název artefaktu, který chcete vytvořit.

Poznámka:

Ujistěte se, že nepoužíváte vyhrazený název pro artifactName, jako je bin nebo App_Data. Další podrobnosti najdete v tématu ASP.NET Struktura složek webového projektu.

Klasické

Nástroj: Kopírování souborů

• Zdrojová složka: $(Build.SourcesDirectory)

• Obsah: /$(BuildConfiguration)//? (.exe|. dll|*.pdb)

• Cílová složka: $(Build.ArtifactStagingDirectory)

Nástroj: Publikování artefaktů sestavení

• Cesta k publikování: $(Build.ArtifactStagingDirectory)

• Název artefaktu: drop

Poznámka:

Build.ArtifactStagingDirectory cesta se po každém sestavení vyčistí. Pokud k publikování artefaktu používáte tuto cestu, před krokem publikování nezapomeňte zkopírovat obsah, který chcete publikovat do tohoto adresáře.

Stažení artefaktů

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: DownloadBuildArtifacts@0
  inputs:
    buildType: 'current'
    downloadType: 'single'
    artifactName: 'drop'
    downloadPath: '$(System.ArtifactsDirectory)'

• buildType: Určete, které artefakty sestavení se stáhnou: current (výchozí hodnota) nebo z konkrétního sestavení.
• downloadType: Zvolte, jestli chcete stáhnout jeden artefakt nebo všechny artefakty konkrétního sestavení.
• artifactName: název artefaktu, který se stáhne.
• downloadPath: cesta na počítači agenta, kde se stáhnou artefakty.

Klasické

Nástroj: Stažení artefaktů sestavení

• Stažení artefaktů vytvořených: Aktuální sestavení

• Typ stahování: Konkrétní artefakt

• Název artefaktu: drop

• Cílový adresář: $(System.ArtifactsDirectory)

Poznámka:

Pokud používáte úlohu nasazení, můžete odkazovat na artefakty sestavení pomocí $(Agent.BuildDirectory). Další podrobnosti najdete v tématu Proměnné agenta.

Po dokončení spuštění kanálu přejděte do části Souhrn a prozkoumejte nebo stáhněte artefakt.

Stažení konkrétního artefaktu

YAML

steps:
- task: DownloadBuildArtifacts@1
  displayName: 'Download Build Artifacts'
  inputs:
    buildType: specific
    project: 'xxxxxxxxxx-xxxx-xxxx-xxxxxxxxxxx'
    pipeline: 20
    buildVersionToDownload: specific
    buildId: 128
    artifactName: drop
    extractTars: false

Klasické

Přidejte úlohu Stažení artefaktů sestavení do definice kanálu a nakonfigurujte ji následujícím způsobem:

• Stáhněte artefakty vytvořené pomocí: Konkrétní sestavení.

• Projekt: V rozevírací nabídce vyberte projekt.

• Kanál buildu: Vyberte kanál buildu.

• Verze buildu ke stažení: vyberte konkrétní verzi.

• Sestavení: V rozevírací nabídce vyberte sestavení.

• Typ stahování: konkrétní artefakt.

• Název artefaktu: Vyberte artefakt z rozevírací nabídky.

• Cílový adresář: výchozí $(System.ArtifactsDirectory).

Tipy

• Pokud k povolení ověřování pomocí osobního přístupového tokenu používáte Azure DevOps Server, zakažte základní ověřování služby IIS. Další podrobnosti najdete v tématu Základní ověřování a paty služby IIS.

• V argumentech cesty k souboru použijte lomítka. V agentech macOS/Linux nefungují zpětná lomítka.

• Artefakty sestavení jsou uloženy v systému souborů Systému Windows, což způsobí ztrátu všech oprávnění systému UNIX, včetně spouštěcí bit. Po stažení artefaktů ze služby Azure Pipelines možná budete muset obnovit správná oprávnění systému UNIX.

• Build.ArtifactStagingDirectory a Build.StagingDirectory jsou zaměnitelné.

• Build.ArtifactStagingDirectory cesta se po každém sestavení vyčistí.

• Odstranění sestavení přidruženého k balíčkům publikovaným ve sdílené složce způsobí odstranění všech artefaktů v této cestě UNC.

• Pokud balíčky publikujete do sdílené složky, ujistěte se, že poskytujete přístup k agentovi sestavení.

• Pokud vaše organizace používá bránu firewall, ujistěte se, že povolujete adresy URL a IP adresy domény Azure Artifacts.

Související články

• Publikování a stahování artefaktů ve službě Azure Pipelines
• Definování klasického kanálu s více fázemi
• Jak zmírnit riziko při používání informačních kanálů privátních balíčků