GitHub Packages para pacotes do código

3 minutos

Na unidade anterior, viu como pode utilizar o GitHub Actions para compilar e publicar imagens de contentor.

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

Autenticar em pacotes do GitHub

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

O seu nome de utilizador no GitHub
Um Token de Acesso Pessoal
O ponto de extremidade dos pacotes GitHub para seu ecossistema de pacotes

Gerar um Token de Acesso Pessoal

Para instalar, publicar ou excluir um pacote, você precisa de um token de acesso. Ao usar seu gerenciador de pacotes, você deve gerar um Token de Acesso Pessoal (PAT). Pode gerar um PAT através das suas definições de perfil.

Aviso

Trate os seus tokens como se fossem palavras-passe e mantenha-os secretos.

Iniciar sessão no GitHub Packages

Antes de publicar ou instalar pacotes do GitHub Packages, terá de fazer a autenticação no seu gestor de pacotes. O ponto de extremidade terá a aparência https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORYde , onde PACKAGE_TYPE é o tipo de ecossistema de pacotes que você está usando.

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

O seu ecossistema de pacotes	Linha de comandos para autenticar no GitHub Package
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 e Gradle	Pode autenticar diretamente durante a emissão.

Se quiser saber mais sobre como utilizar o GitHub Packages com o ambiente do seu projeto, pode ler a documentação aqui.

Instalar um pacote

Quando estiver autenticado, poderá utilizar facilmente pacotes publicados nos seus projetos. A home page de cada pacote mostra o comando a ser executado, consoante o ambiente do projeto.

A Package page displays information about how to install it into your project, depending on the project environment.

Gerenciar pacotes

Os pacotes GitHub oferecem várias maneiras de gerenciar facilmente os ciclos de vida e fluxos de trabalho dos pacotes.

Você pode gerenciar pacotes do GitHub por meio da API do GitHub e da API do GraphQL. Essas APIs permitem-lhe dar suporte a cenários de integração avançada. Por exemplo, com o recurso Webhook do GitHub, você pode executar código quando um novo pacote é publicado. Imagine que é o responsável pela manutenção de um projeto open-source. Com o webhooks, pode publicar automaticamente um novo Tweet ou uma publicação de blogue quando um novo pacote é publicado.