Promover pacotes e gerenciar exibições de feed no Azure Artifacts

Artigo
10/16/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

As exibições de feed são uma maneira de permitir que os usuários compartilhem alguns pacotes, mantendo outros pacotes privados. As visualizações filtram o feed para um subconjunto de pacotes que atendem a um conjunto de critérios definidos por essa visualização.

Por padrão, o Azure Artifacts vem com três exibições: @Local, @Prerelease e @Release. @local é a exibição padrão que contém todos os pacotes publicados e todos os pacotes salvos de fontes upstream. Todas as exibições dão suporte a pacotes NuGet, npm, Maven, Python e Universal.

Observação

O Azure Artifacts só dá suporte à publicação e restauração de pacotes de e para a exibição padrão - @Local.

Promover pacotes

Entre na sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.
Selecione o pacote que você deseja promover e, em seguida, selecione Promover.
Selecione um modo de exibição no menu suspenso e selecione Promover.

Observação

Não há suporte para o rebaixamento do pacote. Se você quiser que esse recurso seja adicionado a uma versão futura, sinta-se à vontade para sugerir um recurso na Comunidade de Desenvolvedores do Azure DevOps.

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 um documento JSON Patch que adiciona a exibição ao final da views matriz. Para obter mais detalhes sobre como interagir com a API REST do Azure DevOps, consulte Introdução à API REST e os exemplos da API REST.

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-preview.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-preview.1

Use JsonPatchOperation para construir o corpo da solicitação. Consulte NuGet – atualizar a versão do pacote para obter mais detalhes.

Feed com escopo da organização:

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

Feed com escopo do projeto:

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

Use JsonPatchOperation para construir o corpo da solicitação. Consulte npm - atualizar a versão do pacote para obter mais detalhes.

Feed com escopo da organização:

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

Feed com escopo do projeto:

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

Use JsonPatchOperation para construir o corpo da solicitação. Consulte Python – atualizar a versão do pacote para obter mais detalhes.

Feed com escopo da organização:

PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.1-preview.1

Feed com escopo do projeto:

PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.1-preview.1

Use JsonPatchOperation para construir o corpo da solicitação. Consulte Maven - atualizar a versão do pacote para obter mais detalhes.

Feed com escopo da organização:

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

Feed com escopo do projeto:

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

Use JsonPatchOperation para construir o corpo da solicitação. Consulte Pacotes universais - atualizar a versão do pacote para obter mais detalhes.

Exemplos

curl
PowerShell

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

$uri = "https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1-preview.1"
$headers = @{
    "Content-Type" = "application/json"
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:PAT"))
}
$body = @{
    views = @{
        op    = "add"
        path  = "/views/-"
        value = "{viewName}"
    }
} | ConvertTo-Json

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

Gerenciar exibições

Você pode criar suas próprias visualizações ou renomear e excluir as existentes nas configurações do seu feed.

Observação

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

Selecione Artefatos.
Selecione seu feed no menu suspenso.
Selecione o ícone de engrenagem para acessar as configurações do seu feed.
Selecione Exibições.
Selecione um modo de exibição e, em seguida, selecione Editar para editar seu modo de exibição ou selecione Adicionar modo de exibição se quiser adicionar um novo modo de exibição.
Selecione Salvar ao terminar.

Importante

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