Publicar es llevar el sitio que construiste en tu computadora a un servidor de hosting, con su contenido, para que responda en su dirección real. Con la skill de Velk es un pedido: la primera vez la IA pregunta lo que no sabe, inspecciona el servidor, envía todo y revisa el resultado.
Esta página trata del primer despliegue (deploy). Después de él, el sitio en línea es el real: los cambios siguientes salen como publicaciones del tema (Publicar cambios) y las nuevas versiones de Velk como actualizaciones (Actualizar Velk).
Antes de empezar
-
Acceso SSH
SSH es la conexión segura de tu computadora con el servidor, que se abre con una clave en lugar de una contraseña. Actívalo en el panel del hosting, en la sección Acceso SSH (Hostinger usa el puerto 65002). Los planes compartidos intermedios suelen tenerlo, los básicos muchas veces no, un VPS (un servidor virtual propio) siempre lo tiene.
-
Una base de datos y sus cuatro datos
Crea la base de datos y su usuario en el panel del hosting: Velk no puede crearlos ahí. Anota host (normalmente
localhost), nombre, usuario y contraseña tal como aparecen, con el prefijo, como enu12345678_lumen. -
El dominio
Apunta el dominio al servidor, o al menos empieza: el DNS, la guía telefónica de internet, tarda de minutos a horas en propagar un cambio.
-
La dirección canónica
Elige una dirección oficial, con o sin www, siempre con https. Se convierte en
APP_URLen el.envdel servidor (su archivo de configuración), y de ella salen el sitemap, elrobots.txty las etiquetas canónicas. Si publicas con una dirección provisoria, todo eso sigue apuntando a ella hasta que alguien lo note.
Pídele a la IA
Crea una clave SSH para mí y muéstrame la parte pública, para pegarla en el panel del hosting.
La parte pública va al servidor; la privada nunca sale de tu computadora.
Pídele a la IA
Sube este sitio por primera vez a mi hosting de Hostinger. Es el sitio de la Clínica Lumen y la dirección oficial es https://www.clinicalumen.example, con www. El SSH ya está activo y creé la base de datos en el panel.
La primera vez, la IA pregunta lo que todavía no sabe. Guarda las respuestas, y en los pedidos siguientes no pregunta nada.
Lo que la IA pregunta la primera vez
| Pregunta | Qué responder |
|---|---|
| SSH | Dirección, puerto y usuario, que están en el panel del hosting. La IA se conecta con la clave, nunca con contraseña. |
| Carpeta en el servidor | La ruta completa donde vivirá el sitio, como /home/u123456789/domains/clinicalumen.example/public_html en Hostinger (la raíz del documento, en el panel). La IA nunca la deduce de la dirección. |
| Dirección | La dirección canónica con https (con http, la IA te avisa) y, si el sitio no está en la raíz del dominio, la subcarpeta. |
| Base de datos del servidor | Nombre, usuario y contraseña tal como los creó el panel; el host solo si no es localhost. |
| Base de datos local | Nada: la IA la lee del .env de tu proyecto. |
Lo que hace la IA
Guarda las respuestas en .deploy/ssh.json, que solo tú puedes leer y que queda fuera de Git, y las prueba. Después:
- Mira el servidor primero, y se detiene si la carpeta ya tiene Velk.
- Se niega a subir problemas: un motor editado, o las páginas originales de un sitio HTML convertido que quedaron en el tema.
- Envía los archivos: motor, tema,
storage/uploads/y el.htaccess, el archivo de reglas del servidor web. Nunca tu.envlocal, el.gitni la configuración de despliegue. - Escribe el
.envdel servidor con tus respuestas, conAPP_DEBUG=false, protegido para que otras cuentas del servidor no lo lean. Tus credenciales locales nunca suben. - Copia tu base de datos local a la del servidor y ejecuta
migrate, las actualizaciones de base de datos del motor: páginas, entradas, medios y usuarios del panel llegan como estaban. - Termina: escribe el
robots.txtcon la dirección real del sitemap y comprueba que la página de inicio responde.
Revisar el sitio en línea
-
La página de inicio
Abre, con el mismo contenido que tenías en local.
-
Una página interna
También abre, lo que prueba las reglas de direcciones del
.htaccess. Si la página de inicio funciona y las internas dan 404, ese archivo es el primer sospechoso. -
Las imágenes
Aparecen, lo que prueba que
storage/uploads/llegó. -
El panel
Tu dirección más
/adminacepta el usuario que tenías en local. -
Un formulario
Se envía, y el envío aparece en el panel.
-
El robots.txt
Abre en
/robots.txty apunta al sitemap en la dirección correcta. Desde la v3.8.1 no menciona el panel, que por sí solo les pide a los buscadores que no lo indexen.
Pídele a la IA
Revisa el sitio en línea: abre la página de inicio, la página Nosotros y una entrada del blog, fíjate si cargan las imágenes y dime qué dice /robots.txt.
HTTPS y ajustes de producción
Certificado. Actívalo en el panel del hosting (Hostinger emite uno gratis). La dirección que le diste a la IA ya empieza con https, así que los enlaces que salen de ella quedan bien.
Modo de depuración apagado. El primer despliegue ya escribe APP_DEBUG=false en el servidor. Déjalo así: encendido, un error muestra rutas de archivos, consultas a la base de datos y versiones a cualquier visitante.
Correo. Los datos de envío de correo (SMTP) del .env del servidor empiezan vacíos. Si los formularios envían correo, pídele a la IA que los complete con los datos de tu proveedor; mientras tanto, el envío depende de la función de correo del propio servidor.
Un sitio en una subcarpeta
Un sitio puede vivir bajo una ruta, como https://colegioaurora.example/inscripciones. Dale a la IA la subcarpeta cuando la pida: va a APP_BASE_PATH, y APP_URL queda solo con https y el dominio. La carpeta en el servidor es otra respuesta; la IA nunca deduce una de la otra.
Los enlaces funcionan ahí porque un tema Velk arma cada dirección con las funciones del motor, y desde la v3.9.0 las etiquetas canónica y de idioma ya no repiten la carpeta. Un detalle: los buscadores solo leen el robots.txt de la raíz del dominio, así que declara ahí el sitemap o envíalo por Google Search Console.
Hosting sin SSH
Sin SSH, la IA no puede hacer el despliegue por ti, pero Velk funciona igual: los archivos suben por FTP (transferencia simple de archivos) o por el administrador de archivos del hosting, el .env del servidor recibe los datos de la base de datos y un primer usuario del panel, y la primera visita instala el sitio. Después de una actualización del motor, la primera visita aplica sola los cambios de base de datos (AUTO_MIGRATE, activado por defecto).
El contenido de tu base de datos local no viaja con los archivos, y ninguno de los flujos por SSH de estas páginas funciona ahí. Si puedes, elige un plan con SSH.
Trabajar directo en el sitio en línea
Puedes saltarte la copia local y pedir cambios directo en el sitio en línea. Aun así, la IA nunca edita archivos en el servidor: descarga una copia nueva del tema en línea, hace el cambio y lo publica con todas las verificaciones (ver Sitios de clientes). El costo: solo ves el resultado cuando ya está en línea, y las verificaciones detectan una página rota, no una fea. Local para construir, en línea para ajustes puntuales, una copia de seguridad antes de cualquier cambio grande.
Preguntas frecuentes
¿Qué pasa si pido un despliegue otra vez más adelante?
La IA encuentra Velk en el servidor y pregunta qué cambió: el tema (una publicación con versión) o el motor (una actualización). Nunca repite el primer despliegue, y tu contenido local nunca vuelve a subir: la base de datos del sitio en línea, storage/uploads/ y el .env del servidor nunca se sobrescriben.
¿Qué hostings sirven?
Cualquiera con PHP 8.2 o más nuevo, MySQL o MariaDB y SSH con clave: Hostinger, hostings con cPanel (HostGator, SiteGround, A2, Bluehost), DreamHost, un VPS o un servidor en la nube; solo cambia la ruta de la carpeta. Si PHP está en una ruta distinta, la IA la encuentra y, con tu OK, la guarda. Un servidor con nginx en lugar de Apache ignora el .htaccess y necesita las reglas del nginx.conf.example de Velk.