Borrar y restablecer un paquete

Aprende cómo borrar o restablecer un paquete.

el Registro del paquete de GitHub se encuentra disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, Nube de GitHub Enterprise, GitHub Enterprise Server, y GitHub AE.

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 25 descargas de ninguna versión de éste
  • una versión específica de un paquete privado
  • una versíón específica de un paquete púlico, si dicha versión no tiene más de 25 descargas

Nota:

  • No puedes borrar un paquete público específico si alguna de las versiones de éste tiene más de 25 descargas. En este escenario, contacta a Soporte de GitHub para que te proporcionen asistencia.
  • 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

En el caso de los paquetes que heredan sus permisos y accesos de los repositorios, puedes utilizar GraphQL para borrar las versiones de los paquetes específicos.

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 paquetes en Registro del paquete de GitHub con alcance de repositorio incluyen los paquetes:

  • npm
  • RubyGems
  • maven
  • Gradle
  • NuGet
  • Las imágenes de Docker en docker.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME

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 la sección "Permisos necesarios".

  1. En GitHub Enterprise Server, visita la página principal del repositorio.

  2. A la derecha de la lista de archivos, da clic en Paquetes.

    Enlace de paquetes en la página de resumen

  3. Busca y selecciona tu paquete.

  4. En la parte superior derecha de la página de llegada de tu paquete, haz clic en Configuración de paquete. Botón de configuración de paquete

  5. A la izquierda, da clic en Administrar versiones.

  6. A la derecha de la versión que quieres borrar, da clic en y selecciona Borrar versión. Botón de borrar versión del paquete

  7. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en I understand the consequences, delete this version (Comprendo las consecuencias, 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.

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

El siguiente ejemplo demuestra cómo borrar una versión de paquete utilizando una 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 publicaste en Registro del paquete de GitHub, junto con los ID de versión de los paquetes, puedes usar la conexión registryPackagesForQuery. Necesitarás un token con los ámbitos read:packages y repo. Necesitarás un token con los ámbitos read:packages y repo.

Para obtener más información acerca de 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 Server.

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 la sección "Permisos necesarios".

  1. En GitHub Enterprise Server, visita la página principal del repositorio.

  2. A la derecha de la lista de archivos, da clic en Paquetes.

    Enlace de paquetes en la página de resumen

  3. Busca y selecciona tu paquete.

  4. En la parte superior derecha de la página de llegada de tu paquete, haz clic en Configuración de paquete. Botón de configuración de paquete

  5. Debajo de "Zona de Peligro", haz clic en Borrar este paquete.

  6. Para confirmar, revisa el mensaje de confirmación, ingresa el nombre de tu paquete, y haz clic en Entriendo, borrar 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 borraste un paquete de rubygem con el nombre octo-package que tuviera un alcance para el repositorio octo-repo-owner/octo-repo, entonces solo podrías restablecer el paquete si su designador de nombre rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package estuviera disponible todavía, suponiendo que no hayan pasado 30 días.

También debes de cumplir con estos requisitos de permisos:

  • Para los paquetes con alcance de repositorio: Tienes permisos de administrador en el repositorio al que pertenece el paquete que se borró.

Para obtener más información, consulta la sección "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 la configuración de cuenta de tu organización siempre y cuando dicho paquete estuviera en uno de tus repositorios.

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

  1. En GitHub Enterprise Server, navega hasta la página principal de la organización.
  2. Debajo del nombre de tu organización, da clic en Ajustes. Botón de configuración de organización
  3. A la izquierda, da clic en Paquetes.
  4. Debajo de "Paquetes Borrados", junto al paquete que quieres restablecer, haz clic en Restablecer. Botón de restaurar
  5. Para confirmar, teclea el nombre del paquete y haz clic en Entiendo las consencuencias, restablecer este paquete. Botón de confirmación para restablecer 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 restablecer un paquete, consulta la sección "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, da clic en Administrar versiones.
  4. En la parte superior derecha, utiliza el menú desplegable de "Versiones" y selecciona Borrados. Menú desplegable de versiones que muestra la opción borrada
  5. Junto a la versión del paquete que se haya borrado y que quieras restablecer, haz clic en Restablecer. Opción de restablecer junto a la versión de un paquete borrado
  6. Para confirmar, haz clic en Entiendo las consecuencias, restablecer esta versión. Confirmar el restablecimiento de versión de un paquete

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.