Partilhar via

Publicar seu primeiro pacote em um feed de Artefatos do Azure

Os Artefatos do Azure permitem que os desenvolvedores gerenciem com eficiência todas as suas dependências a partir de um único feed. Os feeds nos Artefatos do Azure 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 variedade de tipos de pacotes, incluindo NuGet, npm, Python, Maven, Cargo e Pacotes Universais.

Este artigo orienta você na publicação de seu primeiro pacote NuGet em um feed de Artefatos do Azure. 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 Azure DevOps .
- Um projeto do Azure DevOps .
- Baixe e instale o Provedor de Credenciais de Artefatos do Azure.
- Não carregue e instale a versão mais recente do NuGet.
Copiloto GitHub (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 se inscreveu.

Criar um feed

Se já tiver um feed, pode ignorar esta secção. Caso contrário, siga as etapas abaixo para criar um novo feed no Azure Artifacts:

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

  4. Selecione Criar quando terminar.

    Uma captura de tela exibindo como criar um novo feed nos Serviços de DevOps do Azure.

  1. Entre em sua coleção de DevOps do Azure 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 para definir quem pode visualizar os pacotes em seu feed. Defina o Escopo do seu feed e marque a caixa de seleção Fontes upstream se quiser incluir pacotes de fontes públicas.

  1. Selecione Criar quando terminar.

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

Prepare a sua embalagem

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

  1. Abra seu projeto no Visual Studio Code e, em seguida, selecione seu arquivo csproj . Adicione os metadados do <PropertyGroup> pacote à tag . 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 seguinte comando no diretório do projeto para construir 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 de Artefatos do Azure. Certifique-se de ter instalado o provedor de credenciais do Azure Artifacts e a versão mais recente do NuGet, conforme descrito nos pré-requisitos.

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

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

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

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

    • Feed com 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 âmbito 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 em sua coleção de DevOps do Azure e navegue até seu projeto.

  2. Selecione Artefactos e, em seguida, selecione o seu 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 Configuração do projeto para configurar seu arquivo nuget.config .

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

Publique o seu pacote

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

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

Próximos passos

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

  • Last updated on