Excluir e restaurar um pacote

Saiba como excluir ou restaurar um pacote.

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.


O GitHub Package Registry 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 os planos de legado por repositório não podem acessar o Container registry já que essas contas são cobradas por repositório. Para obter mais informações, consulte os "[produtos do GitHub](/get-started/learning-about-github/githubs-products)".

Exclusão de pacote e suporte de restauração em GitHub

Em GitHub se você tiver o acesso necessário, você poderá excluir:

  • um pacote privado inteiro
  • um pacote público inteiro, se não houver mais de 5000 downloads de qualquer versão do pacote
  • uma versão específica de um pacote privado
  • uma versão específica de um pacote público, se a versão do pacote não tiver mais de 5000 downloads

Observação:

  • Você não pode excluir um pacote público se uma versão do pacote tiver mais de 5000 downloads. Neste caso, entre em contato com o suporte do GitHub para obter mais assistência.
  • Ao excluir pacotes públicos, esteja ciente de que você pode quebrar projetos que dependem do seu pacote.

Em GitHub, você também pode restaurar um pacote inteiro ou uma versão do pacote, se:

  • Você restaurar o pacote dentro de 30 dias após a exclusão.
  • O mesmo namespace do pacote ainda estiver disponível e não for usado para um novo pacote.

Suporte de API de pacotes

Você pode usar a API REST para gerenciar seus pacotes. Para obter mais informações, consulte o "API de GitHub Package Registry".

Para pacotes que herdam suas permissões e acesso dos repositórios, você pode usar o GraphQL para excluir uma versão específica de pacotes. A GitHub Package Registry API do GraphQL API não é compatível com contêineres ou imagens Docker que usam o namespace do pacote https://ghcr.io/OWNER/PACKAGE-NAME. Para obter mais informações sobre o suporte do GraphQL, consulte "Excluir uma versão de um pacote com escopo de repositório com GraphQL".

Permissões necessárias para excluir ou restaurar um pacote

Para pacotes que herdam as permissões de acesso dos repositórios, é possível excluir um pacote se você tiver permissões de administrador para o repositório.

Os pacotes com escopo de repositório em GitHub Package Registry incluem estes pacotes:

  • npm
  • RubyGems
  • maven
  • Gradle
  • NuGet

Para excluir um pacote que tem permissões granulares separadas de um repositório, como imagens de contêiner armazenadas em https://ghcr.io/OWNER/PACKAGE-NAME, você deverá ter acesso de administrador ao pacote.

Excluir a versão de um pacote

Excluir uma versão de um pacote com escopo de repositório em GitHub

Para excluir uma versão de um pacote com escopo do repositório, você deve ter permissões de administrador para o repositório ao qual o pacote pertence. Para obter mais informações, consulte "Permissões necessárias".

  1. No GitHub.com, navegue até a página principal do repositório.

  2. À direita da lista de arquivos, clique em Packages (Pacotes).

    Link dos pacotes na página de visão geral

  3. Procurar e selecionar o seu pacote.

  4. Na parte superior direita da página inicial de seu pacote, clique em Configurações do pacote. Botão de configurações do pacote

  5. À esquerda, clique em Gerenciar versões.

  6. À direita da versão que você deseja excluir, clique em e selecione Excluir versão. Botão para excluir a versão do pacote

  7. Para confirmar a exclusão, digite o nome do pacote e clique em Eu entendo as consequências. Exclua esta versão. Botão de confirmar exclusão de pacote

Excluir uma versão de um pacote com escopo do repositório com o GraphQL

Para pacotes que herdam suas permissões e acesso dos repositórios, você pode usar o GraphQL para excluir uma versão específica de pacotes.

O GraphQL não é compatível com contêineres ou imagens Docker em ghcr.io. Use a mutação deletePackageVersion na API do GraphQL. Você deve usar um token com os escopos read:packages, delete:packages e repo. For more information about tokens, see "About GitHub Package Registry."

O exemplo a seguir demonstra como excluir uma versão do pacote, usando um packageVersionId de MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg.

curl -X POST \
-H "Accept: application/vnd.github.package-deletes-preview+json" \
-H "Authorization: bearer TOKEN" \
-d '{"query":"mutation { deletePackageVersion(input:{packageVersionId:\"MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg==\"}) { success }}"}' \
HOSTNAME/graphql

To find all of the private packages you have published to GitHub Package Registry, along with the version IDs for the packages, you can use the registryPackagesForQuery connection. Você vai precisar de um token com os escopos read:packages e repo. For more information, see the packages connection or the PackageOwner interface.

Para obter mais informações sobre a mutação deletePackageVersion, consulte "deletePackageVersion".

Você não pode excluir diretamente um pacote inteiro usando o GraphQL, mas se você excluir todas as versões de um pacote, o pacote não será mostrado em GitHub.

Excluindo uma versão de pacote com escopo do usuário em GitHub

Para excluir uma versão específica de um pacote com escopo de usuário em GitHub, como para uma imagem Docker em ghcr. o, siga estas etapas. Para excluir um pacote inteiro, consulte "Excluir todo um pacote com escopo do usuário em GitHub".

Para revisar quem pode excluir uma versão de pacote, consulte "Permissões necessárias".

  1. Em GitHub, acesse a página principal da sua conta de usuário.
  2. In the top right corner of GitHub.com, click your profile photo, then click Your profile. Foto de perfil
  3. Na sua página de perfil, no canto superior direito, clique em Pacotes. Opção de pacotes na página de perfil
  4. Procurar e selecionar o seu pacote.
  5. Na parte superior direita da página inicial de seu pacote, clique em Configurações do pacote. Botão de configurações do pacote
  6. À esquerda, clique em Gerenciar versões.
  7. À direita da versão que você deseja excluir, clique em e selecione Excluir versão. Botão para excluir a versão do pacote
  8. Para confirmar a exclusão, digite o nome do pacote e clique em Eu entendo as consequências. Exclua esta versão. Botão de confirmar exclusão de pacote

Excluir uma versão de um pacote com escopo da organização no GitHub

Para excluir uma versão específica de um pacote com escopo de organização em GitHub, como para uma imagem Docker em ghcr.io, siga estas etapas. Para excluir um pacote inteiro, consulte "Excluir todo um pacote com escopo da organização em GitHub".

Para revisar quem pode excluir uma versão de pacote, consulte "Permissões necessárias".

  1. Em GitHub, acesse a página principal da sua organização.

  2. No nome da sua organização, clique em Pacotes.

    Packages tab on org landing page

  3. Procurar e selecionar o seu pacote.

  4. Na parte superior direita da página inicial de seu pacote, clique em Configurações do pacote. Botão de configurações do pacote

  5. À esquerda, clique em Gerenciar versões.

  6. À direita da versão que você deseja excluir, clique em e selecione Excluir versão. Botão para excluir a versão do pacote

  7. Para confirmar a exclusão, digite o nome do pacote e clique em Eu entendo as consequências. Exclua esta versão. Botão para confirmar a exclusão da versão do pacote

Excluindo um pacote inteiro

Excluindo um pacote com escopo de repositório completo em GitHub

Para excluir todo um pacote com escopo do repositório, você deve ter permissões de administrador no repositório que possui o pacote. Para obter mais informações, consulte "Permissões necessárias".

  1. No GitHub.com, navegue até a página principal do repositório.

  2. À direita da lista de arquivos, clique em Packages (Pacotes).

    Link dos pacotes na página de visão geral

  3. Procurar e selecionar o seu pacote.

  4. Na parte superior direita da página inicial de seu pacote, clique em Configurações do pacote. Botão de configurações do pacote

  5. Em "zona de perigo", clique em Excluir este pacote.

  6. Para confirmar, revise a mensagem de confirmação, digite o nome do seu pacote e clique em Eu compreendo, exclua este pacote. Botão de confirmar exclusão de pacote

Excluir um pacote inteiro com escopo do usuário em GitHub

Para revisar quem pode excluir um pacote, consulte "Permissões necessárias".

  1. Em GitHub, acesse a página principal da sua conta de usuário.
  2. In the top right corner of GitHub.com, click your profile photo, then click Your profile. Foto de perfil
  3. Na sua página de perfil, no canto superior direito, clique em Pacotes. Opção de pacotes na página de perfil
  4. Procurar e selecionar o seu pacote.
  5. Na parte superior direita da página inicial de seu pacote, clique em Configurações do pacote. Botão de configurações do pacote
  6. À esquerda, clique em Opções. Opção do menu "Opções"
  7. Em "Zona de Perigo" clique em Excluir este pacote. Botão para excluir a versão do pacote
  8. Para confirmar a exclusão, digite o nome do pacote e clique em Eu entendo as consequências. Exclua este pacote. Botão para confirmar a exclusão da versão do pacote

