Despliegue

Configure una URL de repositorio Git, rama y ruta de despliegue en la pestaña Despliegue.

Configuración del despliegue

Despliegue con Git es el flujo de redespliegue basado en repositorios y webhook. Úsalo cuando Herne debe tirar de una rama de repositorio Git guardada a la demanda o del Webhook firmado por el sitio.

Vaya a Sitios → Despliegue → Despliegue con Git y llene:

  • URL del repositorio — URL HTTPS o SSH (p. ej., git@github.com:user/repo.git)
  • Rama — rama desde la que se despliega (por defecto: main)
  • Ruta de despliegue — la raíz del sitio está fijada en /var/www/example.com/web_root. Solo puedes añadir un sufijo permitido, como /current.

La ruta de despliegue siempre queda dentro de web_root del sitio actual. Se rechazan los segmentos que suben de directorio, como ...

Modos de la raíz del sitio

Los nuevos sitios eligen un modo de raíz explícito durante la creación. Vacío / destino de despliegue y Aplicación gestionada con Publisher comienzan con sólo /var/www/example.com/web_root; Herne no crea una carpeta vacía public/ para esos modos. Aplicación Laravel y Sitio estáticocomienzan con web_root/public porque su tiempo de ejecución inicial necesita una raíz de documento público.

Los sitios existentes guardan sus ahorros document_root. El tiempo de ejecución sigue preparando raíces públicas heredadas para los registros existentes que se crearon antes de que existieran modos de raíz.

Usuario del entorno y validación

Los despliegues se ejecutan dentro de la ruta del proyecto actual. Las salidas existentes tienen su origin remoto sincronizado con la URL del repositorio guardado antes de buscar/reset, lo que evita que las URL del repositorio de escombros desplieguen silenciosamente código antiguo.

Después de que se apliquen los ajustes de afectamiento de tiempo de ejecución, Herne valida el config generado Nginx/runtime antes de recargar. Si la validación falla, el cambio escenificado se vuelve a rodar en lugar de dejar un config activo roto.

Pasos de compilación

Permitir los pasos que la aplicación gestionada necesita. Corren en este orden después de git pull:

  1. composer install --no-dev --optimize-autoloader
  2. npm ci && npm run build sólo para aplicaciones administradas que envían su propio canal de construcción de frontend
  3. php artisan migrate --force
  4. php artisan config:cache && php artisan route:cache && php artisan view:cache

Herne Panel usa recursos estáticos. No usa Vite, Tailwind, npm, archivos de bloqueo, public/build ni public/hot. La casilla opcional de npm solo se aplica al sitio que despliegas. No afecta al entorno del panel ni al paquete de actualización.

Repositorios privados (claves de despliegue)

Para repositorios privados, genere una clave de despliegue y añádala a GitHub / GitLab como clave de solo lectura.

  1. Vaya a Sitios → Despliegue → Despliegue con Git y haga clic Generar clave de despliegue.
  2. Copia la clave pública que aparece en pantalla.
  3. En GitHub: Repositorio → Ajustes → Claves de despliegue → Añadir clave. Pruebe la llave. El acceso solo lectura es suficiente.
  4. Abre Repositorio → Ajustes → Repositorio → Claves de despliegue en GitLab.

La clave de despliegue es un teclado ed25519 almacenado en storage/app/deploy-keys/. Sólo la clave pública se muestra en el panel.

Iniciar un despliegue

Haga clic en Desplegar ahora para obtener el código más reciente y ejecutar los pasos configurados. Navegue a Sitios → Despliegue → Despliegue con Git y haga clic en el botón Despliegue ahora.

Registros de despliegue

Todos los despliegues quedan registrados — haga clic en cualquier entrada en Despliegues recientes para ver la salida completa. Cada entrada de registro muestra la salida completa de la cáscara, código de salida, y si el despliegue tuvo éxito o falló.

Despliegue con Publisher

La pantalla Sitios → Despliegue → Despliegue con Publisher admite despliegues sin GitHub de Publisher. El servidor publicitario, producto y canal puede ser recordado por sitio; Herne no asume un producto predeterminado. Sitios sin un uso del servidor guardado https://publisher.webblocksui.com, el servidor de Editores canónicos para las versiones estándar actuales; cualquier otro servidor se introduce como URL HTTPS personalizada.

Cree el producto y genere una clave de producto Publisher en la gestión de productos Publisher, después pega esa clave en el formulario de implementación Herne. Herne utiliza la clave para las solicitudes de metadatos y artefactos de Publisher. Las claves pegadas no se persisten por defecto, pero se pueden guardar encriptadas por sitio, reemplazadas o limpiadas.

