Consejos

Consejos prácticos y problemas frecuentes al ejecutar aplicaciones Laravel en Herne.

Lista de comprobación del primer despliegue

Migración de public a web_root — Si estas migrando un sitio antiguo, mueve primero el directorio public/ a web_root antes de cambiar la raiz del documento.

  1. Cree el sitio y ejecute el Asistente de Configuración para configurar el repo Git, .env y la base de datos.
  2. Si está actualizando un sitio más antiguo, mueva el antiguo directorio /var/www/domain/public a /var/www/domain/web_root antes de cambiar la raíz del documento.
  3. Tras el primer despliegue, ejecute php artisan key:generate desde el ejecutor Artisan si APP_KEY está vacío.
  4. Ejecute storage:link del corredor Artisan si su aplicación utiliza publicalmacenamiento de disco.
  5. Ejecute migrate --force del corredor Artisan o active el paso migratorio en Deploy Config.

Reintentar la instalación rápida

Si WebBlocks CMS Quick Install falla, abra los registros de la aplicación, corrija la base de datos reportada, permiso, DNS o número de tiempo de ejecución, utilice Instalación de reingreso. El instalador limpia los archivos parciales seguros antes de reintentar y protege las instalaciones terminadas de ser sobrescrito.

Buenas prácticas para el entorno

  • Establezca APP_ENV=production y APP_DEBUG=false en .env para todos los sitios en producción.
  • Después de cambiar .env, correr optimize:clear o reconstruir los caches del corredor Artisan.
  • Establecer SESSION_DRIVER=file o database — evite cookie en la producción.
  • Si usas trabajos en cola, configura QUEUE_CONNECTION=database (o redis). No uses sync en producción.

DNS y SSL

  • La propagación del DNS puede tomar tiempo. Mantenga un registro desactualiza estrictamente; no ignore un nombre de host señalando en el servidor incorrecto.
  • Los administradores pueden añadir varias cuentas de Hetzner DNS bajo Administración → Conexiones DNS. Adjuntar cada dominio a la conexión que posee su zona.
  • Si una zona se mueve a otra cuenta de Hetzner, actualice la ficha o adjunte el dominio a la nueva conexión, utilice Reconectar la zona DNS.
  • Para las zonas DNS externas migradas, las advertencias de ápice NS pueden ser informativas cuando el registro A es correcto.
  • Después de añadir alias, use Ajustes → SSL / HTTPS → Volver a sincronizar SSL por lo que Herne comprueba la cobertura de certificados en vivo.

Corregir el tipo de aplicación

Si un sitio fue creado como Vacío / destino de despliegue o Sitio estático, pero un operador más tarde desplegó Laravel en su canónica web_root con la raíz del documento /public, un administrador puede abrir Sitio → Ajustes → General → Entorno de la aplicación y elegir Cambio a Laravel.

Esto solo corrige los metadatos de gestión de Herne. No instala Laravel, inspecciona ni repara la aplicación, mueve archivos, cambia Nginx, ejecuta migraciones ni inicia un proceso de cola. Verifica por separado la aplicación desplegada antes de confirmar. Después, ejecuta la comprobación previa de cada función exclusiva de Laravel.

Procesos de cola

Herne no administra trabajadores de cola. Para dirigir a los trabajadores de la cola:

  1. Ir a Servidor → Tareas cron
  2. Añade: * * * * * cd /var/www/domain && php artisan queue:work --stop-when-empty >> /dev/null 2>&1

Esto dirige al trabajador cada minuto y sale cuando la cola está vacía (a diferencia de un proceso de larga duración bajo cron).

Permisos de almacenamiento

Si usted recibe autorización denegada errores en storage/ o bootstrap/cache/, se ejecuta desde la Terminal:

chmod -R 775 storage bootstrap/cache

Primera carga lenta

Después de habilitar el caché de config/route a través de Deploy Config, la primera solicitud después de un nuevo despliegue puede ser lenta mientras que OPcache se calienta. Esto es normal.

Recursos de WebBlocks UI

Herne carga WebBlocks UI a través resources/views/partials/_webblocks-assets.blade.php y App\Support\WebBlocksUiAssets. No agregue nuevas referencias a la carpeta de activos eliminada /public/webblocks-ui.