Guía de inicio rápido para Packages

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

Cree un nuevo repositorio en y agregue el archivo .gitignore para Node. Para más información, consulta Crear un repositorio nuevo.
Clone el repositorio en la máquina local.
```
git clone https://.com/YOUR-USERNAME/YOUR-REPOSITORY.git
cd YOUR-REPOSITORY
```
Cree un archivo index.js y agregue una alerta básica que diga "Hello, world!".
JavaScript
```
console.log("Hello, World!");
```
```
console.log("Hello, World!");
```
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
  ...
```

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

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

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

Copie el siguiente contenido YAML en el archivo release-package.yml.

YAML

name: Node.js Package

on:
  release:
    types: [created]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - 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@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          registry-url: https://npm.pkg..com/
      - run: npm ci
      - run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{secrets._TOKEN}}

name: Node.js Package

on:
  release:
    types: [created]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - 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@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          registry-url: https://npm.pkg..com/
      - run: npm ci
      - run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{secrets._TOKEN}}

Dile a npm en qué ámbito y registro publicar paquetes para usar 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:
```
@YOUR-USERNAME:registry=https://npm.pkg..com
```
- Edita el archivo package.json y especifica la clave publishConfig:
```
"publishConfig": {
  "@YOUR-USERNAME:registry": "https://npm.pkg..com"
}
```

Confirma y sube tus cambios a .

$ git add ./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

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

Puedes ver todos los paquetes que has publicado.

En , navegue hasta la página principal del repositorio.
En la barra lateral derecha del repositorio, haz clic en Paquetes.
Busca y haz clic en el nombre del paquete que quieras ver.

Ahora que publicaste el paquete, querrás utilizarlo como una dependencia en tus proyectos. Para más información, consulta Trabajar con el registro de npm.

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 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 Packages y las 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 Packages y las Actions:

Aprende sobre Packages para un tutorial detallado sobre Packages
Escritura de flujos de trabajo para un tutorial detallado en Acciones de
Trabajar con un registro de Paquetes de para ejemplos y casos de uso específicos

Guía de inicio rápido para Packages

En este artículo