Paquetes de GitHub para paquetes de código

Completado

En la unidad anterior, ha visto cómo usar Acciones de GitHub para compilar imágenes de contenedor y publicarlas.

En esta unidad, echaremos un vistazo a los otros paquetes que admite Paquetes de GitHub. GitHub Packages funciona con las herramientas del ecosistema del proyecto actual: npm para paquetes npm, nuget.exe o la CLI de dotnet para paquetes NuGet, etc.

Autenticación en Paquetes de GitHub

La forma de autenticarse en el administrador de paquetes dependerá del ecosistema del proyecto. Con independencia del ecosistema con el que trabaje, necesitará tres datos:

  • El nombre de usuario de GitHub
  • Un token de acceso personal
  • Punto de conexión de Paquetes de GitHub para el ecosistema de paquetes

Generación de un token de acceso personal

Para instalar, publicar o eliminar un paquete, necesita un token de acceso. Al usar el administrador de paquetes, debe generar un token de acceso personal (PAT). Se puede generar un PAT por medio de la configuración del perfil.

Advertencia

Trate los tokens como si fueran contraseñas y manténgalos en secreto.

Inicio de sesión en Paquetes de GitHub

Antes de publicar o instalar paquetes en Paquetes de GitHub, deberá autenticarse en el administrador de paquetes. El punto de conexión es como https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY, donde PACKAGE_TYPE es el tipo de ecosistema de paquetes que se usa.

En la tabla siguiente se muestra el comando que se va a ejecutar para autenticarse en Paquetes de GitHub en función del ecosistema de paquetes:

Ecosistema de paquetes Línea de comandos para autenticarse en Paquetes de GitHub
NuGet dotnet nuget add source https://nuget.pkg.github.com/OWNER/index.json -n github -u OWNER -p [Your PAT Token]
npm bash npm login --registry=https://npm.pkg.github.com
RubyGems echo ":github: Bearer GH_TOKEN" >> ~/.gem/credentials
Maven y Gradle Puede autenticarse directamente durante la inserción.

Si quiere obtener más información sobre cómo usar Paquetes de GitHub con el entorno del proyecto, puede leer la documentación disponible en este vínculo.

Instalación de un paquete

Una vez realizada la autenticación, puede usar fácilmente los paquetes publicados en sus proyectos. En cada página principal del paquete se muestra el comando que se va a ejecutar, en función del entorno del proyecto.

A Package page displays information about how to install it into your project, depending on the project environment.

Administración de paquetes

Los paquetes de GitHub le ofrecen varias formas de administrar fácilmente los ciclos de vida y los flujos de trabajo de sus paquetes.

Puede administrar Paquetes de GitHub mediante la API de GitHub y la API de GraphQL. Estas API permiten admitir escenarios avanzados de integración. Por ejemplo, con la característica webhook de GitHub, puede ejecutar código al publicar un paquete nuevo. Imagine que se encarga del mantenimiento de un proyecto de código abierto. Con webhooks, podría publicar automáticamente un nuevo tweet o una entrada de blog al publicar un nuevo paquete.

También puede usar las Acciones de GitHub para automatizar la administración de paquetes. Con la acción delete-package-versions, puede eliminar de forma automática las versiones más antiguas de los paquetes al publicar una versión nueva.