Publicar pacotes universais a partir de feeds de artefatos do Azure

Serviços de DevOps do Azure

Os Pacotes Universais permitem armazenar muitos tipos de ficheiros e conteúdos de pacotes para além de formatos como NuGet, npm e pacotes Python. Podes publicá-los diretamente pela linha de comandos usando o CLI do Azure. Um Pacote Universal pode ter até 4 TiB e deve incluir um nome e uma versão. Este artigo mostra como publicar um Pacote Universal no seu feed do Artefactos do Azure.

Pré-requisitos

Produto Requisitos
Azure DevOps - Uma organização Azure DevOps .
- Um projeto do Azure DevOps .
- Instale CLI do Azure.
- Instale a extensão Azure DevOps versão 0.14.0 ou superior.

Instalar a extensão Azure DevOps

A extensão Azure DevOps para CLI do Azure permite-lhe gerir os serviços Azure DevOps a partir da linha de comandos. Antes de o instalares, certifica-te de que tens instalado o CLI do Azure versão 2.10.1 ou superior.

  1. Para instalar a extensão Azure DevOps, execute:

    az extension add --name azure-devops
    
  2. Para atualizar uma instalação existente para a versão mais recente, execute:

    az extension update --name azure-devops
    

Criar um feed

Antes de poderes publicar um Pacote Universal, precisas de um feed para o publicar. Um feed é um contentor que armazena e organiza os seus pacotes, e pode controlar quem pode aceder a eles. Use os passos seguintes para criar um feed para o seu projeto ou organização.

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

  2. Selecione Artefatose, em seguida, selecione Criar feed.

  3. Introduza um Nome para o seu feed.

  4. Escolha uma opção de Visibilidade para controlar quem pode ver os seus pacotes.

  5. Selecione Incluir pacotes de fontes públicas comuns se quiser que o seu feed também retire pacotes de fontes públicas como nuget.org ou npmjs.com.

  6. Para Scope, escolha se o feed se aplica apenas ao seu projeto ou a toda a organização.

  7. Selecione Criar quando terminar.

    Captura de ecrã a mostrar como criar um novo feed no Azure DevOps Services.

Publicar pacotes universais

Depois de criares o teu feed, estás pronto para publicar um Pacote Universal nele. Cada pacote que publica precisa de um nome e um número de versão, e ambos devem seguir regras específicas de nomenclatura:

  • O nome do pacote deve ser minúsculo, começar e terminar com uma letra ou número, e pode incluir apenas letras, números e traços não consecutivos (-), sublinhados (_) ou pontos (.).
  • A versão do pacote também deve ser minúscula e não pode conter metadados de build, indicados por um + sufixo. Para mais informações, consulte versionamento semântico.
  1. Execute um dos seguintes comandos para publicar o seu Pacote Universal, dependendo se o seu feed está destinado a um projeto ou à sua organização:

    • Feed com escopo de projeto:

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      
    • Feed da organização:

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      

Observação

Se o seu pacote contiver um número excecionalmente grande de ficheiros (100K ou mais), a publicação pode falhar. Neste caso, agrupe os ficheiros num arquivo ZIP ou TAR para reduzir o número de ficheiros.

Ver pacotes publicados

Depois de publicares o teu pacote, podes confirmar que está disponível no teu feed.

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

  2. Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso. Se a publicação foi concluída com sucesso, o seu pacote deverá estar disponível no seu feed.

    Captura de ecrã mostrando o recém-publicado Pacote Universal.