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: 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: 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

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.

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ů Windows, což způsobí ztrátu všech systém UNIX oprávnění, 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ém 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ů