Skip to main content

Borrar y restablecer un paquete

Aprende cómo borrar o restablecer un paquete.

GitHub Packages está disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server 3.0 o superior y GitHub AE.
GitHub Packages no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Las cuentas que utilicen los planes tradicionales por repositorio tampoco podrán acceder al Container registry ya que estas cuentas se facturan por repositorio. Para más información, vea "Productos de GitHub".

Soporte para borrado y restablecimiento de paquetes en GitHub

En GitHub, si tienes el acceso necesario, puedes borrar:

  • todo un paquete privado
  • todo un paquete público, si es que no hay más de 5000 descargas de ninguna versión de este
  • una versión específica de un paquete privado
  • una versión específica de un paquete público, si la versión del paquete no tiene más de 5000 descargas

Nota:

  • No puedes eliminar un paquete público específico si alguna versión del paquete tiene más de 5000 descargas. Ante este escenario, ponte en contacto con el equipo de soporte técnico de GitHub para obtener más ayuda.
  • Cuando borres paquetes públicos, toma en cuenta que podrías dañar proyetos que dependen de ellos.

En GitHub, también puedes restablecer un paquete completo o una versión de paquete si:

  • Restableces el paquete dentro de los primeros 30 días después de que se borró.
  • El espacio de nombre del paquete aún se encuentra disponible y no se ha utilizado en un paquete nuevo.

Soporte de la API de paquetes

Puedes utiliza la API de REST para administrar tus paquetes. Para obtener más información, consulta "API GitHub Packages".

En el caso de los paquetes que heredan sus permisos y acceso desde repositorios, puedes usar GraphQL para eliminar una versión específica de paquete. La API de GraphQL de GitHub Packages no admite contenedores ni imágenes de Docker que usan el espacio de nombres del paquete https://ghcr.io/OWNER/PACKAGE-NAME ni imágenes npm que usan el espacio de nombres del paquete https://npm.pkg.github.com/OWNER/PACKAGE-NAME. Para obtener más información sobre la compatibilidad con GraphQL, consulta «Eliminación de una versión de un paquete con ámbito de repositorio con GraphQL».

Permisos necesarios para borrar o restablecer un paquete

En el caso de los paquetes que heredan sus permisos de acceso de los repositorios, puedes borrar un paquete si tienes permisos administrativos en el repositorio.

Los registros GitHub Packages que se mencionan a continuación solo utilizan permisos con ámbito de repositorio:

: Imágenes de Docker en docker.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME

  • Registro de RubyGems
  • Registro de Apache maven
  • Registro de NuGet

Para Container registry and npm registry, puedes optar por permitir que los paquetes estén en el ámbito de un usuario o una organización, o vinculados a un repositorio.

Para eliminar un paquete que tenga permisos pormenorizados separados de un repositorio, tales como imágenes de contenedor que se almacenan en https://ghcr.io/OWNER/PACKAGE-NAME o https://npm.pkg.github.com/OWNER/PACKAGE-NAME, debes tener acceso de administrador al paquete. Para más información, vea "Acerca de los permisos para GitHub Packages".

Borrar la versión de un paquete

Borrar la versión de un paquete con alcance de repositorio en GitHub

Para borrar una versión de un paquete con alcance de repositorio debes tener permisos de administrador en el repositorio al que pertenezca dicho paquete. Para obtener más información, consulta "Permisos necesarios".

  1. En GitHub.com, vaya a la página principal del repositorio. 1. A la derecha de la lista de archivos, haz clic en Versiones. Vínculo a los paquetes en la página de información general del repositorio 3. Busca y selecciona tu paquete.
  2. En la parte superior derecha de la página de aterrizaje del paquete, haga clic en Package settings (Configuración del paquete). Botón de configuración del paquete
  3. A la izquierda, haz clic en Administrar versiones.
  4. A la derecha de la versión que quieres eliminar, haz clic en y selecciona Eliminar versión. Botón para eliminar la versión del paquete
  5. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero eliminar esta versión. Botón para confirmar la eliminación del paquete

Borrar una versión de un paquete con alcance de repositorio con GraphQL

En el caso de los paquetes que heredan sus permisos y acceso de los repositorios, puedes utilizar a GraphQL para borrar las versiones específicas de estos.

La API de GraphQL de GitHub Packages no admite contenedores ni imágenes de Docker que usan el espacio de nombres del paquete https://ghcr.io/OWNER/PACKAGE-NAME ni imágenes npm que usan el espacio de nombres del paquete https://npm.pkg.github.com/OWNER/PACKAGE-NAME. Sin embargo, puedes usar la API de REST. Para obtener más información, consulta «API de GitHub Packages».

Usa la mutación deletePackageVersion en GraphQL API. Debes usar un token con los ámbitos read:packages, delete:packages y repo. Para obtener más información, consulta "Acerca de GitHub Packages."

