Introducción a los Paquetes de GitHub

Registro del paquete de GitHub es un paquete de software que hospeda el servicio que te permite hospedar tus paquetes de software de forma privada o públicamente y utiliza los paquetes como dependencias en tus proyectos.

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.


Registro del paquete de GitHub 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 Registro de contenedores ya que estas cuentas se facturan por repositorio. Para obtener más información, consulta la sección "[Productos de GitHub](/get-started/learning-about-github/githubs-products)".

Acerca de Registro del paquete de GitHub

Registro del paquete de GitHub es un servicio de alojamiento de paquetes, totalmente integrado con GitHub. Registro del paquete de GitHub combina tu código fuente y paquetes en un solo lugar para proporcionar una administración de permisos y facturación integradas, para que puedas centralizar tu desarrollo de software en GitHub.

You can integrate Registro del paquete de GitHub with GitHub APIs, GitHub Actions, and webhooks to create an end-to-end DevOps workflow that includes your code, CI, and deployment solutions.

El Registro del paquete de GitHub ofrece diversos registros de paquetes para los adminsitradores de paquetes que se utilizan comunmente, tales como npm, RubyGems, Apache Maven, Gradle, Docker, y NuGet. El Registro de contenedores de GitHub se optimiza para los contenedores y es compatible con imágenes de Docker y OCI. Para obtener más información sobre los diferentes registros de paquete que son compatibles con el Registro del paquete de GitHub, consulta la sección "Trabajar con un registro del Registro del paquete de GitHub".

Diagrama que muestra la compatibilidad de paquetes para el registro, RubyGems, npm, Apache Maven, NuGet y Gradle

Puedes ver el README de un paquete, así como los metadatos tales como el licenciamiento, estadísticas de descarga, historial de la versión y más en GitHub. Para obtener más información, consulta "Visualizar paquetes".

Resumen de los permisos y visibilidad de los paquetes

Permisos
Es posible heredar los permisos para un paquete del repositorio donde este se hospeda o, para los paquetes en el Registro de contenedores, pueden definirse para cuentas de usuario y organización específicas. Para obtener más información, consulta la sección "Configurar la visibilidad y el control de accesos de un paquete".
VisibilidadPuedes publicar paquetes en un repositorio público (paquetespúblicos) para compartir con todo GitHub, o en un repositorio privado (paquetes privados) para compartir con colaboradores o con una organización.

Para obtener más información, consulta la sección "Acerca de los permisos para el Registro del paquete de GitHub".

Acerca de la facturación para Registro del paquete de GitHub

El uso de Registro del paquete de GitHub es gratuito para los paquetes públicos. For private packages, each account on GitHub.com receives a certain amount of free storage and data transfer, depending on the product used with the account. Cualquier uso que no se contemple en las cantidades incluidas se controla con los límites de gasto. Si eres un cliente que factura mensualmente, tu cuenta tendrá un límite de gastos predeterminado de 0 dólares Estadounidenses (USD), lo cual previene el uso adicional de almacenamiento o transferencia de datos después de que alcanzas las cantidades que se incluyen. Si pagas tu cuenta por factura, ésta tendrá un límite de gastos ilimitado predeterminadamente. Para obtner más información, consulta la sección "Acerca de la facturación para el Registro del paquete de GitHub".

Formatos y clientes admitidos

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

Soporte para los registros de paquetes

LenguajeDescripciónFormato del paqueteCliente del paquete
JavaScriptGestor de paquetes Nodepackage.jsonnpm
RubyGestor de paquetes RubyGemsGemfilegema
JavaHerramienta de administración y comprensión Apache Mavenpom.xmlmvn
JavaHerramienta de automatización de construcción Gradle para Javabuild.gradle o build.gradle.ktsgradle
.NETAdministración del paquete NuGet para .NETnupkgdotnet CLI
N/APlataforma de administración del contenedor DockerDockerfileDocker

Para obtener más información sobre cómo configurar tu cliente de paquete para utilizarlo con el Registro del paquete de GitHub, consulta la sección "Trabajar con un registro del Registro del paquete de GitHub".

Para obtener más información sobre Docker y sobre el Registro de contenedores, consulta la sección "Trabajar con el registro de contenedores".

Autenticarte en Registro del paquete de GitHub

You need an access token to publish, install, and delete packages.

You can use a personal access token (PAT) to authenticate to Registro del paquete de GitHub or the GitHub API. When you create a personal access token, you can assign the token different scopes depending on your needs. For more information about packages-related scopes for a PAT, see "About permissions for GitHub Packages."

To authenticate to a Registro del paquete de GitHub registry within a GitHub Actions workflow, you can use:

  • GITHUB_TOKEN to publish packages associated with the workflow repository.
  • a PAT to install packages associated with other private repositories (which GITHUB_TOKEN can't access).

Para obtener más información sobre el GITHUB_TOKEN que se utiliza en los flujos de trabajo de GitHub Actions, consulta la sección "Autenticarse en un flujo de trabajo".

Administrar paquetes

You can delete a package in the GitHub.com user interface or using the REST API. Para obtener más información, consulta la sección "API del Registro del paquete de GitHub".

Cuando usas la API de GraphQL para consultar y eliminar paquetes privados, debes usar el mismo token que usas para autenticarte en Registro del paquete de GitHub. Para obtener más información, consulta las secciones "Borrar y restablecer 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 Registro del paquete de GitHub, usa el formulario de comentarios de para Registro del paquete de GitHub.

Contacta el Soporte de GitHub sobre Registro del paquete de GitHub usando nuestro formulario de contacto si:

  • Experimentas alguna cosa 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

¿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.