Excluir um pacote inteiro com escopo da organização em GitHub

Para revisar quem pode excluir um pacote, consulte "Permissões necessárias".

  1. Em GitHub, acesse a página principal da sua organização.

  2. No nome da sua organização, clique em Pacotes.

    Packages tab on org landing page

  3. Procurar e selecionar o seu pacote.

  4. Na parte superior direita da página inicial de seu pacote, clique em Configurações do pacote. Botão de configurações do pacote

  5. À esquerda, clique em Opções. Opção do menu "Opções"

  6. Em "Zona de Perigo" clique em Excluir este pacote. Botão de excluir pacote

  7. Para confirmar a exclusão, digite o nome do pacote e clique em Eu entendo as consequências. Exclua este pacote. Botão de confirmar exclusão de pacote

Restaurando pacotes

Você pode restaurar um pacote ou versão excluído, se:

  • Você restaurar o pacote dentro de 30 dias após a exclusão.
  • O mesmo namespace e versão do pacote ainda estiverem disponíveis e não forem reutilizados para um novo pacote.

Por exemplo, se você tem um pacote de rubygem excluído denominado octo-package que teve o escopo definido como repositório octo-repo-owner/octo-repo, você só poderá restaurar o pacote se o namespace do pacote rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package ainda estiver disponível, e 30 dias ainda não passaram.

Você também deve atender a um destes requisitos de permissão:

  • Para pacotes com escopo de repositório: Você tem permissões de administrador no repositório ao qual o pacote excluído pertence.
  • Para pacotes com escopo de conta de usuário: Sua conta de usuário é proprietária do pacote excluído.
  • Para os pacotes com escopo da organização: Você tem permissões de administrador para o pacote excluído na organização que é proprietário do pacote.

Para obter mais informações, consulte "Permissões necessárias".

Uma vez restaurado o pacote, este usará o mesmo namespace de antes. Se o mesmo namespace não estiver disponível, você não poderá restaurar seu pacote. Neste cenário, para restaurar o pacote excluído, você deverá excluir o novo pacote que usa o namespace do pacote excluído primeiro.

Restaurando um pacote de uma organização

Você pode restaurar um pacote excluído por meio das configurações da conta da sua organização, desde que o pacote esteja em um dos seus repositórios ou tenha permissões granulares e tenha o escopo na conta da organização.

Para revisar quem pode restaurar um pacote em uma organização, consulte "Permissões necessárias".

  1. No GitHub.com, navegue para a página principal da organização.
  2. Abaixo do nome da sua organização, clique em Settings. Botão de configurações da organização
  3. À esquerda, clique em Pacotes.
  4. Em "Pacotes excluídos", ao lado do pacote que você deseja restaurar, clique em Restaurar. Botão de restaurar
  5. Para confirmar, digite o nome do pacote e clique em Eu entendo as consequências, restaure este pacote. Restaurar botão de confirmação do pacote

Restaurar um pacote com escopo de conta de usuário

Você pode restaurar um pacote excluído por meio das configurações da sua conta de usuário, se o pacote estiver em um de seus repositórios ou escopo para sua conta de usuário. Para obter mais informações, consulte "Permissões necessárias".

  1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações. Ícone Settings (Configurações) na barra de usuário
  2. À esquerda, clique em Pacotes.
  3. Em "Pacotes excluídos", ao lado do pacote que você deseja restaurar, clique em Restaurar. Botão de restaurar
  4. Para confirmar, digite o nome do pacote e clique em Eu entendo as consequências, restaure este pacote. Restaurar botão de confirmação do pacote

Restaurando uma versão do pacote

Você pode restaurar uma versão do pacote a partir da página inicial do seu pacote. Para revisar quem pode restaurar um pacote, consulte "Permissões necessárias".

  1. Acesse a página inicial do seu pacote.
  2. À direita, clique em Configurações do pacote.
  3. À esquerda, clique em Gerenciar versões.
  4. No canto superior direito, use o menu suspenso "Versões" e selecione Excluído. Menu suspenso de versões que mostra a opção excluída
  5. Ao lado da versão excluída do pacote que você deseja restaurar, clique em Restaurar. Restaurar opção ao lado de uma versão excluída do pacote
  6. Para confirmar, clique em Eu entendo as consequências, restaure esta versão. Confirmar restauração da versão do pacote

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.