Publicar e baixar Universal Packages com o Azure Pipelines

Para publicar um Universal Package no feed do Azure Artifacts, adicione a tarefa a seguir 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 de seu pipeline, a identidade do pipeline deve ter a função Publicador de Feed (Colaborador) no feed. Para obter mais informações, veja permissões de pipelines.

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

Para publicar seu Universal Package, adicione a tarefa Universal Package ao pipeline e preencha os campos obrigatórios desta maneira:

• Comando: Publish

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

• Local do feed: publique em um feed do Azure Artifacts 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 de seu pipeline, defina a identidade sob a qual a compilação é executada como um Publicador 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 Compilação da Coleção de Projetos como um Publicador de Feed (Colaborador).

Se o pipeline de build estiver configurado para ser executado usando o escopo do projeto, a identidade Serviço de Build do Projeto deverá ter acesso de colaborador ao feed. Você pode verificar o escopo no qual seus builds são executados abrindo o editor de pipeline e verificando a guia Opções. Para obter mais informações sobre permissões de feeds, confira Gerenciar pacotes com permissões de feed.

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

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

A escolha de 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 de versão escolhido em 1. Portanto, 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 patch, a versão do pacote será 1.0.1.

Se você escolher a opção custom, também deverá especificar um valor versionPublish 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 Universal Packages, selecione uma estratégia de controle de versão ou selecione Personalizado para inserir a versão do pacote manualmente.

Para baixar um Universal Package de um feed em sua organização, use a tarefa Universal Package com o comando download da seguinte maneira:

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 Universal Package de uma fonte externa, use o seguinte snippet:

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 Universal Package, adicione a tarefa Universal Package ao pipeline e preencha os campos obrigatórios desta maneira:

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