Partilhar via


Publicar pacotes universais a partir de feeds de artefatos do Azure

Serviços de DevOps do Azure

Os Pacotes Universais permitem que os desenvolvedores armazenem uma ampla gama de tipos de pacotes além dos formatos tradicionais, como NuGet, npm, pacotes Python, etc. Usando a CLI do Azure, você pode publicar Pacotes Universais diretamente da linha de comando. Esses pacotes podem ser tão grandes quanto 4 TiB, mas sempre devem incluir um nome e número de versão. Este artigo orienta você pela publicação de Pacotes Universais em seu feed de Artefatos 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

Certifique-se de ter a CLI do Azure (versão 2.10.1 ou superior) instalada. Em seguida, siga as etapas abaixo para instalar ou atualizar a extensão do Azure DevOps para gerenciar os serviços do Azure DevOps a partir da linha de comando.

  1. Execute o seguinte comando para instalar a extensão Azure DevOps:

    az extension add --name azure-devops
    
  2. Se a extensão do Azure DevOps já estiver instalada e você quiser atualizá-la para a versão mais recente, execute:

    az extension update --name azure-devops
    

Criar um feed

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

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

  3. Forneça um Nome de para o seu feed, escolha a opção de Visibilidade que define quem pode visualizar os seus pacotes, selecione Incluir pacotes de fontes públicas comuns se pretender incluir pacotes de fontes como nuget.org ou npmjs.come, para Abrangência , decida se o feed deve ser abrangente para o seu projeto ou para toda a organização.

  4. Selecione Criar quando terminar.

    Uma captura de tela exibindo como criar um novo feed nos Serviços de DevOps do Azure.

Publicar pacotes universais

Para publicar um Pacote Universal no seu feed, você precisa fornecer um nome de pacote e um número de versão. O nome do pacote deve estar em minúsculas, começar e terminar com uma letra ou número, e só pode incluir letras, números e traços não consecutivos -, sublinhados _ou pontos finais .. Da mesma forma, a versão do pacote também deve estar em minúsculas e não deve conter metadados de compilação (indicados por um sufixo +). Consulte versionamento semântico para mais detalhes.

  1. Execute o seguinte comando para publicar o Pacote Universal no feed:

    • 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

Pacotes universais contendo um número excepcionalmente grande de arquivos (100K+) podem não ser publicados. Nesse caso, recomendamos agrupar os arquivos em um ZIP ou arquivo TAR para reduzir a contagem de arquivos.

Ver pacotes publicados

  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. Quando o processo de publicação for concluído com sucesso, o pacote deverá estar disponível no feed.

    Uma captura de tela exibindo o Pacote Universal recém-publicado.