Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Acerca de GitHub Packages

GitHub Packages es un servicio de alojamiento de paquete de software que te permite alojar tus paquetes de software de forma privada o pública y usar paquetes como dependencias en tus proyectos.

GitHub Packages se encuentra disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, y GitHub One. GitHub Packages no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Para obtener más información, consulta la sección "Productos de GitHub".

En este artículo

Acerca de paquetes

Un paquete es un software autocontenido y reutilizable que incluye código y metadatos, como el número de versión actual, nombre y las dependencias del paquete, que un desarrollador agrupa en un lugar común para que otros lo usen. Los paquetes simplifican el uso y la distribución de soluciones a problemas comunes como la necesidad de un marco común para desarrollar un proyecto, pruebas de ejecutores y limpiadores para mejorar la calidad del código o introducir herramientas de aprendizaje automático estándar en la industria para alimentar tu aplicación.

Acerca de GitHub Packages

GitHub Packages es un servicio de alojamiento de paquetes, totalmente integrado con GitHub. GitHub Packages combina tu código fuente y tus paquetes en un solo lugar para proporcionar facturación y gestión de permisos integrada, para que puedas centralizar tu desarrollo de software en GitHub.

Puedes publicar paquetes en un repositorio público (paquetes públicos) para compartir con todo GitHub, o en un repositorio privado (paquetes privados) para compartirlos con colaboradores o con una organización. Puedes utilizar los roles y equipos de GitHub para limitar quién puede instalar o publicar cada paquete, ya que los paquetes heredan los permisos del repositorio. Cualquier persona con permisos de lectura para un repositorio puede instalar un paquete como una dependencia en un proyecto, y cualquier persona con permisos de escritura puede publicar una nueva versión del paquete.

Puedes alojar múltiples paquetes en un repositorio y ver más información acerca de cada paquete al ver el README del paquete, las estadísticas de descarga, el historial de la versión y mucho más.

Puedes integrar GitHub Packages con las API de GitHub, GitHub Actions y webhooks para crear un flujo de trabajo de DevOps de extremo a extremo que incluya tu código, CI y soluciones de implementación.

Acerca de la facturación para GitHub Packages

El uso de GitHub Packages es gratuito para los paquetes públicos. Para los paquetes privados, cada cuenta de GitHub recibe una cantidad determinada de almacenamiento gratuito y de transferencia de datos, dependiendo del producto que se utilice en la cuenta. Predeterminadamente, tu cuenta tendrá un límite de gastos de $0, lo cual previene el uso adicional de almacenamiento o transferencia de datos después de que alcanzas el límite de las cantidades incluidas. Si incrementas tu límite de gastos por encima del $0 predeterminado, se te cobrará por cualquier almacenamiento o transferencia de datos extra, también llamados excedentes, hasta el tope del límite de gastos que hayas configurado. No podrán aplicarse los cupones que tenga tu cuenta para los excedentes de GitHub Packages. Para obtener más información, consulta "Acerca de la facturación para GitHub Packages".

Formatos y clientes admitidos

GitHub Packages usa los comandos de herramientas del paquete nativo con los que ya estás familiarizado para publicar e instalar versiones del paquete.

GitHub Packages actualmente admite estos clientes y formatos.

Cliente del paqueteLenguajeFormato del paqueteDescripción
npmJavaScriptpackage.jsonGestor de paquetes Node
gemaRubyGemfileGestor de paquetes RubyGems
mvnJavapom.xmlHerramienta de administración y comprensión Apache Maven
gradleJavabuild.gradle o build.gradle.ktsHerramienta de automatización de construcción Gradle para Java
dockerN/ADockerfilePlataforma de administración del contenedor Docker
dotnet CLI.NETnupkgAdministración del paquete NuGet para .NET

Para obtener más información acerca de la configuración de tu cliente de paquete para usar con GitHub Packages, consulta Usar GitHub Packages con el ecosistema de tu proyecto."

Sobre tokens

Necesitas de un token de acceso para publicar, instalar, y borrar paquetes en GitHub Packages. Puedes utilizar un token de acceso personal para autenticarte con tu nombre de usuario directamente en GitHub Packages o en la API de GitHub. Puedes utilizar un GITHUB_TOKEN para autenticarte utilizando un flujo de trabajo de GitHub Actions.

Cuando creas un token de acceso personal, puedes asignar al token diferentes ámbitos en función de tus necesidades. Para obtener más información, consulta las secciones "Crear un token de acceso personal" y "Alcances disponibles".

Para instalar o publicar un paquete, debes usar un token con el ámbito adecuado, y tu cuenta de usuario debe tener los permisos pertinentes para ese repositorio.

Por ejemplo:

  • Para descargar e instalar paquetes desde un repositorio, tu token debe tener el ámbito read:packages, y tu cuenta de usuario debe tener permisos de lectura para el repositorio. Si el repositorio es privado, tu token también debe tener el ámbito repo.
  • Para eliminar una versión especificada de un paquete privado en GitHub, tu token debe tener los ámbitos delete:packages y repo. Los paquetes públicos no se pueden eliminar. Para obtener más información, consulta "Eliminar un paquete".
ÁmbitoDescripciónPermisos de repositorio
read:packagesDescarga e instala paquetes de GitHub Packageslectura
write:packagesCarga y publica paquetes en GitHub Packagesescritura
delete:packagesElimina versiones especificadas de paquetes privados de GitHub Packagesadmin
repoInstala, carga y elimina determinados paquetes en repositorios privados (junto con read:packages, write:packages o delete:packages)lectura, escritura o admin

Cuando creas un flujo de trabajo de GitHub Actions, puedes usar el GITHUB_TOKEN para publicar e instalar paquetes en GitHub Packages sin la necesidad de almacenar y administrar un token de acceso personal. Para obtener más información, consulta "Usar GitHub Packages con GitHub Actions".

Administrar paquetes

Puedes eliminar una versión de un paquete privado en GitHub o usar la API de GraphQL. Cuando usas la API de GraphQL para consultar y eliminar paquetes privados, debes usar el mismo token que usas para autenticarte en GitHub Packages. Para obtener más información, consulta las secciones "Borrar un paquete" y "Formar llamadas con GraphQL".

Puedes configurar webhooks para suscribirte a eventos relacionados con paquetes, como cuando se publica o se actualiza un paquete. Para obtener más información, consulta el "evento de webhook de package".

Contactar con soporte técnico

Si tienes comentarios o solicitudes de características para GitHub Packages, usa el formulario de comentarios de para GitHub Packages.

Contacta el Soporte de GitHub sobre GitHub Packages usando nuestro formulario de contacto si:

  • Encuentras algo que contradice la documentación
  • Encuentras errores vagos o poco claros
  • Tu paquete publicado contiene datos confidenciales, como violaciones del RGPD, claves de API o información de identificación personal

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos