Configure el exportador de Node.js para WordPress estático

Static Publisher usa una CLI instalada por separado, @smart-cloud/publisher-exporter, para las tareas de rastreo e implementación. El plugin de WordPress no incluye Node.js, Playwright ni el árbol de fuentes del exportador.

Requisitos del host

El host del ejecutor necesita:

  • Node.js (se recomienda la versión LTS más reciente como base),
  • binarios de navegador de Playwright,
  • acceso al shell para cron, CI o ejecuciones manuales,
  • acceso al sistema de archivos del directorio de ejecución del plugin,
  • credenciales de AWS solo en la máquina que realiza las operaciones de implementación o invalidación.

Instalar el exportador

Instalación global

npm install -g @smart-cloud/publisher-exporter
publisher-exporter install-browsers

Instalación como paquete local

mkdir -p /opt/smartcloud/publisher-exporter
cd /opt/smartcloud/publisher-exporter
npm init -y
npm install @smart-cloud/publisher-exporter
npx @smart-cloud/publisher-exporter install-browsers

Si el entorno del ejecutor se comparte entre usuarios o servicios, dirige Playwright a un directorio compartido de navegadores antes del paso de instalación:

export PLAYWRIGHT_BROWSERS_PATH=/var/lib/playwright-browsers
publisher-exporter install-browsers

Campos importantes de la administración de WordPress

En la interfaz de administración de Static Publisher:

  • establezca External exporter dir si quiere que los diagnósticos del lado de PHP verifiquen la instalación de la CLI,
  • mantenga los directorios runtime, output y log alineados con el sistema de archivos visible para el host del ejecutor,
  • active Allow self-signed TLS certificates during crawl solo cuando el origen usa un certificado interno o no público.

Los valores habituales del directorio del exportador son:

  • /usr/local/lib/node_modules/@smart-cloud/publisher-exporter
  • /opt/smartcloud/publisher-exporter/node_modules/@smart-cloud/publisher-exporter

Primeras pruebas de humo

Ejecute primero un comando directo del exportador:

PUBLISHER_CONFIG=./publisher.config.json publisher-exporter crawl

Después valida el procesamiento de la cola con el directorio de ejecución de WordPress:

publisher-exporter queue-runner \
--runtime-dir /var/www/site/wp-content/uploads/smartcloud-static-publisher/runtime \
--max-jobs 1

Si prefiere no instalarlo globalmente, sustituye publisher-exporter por npx @smart-cloud/publisher-exporter.

Modelo mental recomendado

El exportador es infraestructura, no una subcarpeta oculta del plugin. Instálalo y ejecútalo donde ya reside su automatización de implementación.