Compartilhar via

Publicar seu primeiro 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 pacotes, seja dentro de uma equipe, entre organizações ou publicamente na Internet. O Azure Artifacts dá suporte a uma ampla gama de tipos de pacotes, incluindo NuGet, npm, Python, Maven, Cargo e Pacotes Universais.

Este artigo explica como publicar seu primeiro pacote NuGet em um feed do Azure Artifacts. Opcionalmente, você pode seguir as instruções para usar o GitHub Copilot para ajudar a configurar seu projeto e preparar seu pacote para publicação.

Pré-requisitos

Produto Requisitos
Azure DevOps - Uma organização do Azure DevOps.
- Um projeto do Azure DevOps .
– Baixe e instale o Provedor de Credenciais do Azure Artifacts.
- Donwload e instale a versão mais recente do NuGet.
GitHub Copilot (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

Se você já tiver um feed, ignore esta seção. Caso contrário, siga as etapas abaixo para criar um novo feed no Azure Artifacts:

  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 o feed e defina sua Visibilidade para definir quem pode exibir pacotes no feed. Defina o escopo do feed e marque a caixa de seleção de fontes upstream se você quiser incluir pacotes de fontes públicas.

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps Services.

  1. Entre na sua coleçã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 o feed e defina sua Visibilidade para definir quem pode exibir pacotes no feed. Defina o escopo do feed e marque a caixa de seleção de fontes upstream se você quiser incluir pacotes de fontes públicas.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps Server 2022.

Preparar seu pacote

Neste exemplo, você usará uma biblioteca de classes do .NET Core de exemplo e configurará os metadados do pacote antes de compilar o projeto e criar um pacote NuGet pronto para publicação no feed. Se você ainda não tiver um projeto, siga as instruções neste guia para criar uma biblioteca de classes do .NET usando o Visual Studio Code.

  1. Abra seu projeto no Visual Studio Code e selecione o arquivo csproj . Adicione os metadados do pacote dentro da <PropertyGroup> marca. Seu arquivo deve ser semelhante ao 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>

  2. Execute o comando a seguir no diretório do projeto para criar seu projeto e criar um pacote .nupkg . Seu pacote estará na bin\release pasta.

    dotnet pack

Conectar-se a um feed

Siga as etapas abaixo para configurar seu projeto e conectar-se ao feed do Azure Artifacts. Verifique se você instalou o provedor de credenciais do Azure Artifacts e a versão mais recente do NuGet, conforme descrito nos pré-requisitos.

  1. Entre na 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 Conectar ao feed e, em seguida, selecione dotnet na seção NuGet .

  4. Siga as instruções na configuração do projeto para configurar o arquivo nuget.config. A estrutura do arquivo deve ser semelhante a uma das seguintes:

    • 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>

  1. Entre na sua coleção do Azure DevOps e navegue até seu projeto.

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

  3. Selecione Conectar ao Feed e, em seguida, selecione dotnet no painel de navegação esquerdo.

  4. Siga as instruções na seção de instalação do Project para configurar seu arquivo denuget.config .

    Uma captura de tela que mostra como se conectar a um feed no Azure DevOps Server 2020 e 2022.

Publicar seu pacote

Execute o comando a seguir no diretório do projeto para publicar o pacote no feed do Azure Artifacts. O --api-key parâmetro é necessário, mas você pode usar qualquer valor de cadeia de caracteres ao publicar no Azure Artifacts.

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

Próximas etapas

Monitorar o armazenamento de artefatosPráticas recomendadas do Azure ArtefatosCompartilhar pacotes publicamente

  • Last updated on