# Guía de inicio rápido para GitHub Packages

Publicar en GitHub Packages con GitHub Actions.

## Introducción

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

## Publica tu paquete

1. Crea un nuevo repositorio en GitHub, añadiendo `.gitignore` para Node. Para más información, consulta [Crear un repositorio nuevo](/es/repositories/creating-and-managing-repositories/creating-a-new-repository).

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

   ```shell
   git clone https://github.com/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 copy
   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.

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

5. Ejecute `npm install` para generar el archivo `package-lock.json` y, a continuación, registre y suba sus cambios a GitHub.

   ```shell
   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. Copie el siguiente contenido YAML en el `release-package.yml` archivo.

   ```yaml copy
   name: Node.js Package

   on:
     release:
       types: [created]

   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v6
         - uses: actions/setup-node@v4
           with:
             node-version: 20
         - run: npm ci
         - run: npm test

     publish-gpr:
       needs: build
       runs-on: ubuntu-latest
       permissions:
         packages: write
         contents: read
       steps:
         - uses: actions/checkout@v6
         - uses: actions/setup-node@v4
           with:
             node-version: 20
             registry-url: https://npm.pkg.github.com/
         - run: npm ci
         - run: npm publish
           env:
             NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
   ```

8. Indica a npm cuál es el ámbito y el registro en el que publicar paquetes utilizando uno de los siguientes métodos:
   * Agrega un archivo de configuración de npm al repositorio mediante la creación de un archivo `.npmrc` en el directorio raíz con el contenido:

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

   * Edita el archivo `package.json` y especifica la clave `publishConfig`:

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

9. Confirma y sube tus cambios a GitHub.

   ```shell
   $ 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 se superan las pruebas, 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, consulta [Administración de las versiones en un repositorio](/es/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release).

## Visualizar tu paquete publicado

Puedes ver todos los paquetes que has publicado.

1. En GitHub, navegue hasta la página principal del repositorio.
2. En la barra lateral derecha del repositorio, haz clic en **Paquetes**.

   ![Captura de pantalla de la barra lateral de una página de repositorio. La sección "Paquetes" se ha resaltado con el contorno naranja.](/assets/images/help/package-registry/packages-from-repo.png)
3. Busca y haz clic en el nombre del paquete que quieras ver.

## Instalar un paquete publicado

Ahora que publicaste el paquete, querrás utilizarlo como una dependencia en tus proyectos. Para más información, consulta [Gestionar el registro de npm](/es/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package).

## 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 principio de lo que puede hacer con 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.

Combinar GitHub Packages y GitHub Actions puede ayudarle a automatizar casi todos los aspectos de sus procesos de desarrollo de aplicaciones. ¿Ya está listo para comenzar? Estos son algunos recursos útiles para realizar los pasos siguientes con GitHub Packages y GitHub Actions:

* [Aprende sobre GitHub Packages](/es/packages/learn-github-packages) para un tutorial detallado sobre GitHub Packages
* [Escritura de flujos de trabajo](/es/actions/how-tos/write-workflows) para un tutorial detallado en Acciones de GitHub
* [Trabajar con un registro de Paquetes de GitHub](/es/packages/working-with-a-github-packages-registry) para ejemplos y casos de uso específicos