Herne envía la clave al servidor de Publisher seleccionado para solicitar los metadatos de la versión y el artefacto. Descarga el ZIP, verifica su suma de comprobación SHA-256, lo extrae en un directorio de preparación y aplica el perfil de seguridad seleccionado. Los artefactos de Laravel se instalan con laravel_app en la ruta de despliegue del sitio. Los artefactos estáticos usan static_site solo para sitios estáticos de Herne y se instalan en el directorio raíz público real del sitio. En la raíz solo se permiten index.html, robots.txt, assets/**, games/**, site/**, favicon.ico, manifest.json y version.json. Para los recursos estáticos se usa un perfil con una lista de bloqueo. Así pueden desplegarse archivos generados por Flutter para la web, como games/*/main.dart.js, games/*/icons/**, games/*/assets/shaders/*.frag, games/*/assets/packages/** y games/*/canvaskit/**, rutas de recursos del producto como site/webblocks-play/css/site.css y archivos NOTICES. Se bloquean las rutas ocultas, los intentos de salir del directorio de destino, los archivos de copia de seguridad o temporales, la configuración del servidor y los archivos ejecutables o del lado del servidor. En una actualización estática segura, si el artefacto no contiene el archivo index.html, Herne conserva el del directorio raíz público copiándolo al directorio de preparación. Si no hay un archivo de índice ni en el directorio de preparación ni en la raíz existente, el despliegue se cancela antes de aplicarse.

  • Si el destino está vacío, el despliegue con Publisher realiza la instalación inicial.
  • Si el paquete incluye una raíz pública, el primer despliegue con Publisher cambia a web_root/public y aplica el entorno de Laravel o de sitio estático.
  • Para una aplicación Laravel existente, el despliegue con Publisher exige una confirmación explícita, guarda una instantánea de los archivos modificados y realiza una actualización segura.
  • Sitio estático existente: Publisher Deploy acepta metadatos explícitos static-site/static_site, muestra una advertencia de sustitución en lugar del bloqueador Laravel, requiere reconocimiento, establece una raíz pública de sustitución, y verifica index.html después de aplicar.
  • Los objetivos no vacíos que no parecen aplicaciones Laravel están bloqueados para la seguridad.
  • Las claves de producto que se pierden bloquean el despliegue antes de que comiencen los pasos de metadatos, descarga de artefactos, verificación de cheques, extracción o post-desplome.
  • Se rechazan las entradas ZIP inseguras, incluidas las rutas que salen del directorio de destino, las rutas absolutas, los enlaces simbólicos detectables, los segmentos de punto, .env, .git, .github, las carpetas de dependencias en la raíz, storage/, bootstrap/cache/, los archivos generados al compilar el frontend y los archivos de bloqueo de npm, Yarn y pnpm. Los directorios de dependencias se bloquean en la raíz. Se permiten las vistas publicadas de Laravel en resources/views/vendor/ que sustituyen a las originales.
  • Los fallos de inspección de artefactos muestran el primer camino relativo rechazado y la razón en el registro de despliegue sin exponer fichas, caminos temporales, caminos absolutos del servidor, o huellas de pila.
  • Existiendo .env, storage/, bootstrap/cache/, se conservan cargas y archivos de tiempo de ejecución.
  • Los pasos de aplicación y post-deploy deben ejecutarse como el usuario configurado de tiempo de ejecución/deplorar que puede escribir el árbol de destino. Los sitios gestionados por Herne estándar utilizan el modelo de propiedad y grupo de tiempo de ejecución www-data.
  • El preflight de la autorización comprueba la raíz de destino, el artefacto aplica objetivos, directorios de tiempo de ejecución de Laravel, bootstrap/cache y el objetivo Composer vendor antes de aplicar. Los permisos inseguros abortan antes de que los archivos sean cambiados.
  • Los pasos opcionales posteriores al despliegue pueden ejecutarse composer install --no-dev --prefer-dist --optimize-autoloader, php artisan migrate --force, y optimizar/definir.
  • Si .env falta, se saltan pasos artesanales post-deploy y el registro de despliegue explica el siguiente paso.

Publisher Deploy es reutilizable para cualquier producto Publisher compatible, incluyendo WebBlocks Workbench, CMS, Plugins, QuizTem o productos futuros. Las actualizaciones posteriores pueden ser tomadas a través de Publisher Deploy o a través de la pantalla de actualizaciones del sistema del producto cuando se dispone de uno.

Instalar aplicaciones rápidamente

Deploy sigue siendo la herramienta adecuada para aplicaciones basadas en Git. Para aplicaciones compatibles, Sitios → Aplicaciones → Instalación rápida puede crear una aplicación sin un paso de implementación del repositorio. WebBlocks CMS prepara la aplicación CMS y genera credenciales de base de datos. Laravel App crea sólo un esqueleto Laravel más reciente limpio, marca el tiempo de funcionamiento del sitio como Laravel, y deja los productos de paquete como QuizTem para ser instalado después a través de Composer o Terminal. Quick Install acepta un directorio vacío web_rooto vacío public/, pero rechaza archivos ya existentes arbitrarios y no los elimina automáticamente.

Webhook de despliegue por sitio

Cada sitio con una configuración de despliegue guardada también obtiene su propia tarjeta webhook en la página Git Deploy.

  • URL — POST /sites/{site}/webhook/deploy
  • Clave secreta — generados automáticamente y mostrados en el panel
  • Cabeza de firma — envía X-Hub-Signature-256 con la firma HMAC-SHA-256 del cuerpo JSON sin modificar
  • Filtro de rama — los empujes a otras ramas se ignoran automáticamente

Configurar GitHub

  1. Abra la configuración de su webhook de repositorio en GitHub
  2. Establecer la URL de carga útil al valor mostrado en la página de Git Deploy del sitio
  3. Use application/json como tipo de contenido
  4. Pegar el secreto generado de Herne en el campo secreto webhook
  5. Seleccione el evento empujar

Este Webhook per-site es para aplicaciones de inquilinos sólo se implementa. Actualizar Herne es un flujo de administración solo separado — ver la pantalla Actualizaciones del Grupo, que aplica WebBlocks Publisher libera en lugar de un Webhook.