Publicar e baixar pacotes universais com o Azure Pipelines

Para publicar um Pacote Universal no feed de Artefatos do Azure, adicione a seguinte tarefa ao arquivo YAML do pipeline.

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    packagePublishDescription: '<Package description>'

Para publicar pacotes em um feed de Artefatos do Azure a partir do seu pipeline, a identidade do pipeline deve ter a função de Publicador de Feed (Colaborador) no feed. Para obter mais informações, consulte Permissões de pipelines.

Para publicar em um feed externo, você deve primeiro criar uma conexão de serviço para autenticar com seu feed. Para obter mais informações, consulte Gerenciar conexão de serviço.

Para publicar seu Pacote Universal, adicione a tarefa Pacote Universal ao seu pipeline e preencha os campos obrigatórios da seguinte maneira:

• Comando: Publicar

• Caminho para o(s) arquivo(s) a publicar: o caminho para a lista de arquivos a serem publicados. Padrão: $(Build.ArtifactStagingDirectory).

• Local do feed: publique em um feed de Artefatos do Azure em sua organização atual ou em outra organização.

• Feed de destino: selecione o feed no qual você deseja publicar.

• Nome do pacote: selecione um pacote existente (para publicar uma nova versão desse pacote) ou insira um novo nome de pacote (para publicar a primeira versão de um novo pacote).

  

Para publicar pacotes em um feed de Artefatos do Azure a partir do seu pipeline, defina a identidade sob a qual a compilação é executada como um Editor de Feed (Colaborador). Se o pipeline de compilação estiver configurado para ser executado usando o escopo da coleção de projetos, adicione a identidade do Serviço de Criação de Coleção de Projetos como um Feed Publisher (Colaborador) de feed.

Se o pipeline de compilação estiver configurado para ser executado usando o escopo do projeto, a identidade do Serviço de Construção do Projeto deverá receber acesso do colaborador ao feed. Você pode verificar o escopo no qual suas compilações são executadas abrindo o editor de pipeline e marcando a guia Opções . Para obter mais informações sobre permissões de feeds, consulte gerenciar pacotes com permissões de feed.

Para publicar em um feed externo, você deve primeiro criar uma conexão de serviço para apontar para esse feed. Para obter mais informações, consulte Gerenciar conexão de serviço.

Para habilitar o controle de versão para seu pacote, adicione uma versionOption entrada ao seu arquivo YAML. As opções para publicar uma nova versão do pacote são: major, minor, patch, ou custom.

A seleção custom permite que você especifique manualmente a versão do pacote. As outras opções obtêm a versão mais recente do pacote do seu feed e incrementam o segmento da versão escolhida em 1. Então, se você tiver um testPackage 1.0.0 e selecionar a opção principal , seu novo pacote será testPackage 2.0.0. Se você selecionar a opção secundária, a versão do pacote será 1.1.0 e, se você selecionar a opção de patch, a versão do pacote será 1.0.1.

Se você escolher a custom opção, também deverá especificar um versionPublish valor da seguinte maneira:

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    versionOption: custom
    versionPublish: '<Package version>'
    packagePublishDescription: '<Package description>'

No formulário de tarefa Pacotes Universais, selecione uma estratégia de controle de versão ou selecione Personalizado para inserir a versão do pacote manualmente.

Para baixar um Pacote Universal de um feed em sua organização, use a tarefa Pacote Universal com o download comando a seguir:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    vstsFeed: '<projectName>/<feedName>'
    vstsFeedPackage: '<packageName>'
    vstsPackageVersion: '<packageVersion>'
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'

Para baixar um pacote universal de uma fonte externa, use o seguinte trecho:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    feedsToUse: external
    externalFeedCredentials: 'MSENG2'
    feedDownloadExternal: 'fabrikamFeedExternal'
    packageDownloadExternal: 'fabrikam-package'
    versionDownloadExternal: 1.0.0

Para baixar um Pacote Universal, adicione a tarefa Pacote Universal ao seu pipeline e preencha os campos obrigatórios da seguinte maneira:

• Comando: Download
• Diretório de destino: caminho da pasta onde os pacotes serão baixados. Valor predefinido: $(System.DefaultWorkingDirectory).
• Local do feed: baixe um pacote universal de um feed em sua organização ou em outra organização.
• Feed: o feed do qual você deseja fazer o download.
• Nome do pacote: Nome do pacote a ser baixado.
• Versão: A versão do pacote que você deseja baixar.