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.
- Cree el sitio y ejecute el Asistente de Configuración para configurar el repo Git,
.envy la base de datos. - Si está actualizando un sitio más antiguo, mueva el antiguo directorio
/var/www/domain/publica/var/www/domain/web_rootantes de cambiar la raíz del documento. - Tras el primer despliegue, ejecute php artisan key:generate desde el ejecutor Artisan si APP_KEY está vacío.
- Ejecute
storage:linkdel corredor Artisan si su aplicación utilizapublicalmacenamiento de disco. - Ejecute
migrate --forcedel 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, correroptimize:clearo reconstruir los caches del corredor Artisan. - Establecer
SESSION_DRIVER=fileodatabase— evitecookieen la producción. - Si usas trabajos en cola, configura
QUEUE_CONNECTION=database(oredis). No usessyncen 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:
- Ir a Servidor → Tareas cron
- 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.