Nota: El Registro del paquete de GitHub se encuentra actualmente en beta para GitHub Enterprise Server 2.22. Para unirte al beta de tu instancia de GitHub Enterprise Server, utiliza el formato de registro.
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 Enterprise Server.
Puedes integrar Registro del paquete de GitHub con las API de GitHub Enterprise Server, 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".
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 Enterprise Server. 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. | |
| Visibilidad | Puedes publicar paquetes en un repositorio público (paquetespúblicos) 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
| Lenguaje | Descripción | Formato del paquete | Cliente del paquete |
|---|---|---|---|
| JavaScript | Gestor de paquetes Node | package.json | npm |
| Ruby | Gestor de paquetes RubyGems | Gemfile | gema |
| Java | Herramienta de administración y comprensión Apache Maven | pom.xml | mvn |
| Java | Herramienta de automatización de construcción Gradle para Java | build.gradle o build.gradle.kts | gradle |
| .NET | Administración del paquete NuGet para .NET | nupkg | dotnet CLI |
| N/A | Plataforma de administración del contenedor Docker | Dockerfile | Docker |
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_TOKENpara 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 privado en la interface de usuario de GitHub Enterprise Server 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.