Guía de inciio rápido para GitHub Packages

Introducción

En esta guía, crearás un flujo de trabajo de GitHub Actions para probar tu código y luego lo publicarás en el GitHub Packages.

Publicar tu paquete

1. Cree un nuevo repositorio en GitHub y agregue el archivo .gitignore para Node. Para más información, vea "Creación de un repositorio".

2. Clone el repositorio en la máquina local.

   $ git clone https://YOUR-HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY.git
   $ cd YOUR-REPOSITORY

3. Cree un archivo index.js y agregue una alerta básica que diga "Hello, world!".

   JavaScript

   console.log("Hello, World!");

4. Inicialice un paquete de npm con npm init. En el asistente para la inicialización de paquetes, escriba el paquete con el nombre : @YOUR-USERNAME/YOUR-REPOSITORY y establezca el script de prueba en exit 0. Esto generará un archivo package.json con información sobre el paquete.

   $ npm init
     ...
     package name: @YOUR-USERNAME/YOUR-REPOSITORY
     ...
     test command: exit 0
     ...    

5. Ejecute npm install para generar el archivo package-lock.json y, después, confirme e inserte los cambios en GitHub.

   $ npm install
   $ git add index.js package.json package-lock.json
   $ git commit -m "initialize npm package"
   $ git push

6. Cree un directorio .github/workflows. En este directorio, cree un archivo denominado release-package.yml.

7. Copia el siguiente contenido YAML en el archivo release-package.yml, reemplazando YOUR-HOSTNAME por el nombre de tu empresa.

   YAML

   name: Node.js Package
   
   on:
     release:
       types: [created]
   
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v2
         - uses: actions/setup-node@v2
           with:
             node-version: 12
         - run: npm ci
         - run: npm test
   
     publish-gpr:
       needs: build
       runs-on: ubuntu-latest
       permissions:
         packages: write
         contents: read
       steps:
         - uses: actions/checkout@v2
         - uses: actions/setup-node@v2
           with:
             node-version: 12
             registry-url: https://npm.YOUR-HOSTNAME.com/
         - run: npm ci
         - run: npm publish
           env:
             NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

8. Dile a NPM en qué alcance y registro publicar paquetes para utilizar uno de los siguientes métodos:

   • Agregue un archivo de configuración de NPM para el repositorio mediante la creación de un archivo .npmrc en el directorio raíz con el contenido:

     @YOUR-USERNAME:registry=https://npm.pkg.github.com

   • Edite el archivo package.json y especifique la clave publishConfig:

     "publishConfig": {
        "@YOUR-USERNAME:registry": "https://npm.pkg.github.com"
      }

9. Confirma y sube tus cambios a GitHub.

   $ git add .github/workflows/release-package.yml
   # Also add the file you created or edited in the previous step.
   $ git add .npmrc or package.json
   $ git commit -m "workflow to publish package"
   $ git push

10. El flujo de trabajo que creaste se ejecutará cuando sea que se cree un lanzamiento nuevo en tu repositorio. Si las pruebas pasan, entonces el paquete se publicará en GitHub Packages.

    Para probar esto, vaya a la pestaña Code (Código) del repositorio y cree una nueva versión. Para más información, vea "Administración de las versiones en un repositorio".

Visualizar tu paquete publicado

Puedes ver todos los paquetes que has publicado.

1. En your GitHub Enterprise Server instance, vaya a la página principal del repositorio. 1. A la derecha de la lista de archivos, haz clic en Versiones. 1. Da clic en el nombre del paquete que quieres ver.

Instalar un paquete publicado

Ahora que publicaste el paquete, querrás utilizarlo como una dependencia en tus proyectos. Para obtener más información, vea "Trabajo con el registro npm".

Pasos siguientes

El flujo básico que acabas de agregar se ejecuta en cualquier momento que se cree un lanzamiento nuevo en tu repositorio. Pero esto es solo el inicio de lo que puedes hacer con el GitHub Packages. Puedes publicar tu paquete en varios registros con un solo flujo de trabajo, activar el flujo de trabajo para que se ejecute en eventos diferentes tales como una solicitud de cambios fusionada, administrar contenedores, y más.

El combinar el GitHub Packages y las GitHub Actions puede ayudarte a automatizar casi cualquier aspecto de tu proceso de desarrollo de aplicaciones. ¿Ya está listo para comenzar? Aquí hay algunos recursos útiles para llevar a cabo los siguientes pasos con el GitHub Packages y las GitHub Actions:

• Consulte "Más información sobre GitHub Packages" para obtener un tutorial detallado sobre los paquetes de GitHub.
• Consulte "Más información sobre GitHub Actions" para obtener un tutorial en profundidad sobre Acciones de GitHub.
• Consulte "Trabajo con un registro de GitHub Packages" para obtener casos de uso y ejemplos específicos.