Publicar um pacote em um feed do Azure Artifacts

O Azure Artifacts permite que os desenvolvedores gerenciem com eficiência todas as suas dependências de um único feed. Os feeds no Azure Artifacts servem como repositórios organizacionais para armazenar, gerenciar e compartilhar seus pacotes dentro de sua equipe, entre organizações ou publicamente na Internet. Os feeds do Azure Artifacts dão suporte a uma ampla variedade de tipos de pacotes, incluindo NuGet, npm, Python, Maven, Cargo e Universal Packages.

Este artigo orienta você pelo processo de publicação do seu primeiro pacote em um feed do Azure Artifacts. Você também tem a opção de usar o GitHub Copilot para simplificar esse processo e explorar os recursos do GitHub Copilot Chat no Visual Studio Code.

Pré-requisitos

• Crie uma organização do Azure DevOps e um projeto, caso ainda não tenha feito isso.

• Instale o SDK do .NET Core.

• Instale o provedor de credenciais do Azure Artifacts.

• (Opcional) Configure o GitHub Copilot e o Visual Studio Code. Uma avaliação gratuita de 30 dias do GitHub Copilot está disponível se você ainda não tiver se inscrito.

Criar um feed

1. Entre na 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 descritivo para seu feed e defina sua Visibilidade (quem pode visualizar pacotes em seu feed). Defina o Escopo do seu feed e, se quiser incluir pacotes de fontes públicas, marque a caixa de seleção Fontes upstream.

4. Selecione Criar quando terminar.

   

Preparar o código

Sem o GitHub Copilot

Siga estas etapas para criar um projeto básico de Biblioteca de Classes na linha de comando, configurar os metadados do pacote e gerar um pacote NuGet:

1. Em sua máquina local, crie uma nova pasta e dê um nome a ela.

2. Abra uma janela de prompt de comando e navegue até a pasta que você criou.

3. Execute o seguinte comando para criar um novo projeto de Biblioteca de Classes:

   dotnet new classlib
   

4. Abra o arquivo csproj e adicione os metadados do pacote à <PropertyGroup> marca. Sua estrutura de arquivos deve ser semelhante à seguinte:

   <Project Sdk="Microsoft.NET.Sdk">
   
     <PropertyGroup>
       <TargetFramework>net8.0</TargetFramework>
       <RootNamespace>demo_class_library</RootNamespace>
       <ImplicitUsings>enable</ImplicitUsings>
       <Nullable>enable</Nullable>
   
       <PackageId>YOUR_PACKAGE_NAME</PackageId>
       <Version>YOUR_PACKAGE_VERSION</Version>
       <Authors>YOUR_NAME</Authors>
       <Company>YOUR_COMPANY</Company>
   
     </PropertyGroup>
   
   </Project>
   

5. Execute o comando a seguir para empacotar seu projeto e gerar um artefato .nupkg . seu pacote NuGet é gerado no bin\release diretório.

   dotnet pack
   

Com o GitHub Copilot

Antes de publicar um pacote no feed criado anteriormente, você deve primeiro empacotar seu projeto e prepará-lo para publicação.

O exemplo a seguir orienta você no uso do GitHub Copilot para criar uma biblioteca de classes do .NET Core de exemplo e gerar um pacote NuGet na linha de comando. Você também pode usar o GitHub Copilot para gerar outros tipos de projetos, como projetos npm ou Python.

1. Abra o Visual Studio Code e selecione o ícone de chat no painel de navegação esquerdo para abrir o GitHub Copilot Chat.

2. Na caixa de prompt. pergunte ao copiloto do GitHub: "Como faço para criar um projeto .NET Core e empacotá-lo como um pacote NuGet?". A resposta do GitHub Copilot pode ser algo semelhante ao seguinte:

   

3. Siga as etapas fornecidas para gerar seu projeto, definir a ID e a versão do pacote e empacotar seu projeto.

Você também pode pedir ao GitHub Copilot para explicar a estrutura do projeto usando o @workspace comando, que permite interagir com os arquivos e pastas no workspace atual.

@workspace Explicar a estrutura do meu aplicativo

Outro método útil para entender o novo código-fonte é perguntar ao GitHub Copilot como arquivos específicos estão relacionados dentro do projeto. Por exemplo, você pode perguntar como o arquivo csproj está relacionado ao arquivo Class1.cs :

#file:artifacts-github-copilot.csproj #file:Class1.cs como esses arquivos estão relacionados

Conectar-se a um feed

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

2. Selecione Conectar ao feed e, em seguida, selecione dotnet na seção NuGet .

3. Siga as instruções na configuração do projeto para configurar o arquivo nuget.config. A estrutura do seu arquivo deve ser semelhante a esta:

   • Feed no escopo do projeto:

     <?xml version="1.0" encoding="utf-8"?>
     <configuration>
       <packageSources>
         <clear />
         <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
       </packageSources>
     </configuration>
     

   • Feed no escopo da organização:

     <?xml version="1.0" encoding="utf-8"?>
     <configuration>
       <packageSources>
         <clear />
         <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
       </packageSources>
     </configuration>
     

Dica

Você pode perguntar ao GitHub Copilot "como adicionar uma nova fonte de pacote a um arquivo nuget.config existente". O Copilot orientará você no uso do nuget sources Add comando para adicionar sua nova URL de origem do feed ao arquivo nuget.config .

Publicar pacotes

Execute o comando a seguir no diretório do projeto para publicar o pacote. O ApiKey é necessário, mas você pode usar qualquer valor de cadeia de caracteres ao publicar em um feed do Azure Artifacts.

dotnet nuget push --source <FEED_NAME> --api-key az <PACKAGE_PATH>

Próximas etapas

Monitorar o armazenamento deartefatos Compartilhar pacotes publicamenteGerenciar permissões