Partilhar via

Publicar e baixar pacotes universais com o Azure Pipelines

  • Artigo

Serviços de DevOps do Azure

Os Pacotes Universais permitem-lhe empacotar e partilhar qualquer número de ficheiros, independentemente do tipo, com a sua equipa ou público-alvo. Usando a tarefa Pacote Universal no Azure Pipelines, você pode empacotar, publicar e baixar pacotes de até 4 TiB. Cada pacote é identificado por um nome exclusivo e número de versão. Você pode usar a CLI do Azure ou o Azure Pipelines para publicar e baixar pacotes de seus feeds de Artefatos.

Observação

Os Pacotes Universais só estão disponíveis nos Serviços de DevOps do Azure.

Pré-requisitos

Produto Requisitos
Azure DevOps - Um projeto Azure DevOps.
- Permissões:
    - Para conceder acesso a todos os pipelines no projeto, você deve ser membro do grupo Administradores de Projeto.
    - Para criar conexões de serviço, você deve ter a função Administrador ou Criador para conexões de serviço .

Copiar ficheiros

A tarefa Pacotes Universais no Azure Pipelines usa $(Build.ArtifactStagingDirectory) como o local padrão para os arquivos que você deseja publicar. Para preparar o Pacote Universal para publicação, mova os arquivos que deseja publicar para este diretório. Você também pode usar a tarefa do utilitário Copiar arquivos para copiar os arquivos para o diretório de publicação.

Publicar um pacote universal

  1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Pipelines e, em seguida, selecione sua definição de pipeline.

  3. Selecione Editar e adicione o seguinte trecho ao seu pipeline YAML.

    - task: UniversalPackages@0
  displayName: Publish
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'        ## Location of the files you wish to publish
    vstsFeedPublish: '<PROJECT_NAME>/<FEED_NAME>'                ## The project and feed name to publish to. If you're working with an organization-scoped feed, specify only the feed name
    vstsFeedPackagePublish: '<PACKAGE_NAME>'                     ## The package name. Must be lower case. Use only letters, numbers, and dashes
    packagePublishDescription: '<PACKAGE_DESCRIPTION>'           ## Description of the package content

Observação

Para publicar pacotes em um feed de seus Pipelines, certifique-se de que tanto o Serviço de Criação de Coleção de Projetos quanto as identidades de Serviço de Criação do seu projeto receberam a função de Editor de Feed (Colaborador) nas configurações de feed. Consulte Gerenciar permissões para obter mais detalhes.

Versionamento de pacote

Os Pacotes Universais aderem ao versionamento semântico, que se baseia em três componentes numéricos: Major, Minor e Patch. O formato de controle de versão é Major.Minor.Patch.

  • A versão menor é incrementada quando são adicionadas novas funcionalidades que são compatíveis com versões anteriores. Nesse caso, a versão secundária é incrementada e a versão do patch é redefinida para 0 (por exemplo, 1.4.17 para 1.5.0).
  • A versão principal é incrementada quando há alterações significativas que podem quebrar a compatibilidade com versões anteriores, redefinindo as versões secundária e patch para 0 (por exemplo, 2.6.5 a 3.0.0).
  • A versão do patch é incrementada quando correções de bugs ou outras pequenas alterações que não afetam a compatibilidade são aplicadas (por exemplo, 1.0.0 a 1.0.1).

Ao publicar um novo pacote, a tarefa Pacotes Universais selecionará automaticamente a próxima versão principal, secundária ou patch para você.

Para habilitar o controle de versão para seu pacote, adicione uma versionOption entrada à sua tarefa UniversagePackage. As opções disponíveis para publicar uma nova versão são: major, minor, patch, ou custom.

Selecionar custom permite especificar 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 selecionada em 1. Por exemplo, se você tiver um pacote testPackage 1.0.0:

  • A seleção major atualizará a versão para testPackage 2.0.0.
  • A seleção minor atualizará a versão para 1.1.0.
  • A seleção patch atualizará a versão para 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
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'             ## Location of the files you wish to publish
    vstsFeedPublish: '<PROJECT_NAME>/<FEED_NAME>'                     ## The project and feed name to publish to. If you're working with an organization-scoped feed, specify only the feed name
    vstsFeedPackagePublish: '<PACKAGE_NAME>'                          ## The package name. Must be lower case. Use only letters, numbers, and dashes
    versionOption: custom                                             ## Select a versioning strategy. Options: `major`, `minor`, `patch`, `custom`
    versionPublish: '<PACKAGE_VERSION>'                               ## The custom package version
    packagePublishDescription: '<PACKAGE_DESCRIPTION>'                ## Description of the package content

Baixe um pacote universal

  1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Pipelines e, em seguida, selecione sua definição de pipeline.

  3. Selecione Editar e adicione o seguinte trecho ao seu pipeline YAML.

    steps:
- task: UniversalPackages@0
  displayName: Download
  inputs:
    command: download
    vstsFeed: '<PROJECT_NAME>/<FEED_NAME>'                        ## The Artifacts feed hosting the package to be downloaded
    vstsFeedPackage: '<PACKAGE_NAME>'                             ## Name of the package to be downloaded
    vstsPackageVersion: '<PACKAGE_VERSION>'                       ## Version of the package to be downloaded
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'     ## The download folder. Default value: $(System.DefaultWorkingDirectory).

Para baixar um pacote universal de uma fonte externa, você pode usar o seguinte exemplo:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    feedsToUse: external                                        ## Set the value to `external` when downloading from an external source 
    externalFeedCredentials: 'MSENG2'                           ## Name of the service connection to the external feed
    feedDownloadExternal: 'fabrikamFeedExternal'                ## Name of the external feed
    packageDownloadExternal: 'fabrikam-package'                 ## The package name you wish to download
    versionDownloadExternal: 1.0.0                              ## The version of the package you wish to download

Dica

Os caracteres curinga podem ser utilizados para baixar a versão mais recente de um pacote universal. Consulte Transferir a versão mais recente para obter mais detalhes.

Conteúdo relacionado