# Trabalhando com o registro NuGet Você pode configurar a interface de linha de comando (CLI) dotnet para publicar pacotes NuGet em GitHub Packages e usar pacotes armazenados em GitHub Packages como dependências em um projeto .NET. ## Autenticar para GitHub Packages > \[!NOTE] > GitHub Packages só dá suporte à autenticação usando um personal access token (classic). Para saber mais, confira [Gerenciar seus tokens de acesso pessoal](/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). Você precisa de um token de acesso para publicar, instalar e excluir pacotes privados, públicos e internos. Você pode usar um personal access token (classic) para se autenticar no GitHub Packages ou na API do GitHub. Ao criar um personal access token (classic), você pode atribuir diferentes escopos de token, dependendo da sua necessidade. Para obter mais informações sobre escopos relacionados a pacotes para personal access token (classic), confira [Sobre permissões para o GitHub Packages](/pt/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries). Para efetuar a autenticação em um registro do GitHub Packages dentro de um fluxo de trabalho de GitHub Actions, você pode utilizar: * `GITHUB_TOKEN` para publicar pacotes associados ao repositório do fluxo de trabalho. * Um personal access token (classic) com pelo menos escopo `read:packages` para instalar pacotes associados a outros repositórios privados (`GITHUB_TOKEN` pode ser usado se o repositório receber acesso de leitura ao pacote. Confira, [Configurando o controle de acesso e visibilidade de um pacote](/pt/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)). ### Autenticação em um GitHub Actions fluxo de trabalho Esse registro dá suporte a permissões granulares. Para registros que dão suporte a permissões granulares, se o fluxo GitHub Actions de trabalho estiver usando um personal access token para autenticar em um registro, recomendamos que você atualize seu fluxo de trabalho para usar o `GITHUB_TOKEN`. Para obter diretrizes sobre como atualizar seus fluxos de trabalho que se autenticam em um registro com um personal access token[, consulte AUTOTITLE](/pt/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions#upgrading-a-workflow-that-accesses-a-registry-using-a-personal-access-token). > \[!NOTE] > A capacidade dos fluxos de trabalho do GitHub Actions de excluir e restaurar pacotes usando a API REST está em prévia pública e está sujeita a alterações. Você poderá usar um `GITHUB_TOKEN` em um fluxo de trabalho GitHub Actions para excluir ou restaurar um pacote usando a API REST se o token tiver a permissão `admin` para o pacote. Repositórios que publicam pacotes usando um fluxo de trabalho e repositórios conectados explicitamente a pacotes recebem permissão `admin` para pacotes no repositório automaticamente. Para obter mais informações sobre `GITHUB_TOKEN`, confira [Usar GITHUB\_TOKEN para autenticação em fluxos de trabalho](/pt/actions/tutorials/authenticate-with-github_token#using-the-github_token-in-a-workflow). Para obter mais informações sobre as melhores práticas ao usar um registro em ações, confira [Executores comprometidos](/pt/actions/concepts/security/compromised-runners#cross-repository-access). Use o comando a seguir para se autenticar em GitHub Packages em um fluxo de trabalho GitHub Actions usando o `GITHUB_TOKEN` em vez de definir diretamente um personal access token em um arquivo nuget.config no repositório: ```shell dotnet nuget add source --username USERNAME --password ${{ secrets.GITHUB_TOKEN }} --store-password-in-clear-text --name github "https://nuget.pkg.github.com/NAMESPACE/index.json" ``` Substitua `NAMESPACE` pelo nome da conta pessoal ou organização para a qual seus pacotes têm o escopo. Substitua `USERNAME` pelo nome de usuário a ser usado ao se conectar a uma fonte autenticada. Você também pode optar por conceder permissões de acesso a pacotes de forma independente paraGitHub Codespaces eGitHub Actions. Para saber mais, confira [Configurando o controle de acesso e visibilidade de um pacote](/pt/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-github-codespaces-access-to-your-package) e [Configurando o controle de acesso e visibilidade de um pacote](/pt/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package). ### Autenticando com um personal access token > \[!NOTE] > GitHub Packages só dá suporte à autenticação usando um personal access token (classic). Para saber mais, confira [Gerenciar seus tokens de acesso pessoal](/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). Você precisa de um token de acesso para publicar, instalar e excluir pacotes privados, públicos e internos. Você pode usar um personal access token (classic) para se autenticar no GitHub Packages ou na API do GitHub. Ao criar um personal access token (classic), você pode atribuir diferentes escopos de token, dependendo da sua necessidade. Para obter mais informações sobre escopos relacionados a pacotes para personal access token (classic), confira [Sobre permissões para o GitHub Packages](/pt/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries). Para efetuar a autenticação em um registro do GitHub Packages dentro de um fluxo de trabalho de GitHub Actions, você pode utilizar: * `GITHUB_TOKEN` para publicar pacotes associados ao repositório do fluxo de trabalho. * Um personal access token (classic) com pelo menos escopo `read:packages` para instalar pacotes associados a outros repositórios privados (`GITHUB_TOKEN` pode ser usado se o repositório receber acesso de leitura ao pacote. Confira, [Configurando o controle de acesso e visibilidade de um pacote](/pt/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)). Você precisa usar um personal access token (classic) com os escopos apropriados para publicar e instalar pacotes no GitHub Packages. Para saber mais, confira [Introdução ao GitHub Packages](/pt/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages). Para se autenticar em GitHub Packages usando a interface de linha de comando (CLI) `dotnet`, crie um arquivo *nuget.config* no diretório do seu projeto, especificando GitHub Packages como uma fonte em `packageSources` para o cliente de CLI `dotnet`. Você deve substituir: * `USERNAME` com o nome da sua conta pessoal em GitHub. * `TOKEN` com o seu personal access token (classic). * `NAMESPACE` com o nome da conta pessoal ou organização para a qual seus pacotes têm o escopo. ```xml ``` ## Publicando um pacote > \[!NOTE] > O arquivo `nupkg` para uma versão do pacote NuGet deve ter o tamanho menor que 2,147 GB. Você pode publicar um pacote em GitHub Packages autenticando-se com um arquivo *nuget.config*, usando a opção de linha de comando `--api-key` com seu GitHubpersonal access token (classic) ou usando um comando que pode ser executado diretamente da linha de comando por meio da interface de linha de comando `dotnet` (CLI). Substitua `OWNER` pelo nome de usuário ou pela empresa e `YOUR_GITHUB_PAT` pelo seu personal access token. ```shell dotnet nuget add source --username OWNER --password YOUR_GITHUB_PAT --store-password-in-clear-text --name github "https://nuget.pkg.github.com/OWNER/index.json" ``` O registro do NuGet armazena pacotes em sua organização ou conta pessoal e permite que você associe pacotes a um repositório. Você pode escolher se deve herdar permissões de um repositório ou definir permissões granulares, independentemente de um repositório. Ao publicar um pacote pela primeira vez a visibilidade-padrão será privada. Para mudar a visibilidade ou definir permissões de acesso, confira [Configurando o controle de acesso e visibilidade de um pacote](/pt/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility). Para obter mais informações sobre como vincular um pacote publicado a um repositório, consulte [Conectar um repositório a um pacote](/pt/packages/learn-github-packages/connecting-a-repository-to-a-package). Se você especificar um `RepositoryURL` no arquivo *.csproj* do project, o pacote publicado será conectado automaticamente ao repositório especificado. Para obter mais informações, consulte [Trabalhando com o registro NuGet](/pt/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry#publishing-a-package-using-a-nugetconfig-file). Para obter informações sobre como vincular um pacote já publicado a um repositório, consulte [Conectar um repositório a um pacote](/pt/packages/learn-github-packages/connecting-a-repository-to-a-package). ### Publicando um pacote usando um token do GitHub personal access token como chave de API Se você ainda não tiver um personal access token para usar na sua conta em GitHub, confira [Gerenciar seus tokens de acesso pessoal](/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). 1. Crie um novo project. Substitua `PROJECT_NAME` pelo nome que você gostaria de dar ao project. ```shell dotnet new console --name PROJECT_NAME ``` 2. Empacotar o projeto. ```shell dotnet pack --configuration Release ``` 3. Publique o pacote usando sua personal access token chave de API. Substitua `PROJECT_NAME` pelo nome do projeto, `1.0.0` pelo número de versão do pacote e `YOUR_GITHUB_PAT` pelo seu personal access token. ```shell dotnet nuget push "bin/Release/PROJECT_NAME.1.0.0.nupkg" --api-key YOUR_GITHUB_PAT --source "github" ``` Após publicar um pacote, você poderá visualizá-lo no GitHub. Para saber mais, confira [Visualizar pacotes](/pt/packages/learn-github-packages/viewing-packages). ### Como publicar um pacote usando um arquivo *nuget.config* Ao publicar, se você estiver vinculando seu pacote a um repositório, o `OWNER` repositório especificado em seu arquivo *.csproj* deverá corresponder ao `NAMESPACE` que você usa em seu arquivo de autenticação *nuget.config* . Especifique ou incremente o número de versão no arquivo *.csproj* e use o comando `dotnet pack` para criar um arquivo *.nuspec* para essa versão. Para obter mais informações sobre como criar seu pacote, confira [Criar e publicar um pacote](https://docs.microsoft.com/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli) na documentação da Microsoft. > \[!NOTE] > Se você publicar um pacote vinculado a um repositório, o pacote herdará automaticamente as permissões de acesso do repositório vinculado e os fluxos de trabalho do GitHub Actions no repositório vinculado obterão automaticamente acesso ao pacote, a menos que a sua organização tenha desabilitado a herança automática das permissões de acesso. Para saber mais, confira [Configurando o controle de acesso e visibilidade de um pacote](/pt/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#about-inheritance-of-access-permissions). 1. Autenticar para GitHub Packages. Para saber mais, confira [Autenticação no GitHub Packages](#authenticating-to-github-packages). 2. Crie um novo project. Substitua `PROJECT_NAME` pelo nome que você gostaria de dar ao project. ```shell dotnet new console --name PROJECT_NAME ``` 3. Adicione as informações específicas do seu projeto ao arquivo do seu projeto, que termina em *.csproj*. Certifique-se de substituir: * `1.0.0` pelo número de versão do pacote. * `OWNER` com o nome da conta pessoal ou organização que possui o repositório ao qual você deseja vincular seu pacote. * `REPOSITORY` com o nome do repositório ao qual você deseja conectar seu pacote. ```xml Exe netcoreapp3.0 PROJECT_NAME 1.0.0 AUTHORS COMPANY_NAME PACKAGE_DESCRIPTION https://github.com/OWNER/REPOSITORY ``` 4. Empacotar o projeto. ```shell dotnet pack --configuration Release ``` 5. Publique o pacote usando a `key` que você especificou no arquivo *nuget.config*. Substitua `PROJECT_NAME` pelo nome do project e substitua `1.0.0` pelo número de versão do pacote. ```shell dotnet nuget push "bin/Release/PROJECT_NAME.1.0.0.nupkg" --source "github" ``` Após publicar um pacote, você poderá visualizá-lo no GitHub. Para saber mais, confira [Visualizar pacotes](/pt/packages/learn-github-packages/viewing-packages). ## Publicar vários pacotes no mesmo repositório Para conectar vários pacotes ao mesmo repositório, use a mesma URL do repositório nos campos GitHub em todos os arquivos de projeto `RepositoryURL`. GitHub corresponde ao repositório com base nesse campo. O seguinte exemplo publica os projetos MY\_APP e MY\_OTHER\_APP no mesmo repositório: ```xml Exe netcoreapp3.0 MY_APP 1.0.0 Octocat GitHub This package adds a singing Octocat! https://github.com/my-org/my-repo ``` ```xml Exe netcoreapp3.0 MY_OTHER_APP 1.0.0 Octocat GitHub This package adds a dancing Octocat! https://github.com/my-org/my-repo ``` ## Instalando um pacote Usar pacotes de GitHub no seu projeto é semelhante a usar pacotes de *nuget.org*. Adicione suas dependências de pacotes ao arquivo *.csproj*, especificando o nome e a versão do pacote. Para obter mais informações sobre como usar um arquivo *.csproj* em seu projeto, consulte [Trabalhando com os pacotes NuGet](https://docs.microsoft.com/nuget/consume-packages/overview-and-workflow) na documentação da Microsoft. 1. Autenticar para GitHub Packages. Para saber mais, confira [Autenticação no GitHub Packages](#authenticating-to-github-packages). 2. Para usar um pacote, adicione `ItemGroup` e configure o campo `PackageReference` no arquivo *.csproj* project. Substitua o valor `PACKAGE_NAME` em `Include="PACKAGE_NAME"` por sua dependência de pacote, e o valor `X.X.X` em `Version="X.X.X"` pela versão do pacote que deseja usar: ```xml Exe netcoreapp3.0 My-app 1.0.0 Octocat GitHub This package adds an Octocat! https://github.com/OWNER/REPOSITORY ``` 3. Instale os pacotes com o comando `restore`. ```shell dotnet restore ``` ## Solução de problemas Se você estiver usando um `GITHUB_TOKEN` para autenticar em um GitHub Packages registro dentro de um GitHub Actions fluxo de trabalho, o token não poderá acessar pacotes baseados em repositório privado em um repositório diferente de onde o fluxo de trabalho está sendo executado. Para acessar pacotes associados a outros repositórios, em vez disso, gere um personal access token (classic) com o `read:packages` escopo e passe esse token como um segredo. ### Erros intermitentes 403 ao restaurar pacotes públicos Se você estiver usando GitHub Packages junto com *nuget.org* e enfrentando erros intermitentes 403 Proibidos ao restaurar pacotes públicos padrão (como `Microsoft.Extensions.*`), isso pode ocorrer porque o NuGet consulta todas as fontes de pacote configuradas para cada pacote. Se a autenticação em GitHub Packages falhar temporariamente, isso poderá bloquear toda a restauração, mesmo para pacotes que não existem em GitHub Packages. Para evitar isso, use o [Mapeamento de Origem do Pacote NuGet](https://learn.microsoft.com/nuget/consume-packages/package-source-mapping) para rotear pacotes para fontes específicas. Substituir: * `NAMESPACE` com o nome da conta pessoal ou organização que tem o feed GitHub Packages do NuGet. * `PACKAGE-ID-PREFIX` com o prefixo de ID de pacote do NuGet que você usa para os pacotes hospedados em GitHub Packages Se você usar vários prefixos, adicione entradas adicionais `` para cada prefixo. ```xml ``` O NuGet usa o [padrão de correspondência mais específico](https://learn.microsoft.com/nuget/consume-packages/package-source-mapping#package-pattern-precedence), de modo que os pacotes que correspondem a `PACKAGE-ID-PREFIX.*` são obtidos apenas de GitHub Packages, enquanto todos os outros pacotes são obtidos de *nuget.org*. Isso também ajuda a evitar ataques de confusão de dependências, garantindo que seus pacotes privados só possam vir apenas do seu feed GitHub Packages. ## Leitura adicional * [Excluir e restaurar um pacote](/pt/packages/learn-github-packages/deleting-and-restoring-a-package)