En el ejemplo siguiente se muestra cómo eliminar una versión de paquete mediante un elemento 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

Para encontrar todos los paquetes privados que has publicado en GitHub Packages, junto con los identificadores de versión de los paquetes, puedes usar la conexión packages mediante el objeto repository. Necesitarás un token con los ámbitos read:packages y repo. Para obtener más información, consulta la conexión packages o la interfaz PackageOwner.

Para obtener más información sobre la mutación deletePackageVersion, consulta "deletePackageVersion".

No puedes borrar directamente todo un paquete utilizando GraphQL, pero si borras cada versión de un paquete, este ya no se mostrará en GitHub Enterprise Cloud.

Borrar una versión de un paquete con alcance de usuario en GitHub

Para eliminar una versión específica de un paquete con ámbito de usuario en GitHub, como una imagen de Docker en ghcr.io, sigue estos pasos. Para eliminar un paquete completo, consulta "Eliminación de un paquete de ámbito de usuario completo en GitHub."

Para revisar quién puede eliminar una versión del paquete, consulta "Permisos necesarios".

  1. En GitHub, navega hasta la página principal de tu cuenta personal.
  2. En la esquina superior derecha de GitHub.com, haga clic en la foto de perfil y luego en Your profile (Su perfil). Foto de perfil
  3. En la página de perfil, en la parte superior derecha, haga clic en Paquetes. Opción Paquetes en la página de perfil 3. Busca y selecciona tu paquete.
  4. En la parte superior derecha de la página de aterrizaje del paquete, haga clic en Package settings (Configuración del paquete). Botón de configuración del paquete
  5. A la izquierda, haz clic en Administrar versiones.
  6. A la derecha de la versión que quieres eliminar, haz clic en y selecciona Eliminar versión. Botón para eliminar la versión del paquete
  7. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero eliminar esta versión. Botón para confirmar la eliminación del paquete

Borrar una versión de un paquete con alcance de organización en GitHub

Para eliminar una versión específica de un paquete con ámbito de organización en GitHub, como una imagen de Docker en ghcr.io, sigue estos pasos. Para eliminar un paquete completo, consulta "Eliminación de un paquete de ámbito de organización completo en GitHub."

Para revisar quién puede elimninar una versión de paquete, consulta "Permisos necesarios para eliminar o restaurar un paquete."

  1. En GitHub, navega a la página principal de tu organización.
  2. Debajo del nombre del organización, haga clic en Packages. Pestaña Packages de la página de aterrizaje de la organización 3. Busca y selecciona tu paquete.
  3. En la parte superior derecha de la página de aterrizaje del paquete, haga clic en Package settings (Configuración del paquete). Botón de configuración del paquete
  4. A la izquierda, haz clic en Administrar versiones.
  5. A la derecha de la versión que quieres eliminar, haz clic en y selecciona Eliminar versión. Botón para eliminar la versión del paquete
  6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero eliminar esta versión. Botón para confirmar la eliminación de la versión del paquete

Borrar un paquete completo

Borrar un paquete completo con alcance de repositorio en GitHub

Para borrar un paquete completo con alcance de repositorio, debes tener permisos administrativos en el repositorio al que pertenezca dicho paquete. Para obtener más información, consulta "Permisos necesarios".

  1. En GitHub.com, vaya a la página principal del repositorio. 1. A la derecha de la lista de archivos, haz clic en Versiones. Vínculo a los paquetes en la página de información general del repositorio 3. Busca y selecciona tu paquete.
  2. En la parte superior derecha de la página de aterrizaje del paquete, haga clic en Package settings (Configuración del paquete). Botón de configuración del paquete
  3. En "Zona de peligro", haz clic en Eliminar este paquete.
  4. Para confirmarlo, revisa el mensaje de confirmación, escribe el nombre de tu paquete y haz clic en Lo entiendo y quiero eliminar este paquete. Botón para confirmar la eliminación del paquete

Borrar un paquete completo con alcance de usuario en GitHub

Para revisar quién puede eliminar un paquete, consulta "Permisos necesarios".

  1. En GitHub, navega hasta la página principal de tu cuenta personal.
  2. En la esquina superior derecha de GitHub.com, haga clic en la foto de perfil y luego en Your profile (Su perfil). Foto de perfil
  3. En la página de perfil, en la parte superior derecha, haga clic en Paquetes. Opción Paquetes en la página de perfil 3. Busca y selecciona tu paquete.
  4. En la parte superior derecha de la página de aterrizaje del paquete, haga clic en Package settings (Configuración del paquete). Botón de configuración del paquete
  5. A la izquierda, haz clic en Opciones. Opción de menú "Opciones"
  6. En "Zona de peligro", haz clic en Eliminar este paquete. Botón para eliminar la versión del paquete
  7. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero eliminar este paquete. Botón para confirmar la eliminación de la versión del paquete

