Compartilhar via


Publicar pacotes universais dos feeds do Azure Artifacts

Serviços do Azure DevOps

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 um número de versão. Este artigo orienta você pela publicação de Pacotes Universais no feed de Artefatos do Azure.

Pré-requisitos

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

Instalar a extensão do Azure DevOps

Verifique se você tem 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 da linha de comando.

  1. Execute o seguinte comando para instalar a extensão do 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 Artefatos e, em seguida, selecione Criar Feed.

  3. Forneça um Nome para o feed, escolha a opção Visibilidade que define quem pode exibir seus pacotes, marque Incluir pacotes de fontes públicas comuns se quiser incluir pacotes de fontes como nuget.org ou npmjs.com e, em Escopo, decida se o feed deve ter o escopo do seu projeto ou de toda a organização.

  4. Selecione Criar quando estiver terminado.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps Services.

Publicar pacotes universais

Para publicar um Pacote Universal no feed, você precisa fornecer um nome de pacote e um número de versão. O nome do pacote deve estar em letras minúsculas, iniciar e terminar com uma letra ou número e pode incluir apenas letras, números e traços não consecutivos-, sublinhados ou períodos_.. Da mesma forma, a versão do pacote também deve estar em letras minúsculas e não deve conter metadados de build (indicados por um + sufixo). Consulte Controle semântico de versão para obter mais detalhes.

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

    • Feed do projeto com escopo:

      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 com escopo:

      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>
      

Nota

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

Exibir pacotes publicados

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

  2. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso. Depois que o processo de publicação for concluído com êxito, seu pacote deverá estar disponível no feed.

    Uma captura de tela exibindo o Pacote Universal publicado recentemente.