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.
Você pode integrar GitHub Package Registry com as APIs de GitHub, 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. GitHub Container registry é otimizado para contêineres e é compatível com imagens do Docker e OCI. 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."
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. Para obter mais informações, consulte "Visualizar pacotes".
Visão geral das permissões e visibilidade do pacote
| Permissões | |
| As permissões para um pacote são herdadas do repositório em que o pacote está hospedado ou, para pacotes em Container registry, eles podem ser definidos para contas específicas de usuário ou organização. Para obter mais informações, consulte "Configurar o controle de acesso e visibilidade de um pacote". | |
| Visibilidade | Você pode publicar pacotes em um repositório público (público pacotes) para compartilhar com todo o tipo de GitHub 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".
Sobre a cobrança do GitHub Package Registry
O uso de GitHub Package Registry é gratuito para pacotes públicos. Para pacotes privados, cada conta GitHub recebe uma certa quantidade de armazenamento gratuito e transferência de dados, dependendo do produto usado com a conta. Qualquer uso para além dos montantes incluídos é controlado por limites de despesa. If you are a monthly-billed customer, your account will have a default spending limit of 0 US dollars (USD), which prevents additional usage of storage or data transfer after you reach the included amounts. Se você pagar a sua conta por fatura, sua conta terá um limite de gastos padrão ilimitado. Para obter mais informações, consulte "Sobre a cobrança do 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
| Linguagem | Descrição | Formato do pacote | Cliente do pacote |
|---|---|---|---|
| JavaScript | Gerenciador de pacotes de nó | package.json | npm |
| Ruby | Gerenciador de pacotes de RubyGems | Gemfile | gem |
| Java | Ferramenta de gerenciamento de projetos e compreensão do Apache Maven | pom.xml | mvn |
| Java | Ferramenta de automação do build Gradle para Java | build.gradle ou build.gradle.kts | gradle |
| .NET | Gerenciamento de pacotes NuGet para .NET | nupkg | dotnet CLI |
| N/A | Gerenciamento do contêiner do Docker | arquivo Docker | Docker |
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".
Para obter mais informações sobre o Docker e o Container registry, consulte "Trabalhando com o registro do contêiner".
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_TOKENpara publicar pacotes associados ao repositório do fluxo de trabalho.- um PAT para instalar pacotes associados a outros repositórios privados (que o
GITHUB_TOKENnã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 um pacote na interface de usuário GitHub ou usando a API REST. Para obter mais informações, consulte o "API de GitHub Package Registry".
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 e restaurando 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ê tiver comentários ou solicitações de recursos para GitHub Package Registry, use o formulário de feedback para GitHub Package Registry.
Entre em contato com Suporte do GitHub sobre GitHub Package Registry usando o nosso formulário de contato se:
- Você encontrar qualquer coisa que contradiga a documentação
- Você encontra erros vagos ou pouco claros
- Seu pacote publicado contém dados confidenciais, como violações do RGPD, chaves API ou informações de identificação pessoal