Publicar é levar o site que você construiu no seu computador para um servidor de hospedagem, com o conteúdo, para ele responder no endereço de verdade. Com a skill do Velk, é um pedido: na primeira vez a IA pergunta o que não sabe, inspeciona o servidor, envia tudo e confere o resultado.
Esta página trata do primeiro deploy. Depois dele, o site no ar é o de verdade: as mudanças seguintes vão como publicações do tema (Publicar alterações) e as versões novas do Velk como atualizações (Atualizar o Velk).
Antes de começar
-
Acesso SSH
SSH é a conexão segura do seu computador com o servidor, aberta com uma chave em vez de senha. Ative no painel da hospedagem, na seção Acesso SSH (a Hostinger usa a porta 65002). Os planos compartilhados intermediários costumam ter, os básicos muitas vezes não, uma VPS (um servidor virtual só seu) sempre tem.
-
Um banco e seus quatro dados
Crie o banco e o usuário dele no painel da hospedagem: o Velk não consegue criar lá. Anote host (geralmente
localhost), nome, usuário e senha exatamente como aparecem, com o prefixo, como emu12345678_lumen. -
O domínio
Aponte o domínio para o servidor, ou pelo menos comece: o DNS, a lista telefônica da internet, leva de minutos a horas para espalhar uma mudança.
-
O endereço canônico
Escolha um endereço oficial, com ou sem www, sempre com https. Ele vira o
APP_URLno.envdo servidor (o arquivo de configuração dele), e é dele que nascem o sitemap, orobots.txte as tags canônicas. Subir com um endereço provisório deixa tudo isso apontando para ele até alguém perceber.
Peça à IA
Gera uma chave SSH pra mim e me mostra a parte pública, pra eu colar no painel da hospedagem.
A parte pública vai para o servidor; a privada nunca sai do seu computador.
Peça à IA
Sobe esse site pela primeira vez na minha hospedagem da Hostinger. É o site da Clínica Lumen, e o endereço oficial é https://www.clinicalumen.example, com www. O SSH já está ativo e eu criei o banco no painel.
Na primeira vez, a IA pergunta o que ainda não sabe. Ela guarda as respostas, e nos pedidos seguintes não pergunta mais nada.
O que a IA pergunta na primeira vez
| Pergunta | O que responder |
|---|---|
| SSH | Endereço, porta e usuário, que estão no painel da hospedagem. A IA conecta com a chave, nunca com senha. |
| Pasta no servidor | O caminho completo onde o site vai morar, como /home/u123456789/domains/clinicalumen.example/public_html na Hostinger (a raiz do documento, no painel). A IA nunca deduz isso do endereço. |
| Endereço | O endereço canônico com https (com http, a IA avisa) e, se o site não fica na raiz do domínio, a subpasta. |
| Banco do servidor | Nome, usuário e senha exatamente como o painel criou; o host só se não for localhost. |
| Banco local | Nada: a IA lê do .env do seu projeto. |
O que a IA faz
Ela guarda as respostas em .deploy/ssh.json, que só você lê e que fica fora do Git, e testa tudo. Depois:
- Olha o servidor primeiro, e para se a pasta já tem um Velk.
- Recusa subir problema: um motor editado, ou as páginas originais de um site HTML convertido esquecidas no tema.
- Envia os arquivos: motor, tema,
storage/uploads/e o.htaccess, o arquivo de regras do servidor web. Nunca o seu.envlocal, o.gitou a configuração de deploy. - Escreve o
.envdo servidor com as suas respostas, já comAPP_DEBUG=false, trancado para outras contas do servidor não lerem. As suas credenciais locais nunca sobem. - Copia o seu banco local para o do servidor e roda o
migrate, as atualizações de banco do motor: páginas, posts, mídia e usuários do painel chegam como estavam. - Fecha: escreve o
robots.txtcom o endereço real do sitemap e confere se a home responde.
Conferindo no ar
-
A home
Abre, com o mesmo conteúdo que você tinha no local.
-
Uma página interna
Abre também, o que testa as regras de endereço do
.htaccess. Se a home funciona e as internas dão 404, esse arquivo é o primeiro suspeito. -
As imagens
Aparecem, o que testa se o
storage/uploads/chegou. -
O painel
O seu endereço mais
/adminaceita o usuário que você tinha no local. -
Um formulário
Envia, e o envio aparece no painel.
-
O robots.txt
Abre em
/robots.txte aponta para o sitemap no endereço certo. Desde a v3.8.1 ele não cita o painel, que avisa sozinho os buscadores para não indexá-lo.
Peça à IA
Confere o site no ar: abre a home, a página Sobre e um post do blog, vê se as imagens carregam e me diz o que está no /robots.txt.
HTTPS e ajustes de produção
Certificado. Ative no painel da hospedagem (a Hostinger emite um gratuito). O endereço que você passou para a IA já começa com https, então os links que saem dele ficam certos.
Modo de depuração desligado. O primeiro deploy já escreve APP_DEBUG=false no servidor. Mantenha: ligado, um erro mostra caminho de arquivo, consulta ao banco e versão para qualquer visitante.
E-mail. Os dados de envio de e-mail (SMTP) do .env do servidor começam vazios. Se os formulários mandam e-mail, peça para a IA preencher com os dados do seu provedor; até lá, o envio depende da função de e-mail do próprio servidor.
Site numa subpasta
Um site pode morar num caminho, como https://escolaaurora.example/matriculas. Informe a subpasta quando a IA perguntar: ela vai para o APP_BASE_PATH, e o APP_URL fica só com o https e o domínio. A pasta no servidor é outra resposta; a IA nunca deduz uma da outra.
Os links funcionam ali porque um tema Velk monta todo endereço pelas funções do motor, e desde a v3.9.0 as tags canônica e de idioma não repetem mais a pasta. Um detalhe: os buscadores só leem o robots.txt da raiz do domínio, então declare o sitemap lá ou envie pelo Google Search Console.
Hospedagem sem SSH
Sem SSH, a IA não consegue fazer o deploy por você, mas o Velk roda lá: os arquivos sobem por FTP (transferência simples de arquivos) ou pelo gerenciador de arquivos da hospedagem, o .env do servidor recebe os dados do banco e um primeiro usuário do painel, e a primeira visita instala o site. Depois de uma atualização do motor, a primeira visita aplica sozinha as mudanças de banco (AUTO_MIGRATE, ligado por padrão).
O conteúdo do seu banco local não viaja com os arquivos, e nenhum dos fluxos por SSH destas páginas funciona lá. Se puder, escolha um plano com SSH.
Trabalhar direto no ar
Dá para pular a cópia local e pedir mudanças direto no site no ar. Mesmo assim a IA nunca edita arquivo no servidor: ela baixa uma cópia nova do tema no ar, faz a mudança e publica, com todas as verificações (veja Sites de clientes). O custo: você só vê o resultado quando ele já está no ar, e as verificações pegam uma página quebrada, não uma feia. Local para construir, no ar para ajuste pontual, backup antes de qualquer coisa grande.
Perguntas frequentes
E se eu pedir deploy de novo depois?
A IA encontra o Velk no servidor e pergunta o que mudou: o tema (uma publicação com versão) ou o motor (uma atualização). Ela nunca repete o primeiro deploy, e o seu conteúdo local nunca mais sobe: o banco do site no ar, o storage/uploads/ e o .env do servidor nunca são sobrescritos.
Quais hospedagens servem?
Qualquer uma com PHP 8.2 ou mais novo, MySQL ou MariaDB e SSH com chave: Hostinger, hospedagens com cPanel (Locaweb, HostGator, KingHost), DreamHost, uma VPS ou um servidor na nuvem; só muda o caminho da pasta. Se o PHP fica num caminho diferente, a IA encontra e, com o seu OK, guarda esse caminho. Um servidor com nginx em vez de Apache ignora o .htaccess e precisa das regras do nginx.conf.example do Velk.