Promova pacotes e gerencie visualizações de feed

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

As visualizações de feed permitem que os usuários controlem a visibilidade do pacote compartilhando alguns pacotes enquanto mantêm outros privados. Cada modo de exibição filtra o feed para exibir um subconjunto de pacotes com base em critérios específicos definidos para esse modo de exibição.

Por padrão, os Artefatos do Azure vêm com três modos de exibição: @Local, @Prerelease e @Release. A @Local visualização é o padrão e contém todos os pacotes publicados, bem como aqueles salvos de fontes upstream. Todas as visualizações suportam NuGet, npm, Maven, Python, Cargo e Pacotes Universais.

Nota

Os Artefatos do Azure só dão suporte à publicação e restauração de pacotes do modo de exibição padrão - @Local. Não é possível publicar diretamente no @Prerelease ou @Release visualizações.

Promova pacotes

  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 o pacote que deseja promover e, em seguida, selecione Promover.

    Uma captura de tela exibindo como promover um pacote para um modo de exibição em um feed de Artefatos do Azure.

  4. Selecione uma vista no menu pendente e, em seguida, selecione Promover.

    Uma captura de tela mostrando a lista de modos de exibição disponíveis.

Importante

Não há suporte para rebaixamento de pacote. Depois que um pacote for promovido, ele não poderá ser revertido para uma exibição anterior.

Promover pacotes usando a API REST

Além de usar a interface do usuário do Azure Artifacts, você também pode promover pacotes usando a API REST.

O corpo da solicitação deve ser formatado como um documento de patch JSON que acrescenta a exibição ao final da matriz de exibições. Consulte os exemplos de Introdução à API REST e API REST para obter mais detalhes.

  • Feed com escopo da organização:

    PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1
    
  • Feed com escopo do projeto:

    PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1
    

Use JsonPatchOperation para construir o corpo da sua solicitação. Consulte NuGet - Versão do pacote de atualização para obter mais detalhes.

Exemplos

$ curl -X "PATCH" "https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1" \
-h 'Content-Type: application/json' \
-u ':${PAT}' \
-d $'{
  "views": {
    "op": "add",
    "path": "/views/-",
    "value": "{viewName}"
  }
}'

Nota

Todas as visualizações de feed em um projeto público são acessíveis a todos na internet.

Gerir vistas

O Azure Artifacts oferece três modos de exibição padrão: @Local, @Prerelease e @Release. Você também pode criar novas visualizações e gerenciar as existentes renomeando-as ou excluindo-as diretamente das configurações do seu 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 o ícone de engrenagem na extremidade direita para acessar as configurações do seu feed.

    Captura de ecrã a mostrar como aceder às definições do feed.

  4. Selecione Vistas, selecione uma vista e, em seguida, selecione Editar para editar a vista. Se pretender adicionar uma nova vista, selecione Adicionar vista.

  5. Quando terminar, selecione Guardar.

    Uma captura de ecrã a mostrar como adicionar, editar ou eliminar vistas de feed.

Importante

Para feeds públicos, se você alterar as permissões de acesso de um modo de exibição para Pessoas específicas, esse modo de exibição não estará mais disponível como uma fonte upstream.