Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022
Este artigo guia-o como ligar-se ao seu feed e publicar pacotes utilizando dois fluxos de autenticação: o Artefactos do Azure Credential Provider para feeds na sua própria organização, e um token de acesso pessoal (PAT) para feeds alojados numa organização diferente.
Pré-requisitos
- An Azure DevOps organization.
- An Azure DevOps project.
- Um feed do Artefactos do Azure.
-
nuget.exe versão
4.8.0.5385ou posterior. A Artefactos do Azure recomenda o NuGet5.5.xou versões posteriores para a melhor compatibilidade e fiabilidade. - Para publicar pacotes, deve ser um Feed Publisher (Contribuidor) ou superior.
Configurar o fornecedor de credenciais do Artefactos do Azure
O Artefactos do Azure Credential Provider permite a autenticação segura dos seus feeds Artefactos do Azure. Para o utilizar com o nuget.exe, tem primeiro de o adicionar ao caminho de pesquisa de plug-ins do NuGet. Para mais detalhes, consulte Instalação e descoberta de plugins. Depois de adicionar o plugin, siga os passos de instalação do seu sistema operativo:
Use um dos seguintes métodos para instalar o Artefactos do Azure Credential Provider:
Instalação manual
Descarregue a versão mais recente Microsoft.NetFx48.NuGet.CredentialProvider.zip.
Extraia o arquivo zip.
Copie a
netfxpasta do arquivo extraído para%UserProfile%/.nuget/plugins/. Anetfxpasta é necessária para nuget.exe compatibilidade.
Instale usando o script auxiliar
Em alternativa, pode usar o script de ajuda automática para uma instalação simplificada. Certifique-se de que tem PowerShell 5.1 ou mais recente e depois execute:
iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"
Para mais informações, consulte o repositório Artefactos do Azure Credential Provider.
Conectar-se a um feed
Antes de poderes publicar os teus pacotes, configura o teu projeto e liga-te ao teu feed da seguinte forma:
Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.
Selecione Ligar ao feede, em seguida, selecione NuGet.exe no painel de navegação esquerdo.
Adiciona um ficheiro
nuget.configao teu projeto, na mesma pasta do que o teu ficheiro.csprojou.sln. Cole o trecho XML fornecido em seu arquivo. O trecho deve ter a seguinte aparência:Feed com âmbito da organização:
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <clear /> <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" /> </packageSources> </configuration>Feed com escopo de projeto:
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <clear /> <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" /> </packageSources> </configuration>
Entre no servidor de DevOps do Azure e navegue até o projeto.
Selecione Artefatose, em seguida, selecione o seu feed.
Selecione Ligar ao Feede, em seguida, selecione NuGet.exe no painel de navegação esquerdo.
Adicione um ficheiro
nuget.configao seu projeto, na mesma pasta que o seu ficheiro.csprojou.sln, e depois cole o excerto de XML fornecido no seu ficheiro.
Publicar num feed da mesma organização
Depois de configurar nuget.config e autenticar usando o Artefactos do Azure Credential Provider, execute o seguinte comando para publicar um pacote no seu feed. Substituir os marcadores de posição pelos valores apropriados:
nuget push <PACKAGE_PATH> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -ApiKey <ANY_STRING>
Example:
nuget push MyPackage.5.0.2.nupkg -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ
Observação
O Artefactos do Azure Credential Provider trata da autenticação real para o push, mas o NuGet ainda requer um -ApiKey valor para aceitar o comando. Artefactos do Azure ignora o valor que forneces, por isso qualquer cadeia não vazia serve.
Publicar num feed de outra organização
Se o feed de destino estiver numa organização Azure DevOps diferente, crie um PAT nessa organização e adicione o feed como fonte no seu nuget.config ficheiro.
Crie um token de acesso pessoal (PAT) na organização de destino com o âmbito Empacotamento>.
Execute o comando seguinte para adicionar o feed como fonte. Este comando adiciona o seu PAT ao
nuget.config, por isso guarde o ficheiro em segurança e não o adicione ao controlo de código-fonte.nuget sources Add -Name <SOURCE_NAME> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -UserName <USER_NAME> -Password <PERSONAL_ACCESS_TOKEN> -config <PATH_TO_NUGET_CONFIG_FILE>Publique o pacote usando o nome de origem que acabou de adicionar.
nuget push <PACKAGE_PATH> -Source <SOURCE_NAME> -ApiKey <ANY_STRING>
Example:
nuget sources Add -Name "MySource" -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -UserName MyUserName -Password YourPersonalAccessToken -config ./nuget.config
nuget push nupkgs/mypackage.1.1.8.nupkg -Source MySource -ApiKey AZ
Observação
Se a sua organização utilizar um firewall ou servidor proxy, autorize os URLs de domínio e endereços IP do Artefactos do Azure.
Troubleshooting
O prompt de autenticação não aparece
Certifique-se de que o Artefactos do Azure Credential Provider está instalado e que está a usar a versão 4.8.0.5385 NuGet ou posterior. Para os passos de configuração, consulte Ligar aos feeds do Artefactos do Azure com o NuGet.exe.
A publicação falha porque a versão já existe
As versões dos pacotes no Artefactos do Azure são imutáveis. Depois de publicar uma versão, não pode sobrescrevê-la nem reutilizar o mesmo número de versão, mesmo que apague o pacote. Atualiza a versão do pacote, reconstrói o pacote e depois publica-o novamente.
A publicação falha atrás de um firewall ou proxy
Permita os URLs de domínio e endereços IP do Artefactos do Azure e, em seguida, tente novamente a operação de publicação.
A publicação falha com um erro 403
Este erro normalmente significa que a sua conta não tem permissões de publicação no feed. Precisa de, pelo menos, a função Publicador de feed (Contribuidor) para publicar pacotes. Peça ao proprietário do feed para atualizar a sua função e tente novamente.