Skip to main content

Introdução ao GitHub Packages

O GitHub Packages é um serviço de hospedagem de pacotes de software que permite que você hospede pacotes de software de modo privadoou publicamente e use os pacotes como dependências dos projetos.

O

Sobre o GitHub Packages

GitHub Packages é uma plataforma para hospedar e gerenciar pacotes, incluindo contêineres e outras dependências. GitHub Packages combina seu código-fonte e pacotes em um só lugar para fornecer gerenciamento integrado de permissões, para que você possa centralizar o desenvolvimento do seu software em GitHub Enterprise Server.

Você pode integrar GitHub Packages às APIs de GitHub Enterprise Server, GitHub Actions e webhooks para criar um fluxo de trabalho de ponta a ponta que inclui seu código, CI e soluções de implantação.

GitHub Packages 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 Packages tem suporte, confira "Trabalhar com um registro GitHub Packages".

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, confira "Como ver pacotes".

Para obter mais informações sobre a configuração do GitHub Packages no GitHub Enterprise Server, confira "Introdução ao GitHub Packages para sua empresa".

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

PermissõesCada 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 (pacotes públicos) para compartilhá-los com todos na sua empresa ou em um repositório privado (pacotes privados) para compartilhá-los com os colaboradores ou uma organização.

Para obter mais informações, confira "Sobre as permissões para o GitHub Packages".

Clientes e formatos compatíveis

O GitHub Packages 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/DGerenciamento do contêiner do DockerDockerfileDocker

Observação: ao habilitar o registro do Docker, é altamente recomendável também habilitar o isolamento de subdomínio. Para obter mais informações, confira "Como habilitar o isolamento de subdomínio".

Para obter mais informações sobre como configurar seu cliente de pacote para uso com GitHub Packages, confira " Trabalhar com um registro GitHub Packages".

Autenticar-se no GitHub Packages

Você precisa de um token de acesso para publicar, instalar e excluir pacotes.

Você pode usar um PAT (token de acesso pessoal) para se autenticar no GitHub Packages ou na API do GitHub Enterprise Server. Ao criar um token de acesso pessoal, você pode atribuir diferentes escopos de token, dependendo da sua necessidade. Para obter mais informações sobre escopos relacionados a pacotes para um PAT, confira "Sobre as permissões para pacotes do GitHub".

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 PAT para instalar pacotes associados a outros repositórios privados (que não podem ser acessados pelo GITHUB_TOKEN).

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

Como gerenciar pacotes

Você pode excluir um pacote privado ou público na interface de usuário do GitHub Enterprise Server. Ou para pacotes com escopo de repositório, você pode excluir uma versão de um pacote privado usando o 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 Packages.

Para obter mais informações, confira Como excluir e restaurar um pacote" e "Como criar 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, confira o " evento de webhook package".

Entrar em contato com o suporte

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