Introdução aos GitHub Packages

GitHub Package Registry é um serviço de hospedagem de pacotes de software que permite que você hospede seus pacotes de software de forma privadaou publicamente e use pacotes como dependências dos seus projetos.

GitHub Package Registry está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server e GitHub AE.

Sobre o GitHub Package Registry

GitHub Package Registry is a package hosting service, fully integrated with GitHub. GitHub Package Registry combina seu código-fonte e pacotes em um só lugar para fornecer gerenciamento integrado de permissões e faturamento, para que você possa centralizar o desenvolvimento do seu software em GitHub Enterprise Server.

Você pode integrar GitHub Package Registry com as APIs de GitHub Enterprise Server, GitHub Actions e webhooks para criar um fluxo de trabalho de ponta a ponta que inclui as suas soluções de código, CI e implantação.

GitHub Package Registry oferece registros de pacotes diferentes para gerentes de pacotes comumente usados, como npm, RubyGems, Apache Maven, Gradle, Docker e NuGet. Para obter mais informações sobre os diferentes registros de pacotes com os quais GitHub Package Registry é compatível, consulte "Trabalhando com um registro de GitHub Package Registry."

Diagrama que mostra compatibilidade para pacotes do registro Docker, RubyGems, npm, Apache Maven, Gradle, NuGet e Docker

Você pode visualizar o LEIAME de um pacote, bem como os metadados como licenciamento, estatísticas de download, histórico de versão e muito mais em GitHub Enterprise Server. Para obter mais informações, consulte "Visualizar pacotes".

Visão geral das permissões e visibilidade do pacote

Permissões
Cada pacote herda as permissões do repositório em que o pacote está hospedado.

Por exemplo, qualquer pessoa com permissões de leitura para um repositório pode instalar um pacote como uma dependência em um projeto, e qualquer pessoa com permissões de gravação pode publicar uma nova versão de pacote.
VisibilidadeVocê pode publicar pacotes em um repositório público (público pacotes) para compartilhar com todas as pessoas na sua empresa ou em um repositório privado (pacotes privados) para compartilhar com os colaboradores ou uma organização.

Para obter mais informações, consulte "Sobre permissões para GitHub Package Registry".

Clientes e formatos compatíveis

O GitHub Package Registry usa os comandos nativos de ferramentas de pacotes com os quais você já está familiarizado para publicar e instalar versões de pacote.

Suporte para registros de pacotes

LinguagemDescriçãoFormato do pacoteCliente do pacote
JavaScriptGerenciador de pacotes de nópackage.jsonnpm
RubyGerenciador de pacotes de RubyGemsGemfilegem
JavaFerramenta de gerenciamento de projetos e compreensão do Apache Mavenpom.xmlmvn
JavaFerramenta de automação do build Gradle para Javabuild.gradle ou build.gradle.ktsgradle
.NETGerenciamento de pacotes NuGet para .NETnupkgdotnet CLI
N/AGerenciamento do contêiner do Dockerarquivo DockerDocker

Observação: O Docker não é compatível quando o isolamento de subdomínio está desativado.

Para obter mais informações sobre o isolamento de subdomínio, consulte "Habilitar o isolamento de subdomínio".

Para obter mais informações sobre a configuração do seu pacote para uso com GitHub Package Registry, consulte "Trabalhar com um registro de GitHub Package Registry".

Autenticar-se no GitHub Package Registry

Você precisa de um token de acesso para publicar, instalar e excluir pacotes no GitHub Package Registry.

Você pode usar um token de acesso pessoal (PAT) para efetuar a autenticação em GitHub Package Registry ou na API de GitHub Ao criar um token de acesso pessoal, você pode atribuir diferentes escopos de token, dependendo da sua necessidade. Para obter mais informações sobre os escopos dos pacotes para um PAT, consulte "Sobre permissões para o GitHub Packages."

Para efetuar a autenticação em um registro do GitHub Package Registry 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 PAT para instalar pacotes associados a outros repositórios privados (que o GITHUB_TOKEN não consegue acessar).

Para obter mais informações sobre GITHUB_TOKEN usado nos fluxos de trabalho de GitHub Actions, consulteAutenticação em um fluxo de trabalho".

Gerenciar pacotes

Você pode excluir uma versão de um pacote privado na interface de usuário de GitHub Enterprise Server ou usando a API do GraphQL.

Ao usar a API do GraphQL para consultar e excluir pacotes privados, você deve usar o mesmo token que você usa para efetuar a autenticação no GitHub Package Registry. Para obter mais informações, consulte "}Excluindo um pacote" e"Realizando chamadas com o GraphQL".

Você pode configurar webhooks para assinar eventos relacionados aos pacotes, como quando um pacote é publicado ou atualizado. Para obter mais informações, consulte o evento de webhook de "pacote".

Entrar em contato com o suporte

Se você precisar de suporte para GitHub Package Registry, entre em contato com os administradores do seu site.

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.