Usar pacotes da Galeria do NuGet

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

As fontes upstream do Azure Artifacts facilitam para desenvolvedores a obtenção de pacotes de repositórios públicos, como nuget.org e npmjs.com. Neste artigo, você aprenderá a configurar seu projeto e usar a linha de comando para consumir pacotes NuGet da Galeria do NuGet.

Pré-requisitos

Configurar o provedor de credenciais Azure Artifacts

Para autenticar com o feed, primeiro você deve instalar o provedor de credenciais Azure Artifacts. Usando o instalador de ferramentas incluído no dotnet, você pode instalar o provedor de credenciais da CLI usando o seguinte comando:

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool

Se o nuget.config no nível do repositório estiver configurado para usar apenas fontes do Azure Artifacts, execute o comando de instalação fora desse diretório ou defina explicitamente nuget.org como a origem:

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --source https://api.nuget.org/v3/index.json

Opcionalmente, fixe a ferramenta em uma versão principal específica (por exemplo, em imagens de contêiner em que a reprodutibilidade é importante):

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --version 2.* --source https://api.nuget.org/v3/index.json

Primeiro uso

Na primeira vez que você executar uma operação que exija autenticação, use uma das seguintes abordagens:

1. Execute o comando com --interactive para que dotnet possa solicitar que você faça login. Essa é a abordagem recomendada para a maioria dos cenários de desenvolvimento local.

Antes de executar um comando interativo, verifique se o projeto está configurado e se o feed é adicionado ao nuget.config. Para obter detalhes da instalação, consulte a configuração do projeto.

Depois que o projeto estiver configurado e conectado ao feed, navegue até o diretório do projeto e execute:

dotnet restore --interactive

Esse comando o inscreve e adquire um token de sessão. Após fazer login com sucesso, você poderá executar comandos autenticados sem --interactive enquanto o token de sessão em cache permanecer válido. Para obter mais informações, consulte Session token cache locations.

2. Para cenários não interativos, como contêineres do Docker e automação personalizada, forneça credenciais por meio de variáveis environment.

Para Azure Pipelines, use a tarefa NuGetAuthenticate@1 para autenticar no feed antes de executar comandos como dotnet restore ou dotnet nuget push. Consulte Restaurar pacotes NuGet com o Azure Pipelines para obter mais detalhes.

Criar um feed e habilitar fontes upstream

Se você ainda não criou um feed, siga as etapas abaixo para criar um novo feed e habilitar fontes upstream. Se você já tiver um feed, prossiga para a próxima etapa para adicionar a Galeria NuGet como uma fonte upstream.

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 para o feed, selecione a opção Visibilidade para definir quem pode exibir seus pacotes e escolha seu Escopo. Azure Artifacts recomenda restringir os feeds a um projeto ao invés de toda a organização.

4. Verifique a opção Incluir pacotes de fontes públicas comuns , pois você precisará disso para consumir pacotes de registros públicos, como nuget.org, npmjs.com etc.

5. Selecione Criar quando terminar.

   

Adicionar fonte de upstream da Galeria do NuGet

Se você verificou a caixa de seleção de fontes upstream ao criar o feed (conforme mostrado na seção anterior), a Galeria do NuGet deve ter sido adicionada automaticamente às fontes upstream do feed. Se você estiver trabalhando com um feed diferente ou tiver esquecido de verificar essa opção, poderá adicionar manualmente a Galeria do NuGet seguindo estas etapas:

1. Entre no Azure DevOps e navegue até o projeto.

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

3. Selecione o botão do ícone de engrenagem para navegar até as Configurações do Feed.

Conectar-se ao seu feed

Nesta seção, você aprenderá a configurar seu projeto para autenticar com o feed do Azure Artifacts e salvar pacotes de fontes upstream, como a Galeria do NuGet.

Instalar pacotes da Galeria do NuGet

Agora que seu projeto está configurado para autenticar no feed do Azure Artifacts, você pode continuar instalando pacotes do NuGet Gallery upstream. Neste exemplo, você instalará o SDK do MCP C# para o Protocolo de Contexto de Modelo para aplicativos .NET interagirem com clientes e servidores MCP:

1. Navegue até a Galeria do NuGet em https://www.nuget.org/.

2. Pesquise o ModelContextProtocol e, em seguida, selecione-o para abrir a página de detalhes.

3. Selecione a guia CLI do .NET e copie o comando. Neste exemplo, o comando é:

   dotnet add package ModelContextProtocol --version 0.3.0-preview.4
   

4. Abra uma janela do prompt de comando, navegue até o diretório do projeto, cole o comando e pressione Enter para instalar o pacote.

Depois de instalado, uma cópia do pacote será salva automaticamente no feed, garantindo a disponibilidade se a Galeria do NuGet estiver inativa e protegendo seu fluxo de trabalho de outros pacotes corrompidos ou mal-intencionados do registro público.

Exibir pacotes salvos

1. Entre no Azure DevOps e navegue até seu projeto.

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

3. Selecione a fonte NuGet Gallery no menu suspenso para filtrar pacotes desse upstream.

4. Os pacotes ModelContextProtocol , instalados na etapa anterior, agora estão disponíveis em nosso feed. O Azure Artifacts salvou automaticamente uma cópia no feed.

   

Conteúdo relacionado

• Publicar pacotes no NuGet.org

• Publicar pacotes NuGet com o Azure Pipelines

• Gerenciar permissões