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 para los usuarios específicos o internamente para tu empresa 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.

Nota: El Registro del paquete de GitHub se encuentra actualmente en beta para GitHub AE.

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 integradas, para que puedas centralizar tu desarrollo de software en GitHub AE.

Puedes integrar Registro del paquete de GitHub con las API de GitHub AE, 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.

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. 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 ue muestra la compatibilidad de paquetes para el registro de Docker, RubyGems, npm, Apache Maven, Gradle, NuGet y Docker

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 AE. Para obtener más información, consulta "Visualizar paquetes".

Resumen de los permisos y visibilidad de los paquetes

Permisos
Cada paquete hereda los permisos del repositorio en donde este mismo se hospeda.

Por ejemplo, cualquiera con permisos de lectura en un repositorio puede instalar un paquete como una dependencia en un proyecto y cualquiera con permisos de escritura puede publicar una versión nueva de un paquete.
VisibilidadPuedes publicar paquetes en un repositorio interno (paquetesinternos) para compartir con todos en tu empresa, 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".

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

Autenticarte en Registro del paquete de GitHub

Necesitas de un token de acceso para publicar, instalar, y borrar paquetes en Registro del paquete de GitHub.

Puees utilizar un token de acceso personal (PAT) para autenticarte en el Registro del paquete de GitHub o en la API de GitHub. 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 sobre los alcances relacionados con los paquetes para un PAT, consulta la sección "Acerca de los permisos para los Paquetes de GitHub".

Para autenticarte en un registro del Registro del paquete de GitHub dentro de un flujo de trabajo de GitHub Actions, puedes utilizar:

  • GITHUB_TOKEN para publicar los paquetes asociados con el repositorio del flujo de trabajo.
  • un PAT para instalar los paquetes asociados con otros repositorios privados (a los cuales no puede acceder el GITHUB_TOKEN).

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

Puedes borrar una versión de un paquete en la interface de usuario de GitHub AE o utilizar 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 Registro del paquete de GitHub. 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 necesitas soporte para Registro del paquete de GitHub, por favor, contacta a tus administradores de sitio.

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