Pacotes do GitHub para pacotes de códigos

Concluído

Na unidade anterior, você viu como usar o GitHub Actions para criar e publicar imagens de contêiner.

Nesta unidade, vamos dar uma olhada nos outros pacotes compatíveis com pacotes do GitHub. Os Pacotes do GitHub funcionam com as ferramentas de ecossistema do projeto atual: npm para pacotes npm, nuget.exe ou a CLI do dotnet para pacotes NuGet etc.

Fazer a autenticação nos Pacotes do GitHub

A maneira como você se autentica no gerenciador de pacotes dependerá do ecossistema do projeto. Seja qual for o ecossistema com o qual você está trabalhando, você precisará de três informações:

  • Seu nome de usuário do GitHub
  • Um token de acesso pessoal
  • O ponto de extremidade dos Pacotes do GitHub do seu ecossistema do pacote

Gerar um token de acesso pessoal

Para instalar, publicar ou excluir um pacote, você precisa de um token de acesso. Ao usar o gerenciador de pacotes, você deve gerar um PAT (Token de Acesso Pessoal). Você pode gerar um PAT por meio de suas configurações de perfil.

Aviso

Trate seus tokens como senhas e mantenha-os em segredo.

Fazer logon nos Pacotes do GitHub

Antes de publicar ou instalar pacotes de pacotes do GitHub, você precisará se autenticar no gerenciador de pacotes. O ponto de extremidade será semelhante a https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY, onde PACKAGE_TYPE representa o tipo de ecossistema de pacotes que você está usando.

A tabela a seguir mostra o comando a ser executado para se autenticar nos Pacotes do GitHub com base no ecossistema de pacotes:

Seu ecossistema de pacotes Linha de comando para autenticar no Pacote do GitHub
NuGet dotnet nuget add source https://nuget.pkg.github.com/OWNER/index.json -n github -u OWNER -p [Your PAT Token]
npm bash npm login --registry=https://npm.pkg.github.com
RubyGems echo ":github: Bearer GH_TOKEN" >> ~/.gem/credentials
Maven &Gradle Você pode se autenticar diretamente ao fazer push.

Se você quiser saber mais sobre como usar pacotes do GitHub com o ambiente do projeto, leia a documentação aqui.

Instalar um pacote

Quando você for autenticado, poderá usar facilmente pacotes publicados em seus projetos. Cada home page do pacote mostra o comando a ser executado, dependendo do ambiente do projeto.

Uma página de pacote exibe informações sobre como instalá-lo em seu projeto, dependendo do ambiente.

Gerenciar pacotes

Os Pacotes do GitHub oferecem várias maneiras de gerenciar facilmente os ciclos de vida e os fluxos de trabalho do pacote.

Você pode gerenciar pacotes do GitHub por meio da API do GitHub e da API do GraphQL. Essas APIs permitem que você dê suporte a cenários de integrações avançadas. Por exemplo, com o recurso Webhook do GitHub, você pode executar código quando um novo pacote é publicado. Imagine que você é um mantenedor de um projeto de software livre. Com webhooks, você pode publicar automaticamente um novo Tweet ou uma postagem no blog quando um novo pacote é publicado.

Você também pode usar o GitHub Actions para automatizar o gerenciamento de pacotes. Com a ação delete-package-versions , você pode podar automaticamente a versão mais antiga de seus pacotes durante a publicação de uma nova versão.