Partilhar via

Promova pacotes e gerencie visualizações de feed

Serviços de DevOps do Azure | Azure DevOps Server 2022 | Azure DevOps Server 2020

As visualizações de feed permitem que os desenvolvedores 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 exibição é o padrão e contém todos os pacotes publicados e aqueles salvos de fontes upstream. Todas as visualizações suportam NuGet, npm, Maven, Python, Cargo e Pacotes Universais. Pode alterar a vista predefinida nas Definições do Feed>Vistas, mas isso não permite a publicação direta nessa vista. Os pacotes só podem ser publicados no feed base, onde estão disponíveis na visualização @Local .

Nota

Você deve ser um Editor de Feed (Colaborador) ou um Proprietário de Feed para promover pacotes para uma exibição.

Promover um pacote para uma visualização específica

  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 pretende promover e, em seguida, selecione Promover.

  4. Selecione uma visualização no menu pendente e, em seguida, selecione Promover novamente.

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

Importante

Azure Artifacts não oferece suporte à redução de pacotes. Depois que um pacote é promovido, ele não pode ser revertido para uma exibição anterior.

Promover um pacote usando a API REST

Para promover um pacote usando a API REST, você precisa enviar uma solicitação PATCH com o corpo apropriado formatado como um documento de patch JSON . Isso acrescenta a exibição desejada (por exemplo, Pré-lançamento) à matriz de visualizações do pacote.

  1. Crie um token de acesso pessoal com empacotamento>Ler, escrever, & gerenciar escopo.

  2. Copie a URL do ponto de extremidade, substitua-a no exemplo a seguir ( PowerShell ou curl) e execute o comando para promover seu pacote para a exibição desejada.

  • Feed com escopo da organização:

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

  • Feed com âmbito específico para o projeto:

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

Consulte JsonPatchOperation e NuGet - Update Package Version para obter mais detalhes.

  • Feed no âmbito da coleção:

    https://{instance}/{collection}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1

  • Feed com âmbito específico para o projeto:

    https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1

Consulte JsonPatchOperation e NuGet - Update Package Version para obter mais detalhes.

  • Feed no âmbito da coleção:

    https://{instance}/{collection}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=6.0-preview.1

  • Feed com âmbito específico para o projeto:

    https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=6.0-preview.1

Consulte JsonPatchOperation e NuGet - Update Package Version para obter mais detalhes.

Exemplos

Substitua os espaços reservados pelo seu token de acesso pessoal, URL do endpoint e nome de exibição, e, em seguida, execute o comando para promover o seu pacote para a exibição desejada.

$env:PAT = "YOUR_PERSONAL_ACCESS_TOKEN"
$uri = "YOUR_URL"
$headers = @{
    "Content-Type" = "application/json"
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:PAT"))
}
$body = @{
    views = @{
        op    = "add"
        path  = "/views/-"
        value = "YOUR_VIEW_NAME"
    }
} | ConvertTo-Json

Invoke-RestMethod -Uri $uri -Method Patch -Headers $headers -Body $body

Nota

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

Gerir visualizações

Por padrão, o Azure Artifacts oferece três modos de exibiçã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.

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

  5. Quando terminar, selecione Guardar.

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.

Conteúdos relacionados