Borrar un paquete completo con alcance de organización en GitHub

Para revisar quién puede eliminar un paquete, consulta "Permisos necesarios".

  1. En GitHub, navega a la página principal de tu organización.
  2. Debajo del nombre del organización, haga clic en Packages. Pestaña Packages de la página de aterrizaje de la organización 3. Busca y selecciona tu paquete.
  3. En la parte superior derecha de la página de aterrizaje del paquete, haga clic en Package settings (Configuración del paquete). Botón de configuración del paquete
  4. A la izquierda, haz clic en Opciones. Opción de menú "Opciones"
  5. En "Zona de peligro", haz clic en Eliminar este paquete. Botón para eliminar el paquete
  6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero eliminar este paquete. Botón para confirmar la eliminación del paquete

Restablecer paquetes

Puedes restablecer un paquete o versión que hayas borrado si:

  • Restableces el paquete dentro de los primeros 30 días después de que se borró.
  • El mismo designador de nombre del paquete y su versión se encuentran disponibles y no se han reutilizado para un paquete nuevo.

Por ejemplo, si tienes un paquete RubyGems eliminado denominado octo-package que tenía como ámbito el repositorio octo-repo-owner/octo-repo, solo puedes restaurar el paquete si el espacio de nombres rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package del paquete todavía está disponible y aún no han transcurrido 30 días.

Para restaurar un paquete eliminado, también debes cumplir uno de estos requisitos de permisos:

  • Para los paquetes con ámbito de repositorio: tienes permisos de administrador para el repositorio que posee el paquete eliminado.
  • Para los paquetes con ámbito de cuenta de usuario: el paquete eliminado pertenece a tu cuenta de usuario.
  • Para los paquetes con ámbito de organización: tienes permisos de administrador para el paquete eliminado en la organización que posee el paquete.

Para obtener más información, consulta "Permisos necesarios".

Una vez que se restablezca el paquete, este utilizará el designador de nombre que ya tenía. Si ya no está disponible el mismo designador de nombre del paquete, no podrás restablecerlo. En este caso, para restablecer el paquete que se borró, primero deberás borrar el paquete nuevo que utiliza el designador de nombre del paquete que se borró.

Restablecer un paquete en una organización

Puedes restablecer un paquete borrado a través de los ajustes de cuenta de tu organización, siempre y cuando el paquete estuviera en el repositorio que pertenece a esta o tuviera permisos granulares y se le hubiera configurado un alcance para tu cuenta de organización.

Para revisar quién puede restaurar un paquete en una organización, consulta "Permisos necesarios".

  1. En GitHub.com, vaya hasta la página principal de la organización. 1. Debajo del nombre de la organización, haga clic en Settings. Botón de configuración de la organización
  2. En la izquierda, haga clic en Packages.
  3. En "Paquetes eliminados", junto al paquete que quieres restaurar, haz clic en Restaurar. Botón Restaurar
  4. Para confirmar, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero restaurar este paquete. Botón de confirmación para restaurar el paquete

Restablecer un paquete con alcance de cuenta de usuario

Puedes restaurar un paquete que se haya eliminado mediante la configuración de tu cuenta de usuario, siempre y cuando haya estado en uno de tus repositorios o haya tenido como ámbito tu cuenta de usuario. Para obtener más información, consulta "Permisos necesarios".

  1. En la esquina superior derecha de cualquier página, haga clic en la foto del perfil y, luego, en Settings (Configuración).

    Icono Settings (Parámetros) en la barra de usuario

  2. En la izquierda, haga clic en Packages.

  3. En "Paquetes eliminados", junto al paquete que quieres restaurar, haz clic en Restaurar. Botón Restaurar

  4. Para confirmar, escribe el nombre del paquete y haz clic en Entiendo las consecuencias y quiero restaurar este paquete. Botón de confirmación para restaurar el paquete

Restablecer la versión de un paquete

Puedes restablecer una versión de paquete desde la página de llegada del mismo. Para revisar quién puede restaurar un paquete, consulta "Permisos necesarios".

  1. Navega a la página de llegada de tu paquete.
  2. A la derecha, haz clic en Configuración del paquete.
  3. A la izquierda, haz clic en Administrar versiones.
  4. A la derecha, usa el menú desplegable "Versiones" y selecciona Eliminado. Menú desplegable de versiones que muestra la opción eliminada
  5. Junto a la versión del paquete eliminado que quieres restaurar, haz clic en Restaurar. Opción de restablecer junto a la versión de un paquete eliminado
  6. Para confirmarlo, haz clic en Entiendo las consecuencias y quiero restaurar esta versión. Confirmación de la restauración de la versión del paquete