Publicando um pacote

Você pode publicar um pacote no GitHub Packages para disponibilizar o pacote para que outros façam download e reutilizem.

Quem pode usar esse recurso?

Anyone with write permissions for a repository can publish a package to that repository.

O GitHub Packages está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server 3.0 ou superior.
O GitHub Packages não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. Além disso, as contas que usam planos herdados por repositório não podem acessar registros que oferecem suporte a permissões granulares, pois essas contas são cobradas por repositório. Enterprise Managed Users não têm alocação de armazenamento individual para publicar pacotes no namespace da conta, mas podem publicar no namespace de uma organização. Para obter informações adicionais sobre Enterprise Managed Users, confira “Sobre os Enterprise Managed Users”. Para obter a lista de registros que oferecem suporte a permissões granulares, confira “Sobre permissões para o GitHub Packages”. Para mais informações, confira "Planos do GitHub".

Neste artigo

Sobre os pacotes publicados

Você pode ajudar as pessoas a entender e usar seu pacote fornecendo uma descrição e outros detalhes como, por exemplo, a instalação e instruções de uso na página do pacote. O GitHub Enterprise Cloud fornece metadados para cada versão, como a data de publicação, a atividade de download e as versões recentes. Para ver um exemplo de página de pacote, confira @Codertocat/hello-world-npm.

Você pode publicar pacotes em um repositório público (pacotes públicos) para compartilhá-los com todo o GitHub ou em um repositório privado (pacotes privados) para compartilhá-los com os colaboradores ou uma organização. Um repositório pode ser conectado a mais de um pacote. Para evitar confusão, certifique-se de que o README e a descrição fornecem informações claras sobre cada pacote.

Se uma nova versão de um pacote corrigir uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. GitHub revisa a cada consultoria de segurança publicado e pode usá-lo para enviar Dependabot alerts para repositórios afetados. Para saber mais, confira Sobre os avisos de segurança do repositório.

Publicando um pacote

Note

O GitHub Packages dá suporte apenas à autenticação que usa um personal access token (classic). Para obter mais informações, confira "Gerenciar seus tokens de acesso pessoal".

Você pode publicar um pacote em GitHub Packages usando qualquer cliente do pacote compatível, seguindo as mesmas diretrizes gerais.

  1. Crie ou use um personal access token (classic) existente com os escopos apropriados para a tarefa que deseja realizar. Para saber mais, confira Sobre permissões para o GitHub Packages.
  2. Autentique-se no GitHub Packages usando seu personal access token (classic) e as instruções do cliente do pacote.
  3. Publique o pacote usando as instruções do seu cliente de pacote.

Para obter instruções específicas do cliente do pacote, confira Trabalhar com um registro do GitHub Packages.

Após publicar um pacote, você poderá visualizá-lo no GitHub. Para saber mais, confira Visualizar pacotes.