Publicar e baixar Pacotes Universais em 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 tradicionais, como NuGet, npm, pacotes Python, etc. Usando a CLI do Azure, você pode publicar e baixar Pacotes Universais diretamente da linha de comando. Embora o tamanho dos pacotes publicados possa variar, chegando a até 4 TB, eles devem sempre manter o requisito essencial de incluir um nome e número de versão. Este artigo irá guiá-lo pelas etapas para publicar e baixar Pacotes Universais do seu feed de Artefatos do Azure.

Pré-requisitos

• Uma organização e um projeto do Azure DevOps. Crie uma organização ou um projeto , caso ainda não o tenha feito.

• Instalar a CLI do Azure.

• Instale a extensão Azure DevOps versão 0.14.0 ou superior.

Criar um feed

Se já tiver um feed, pode passar para a secção seguinte. Caso contrário, siga as etapas abaixo para criar um novo feed de Artefatos do Azure:

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 descritivo para seu feed e defina sua Visibilidade (quem pode visualizar os pacotes em seu feed). Defina o Escopo do seu feed e marque a caixa de seleção Fontes upstream se quiser incluir pacotes de registros públicos.

4. Selecione Criar quando terminar.

   

Instalar a extensão Azure DevOps

O uso da CLI ajuda a simplificar suas tarefas. Antes de continuar, certifique-se de ter instalado a CLI do Azure (versão 2.10.1 ou superior). Além disso, precisaremos instalar a extensão 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 você já tiver a extensão do Azure DevOps instalada e quiser atualizá-la para a mais recente, execute o seguinte comando:

   az extension update --name azure-devops
   

Ligar ao feed

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

2. Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.

3. Selecione Conectar ao feed e, em seguida, selecione Pacotes Universais no painel de navegação esquerdo.

4. Siga as instruções na seção Configuração do projeto para se conectar ao seu feed.

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 letras ou números e conter apenas letras, números e traços não consecutivos, sublinhados e pontos. A versão do pacote também deve estar em minúsculas e não deve incluir metadados de compilação (+ sufixo). Consulte versionamento semântico para obter mais detalhes.

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

   • Feed com escopo 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>
     

   • Feed com escopo do 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>
     

Ver pacotes publicados

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

2. Selecione Artefatos e escolha seu feed no menu suspenso. Quando o processo de publicação for concluído com sucesso, o pacote deverá estar disponível no feed.

   

Baixar Pacotes Universais

Execute o seguinte comando para baixar um pacote universal específico do seu feed usando a CLI do Azure:

• Feed com escopo da organização:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
  

• Feed com escopo do projeto:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
  

Download de arquivos específicos

Se você deseja baixar apenas arquivos específicos, use o --file-filter parâmetro para buscar um subconjunto de arquivos. Consulte Referência de padrões de correspondência de arquivos para obter mais detalhes.

• Feed com escopo da organização:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
  

• Feed com escopo do projeto:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
  

Exemplo: Por exemplo, usar --file-filter logs/.log corresponderia a qualquer arquivo com um nome de arquivo contendo "logs" e terminando com a extensão ".log" (por exemplo, build_logs.log).

Faça o download da versão mais recente

Você pode usar curingas * para baixar a versão mais recente dos seus Pacotes Universais.

Exemplos:

• --version '*': faça o download da versão mais recente.

• --version '1.*': faça o download da versão mais recente com o major 1.

• --version '1.2.*': Faça o download da versão mais recente do patch com Major 1 e Minor 2.

Artigos relacionados

• Publicar e baixar pacotes universais com o Azure Pipelines
• Fontes upstream de pacotes universais
• Gerenciar permissões