O staging cria uma cópia de testes de um site, e o deploy roda uma sequência de comandos para atualizar o código de um site. Os dois ficam na linha de cada domínio em Hospedagem > Dominios.
Criar um staging
O staging copia os arquivos do site, cria um novo domínio para a cópia e, se você quiser, clona o banco MariaDB/MySQL.
- Na linha do domínio, clique em Criar staging (clonar site).
- Em Dominio de staging, confira o nome sugerido (
staging.exemplo.com.br) ou digite outro. - Em Clonar banco (MariaDB), escolha o banco do site ou deixe - nao clonar -.
- Clique em Criar Staging e confirme.
- Acompanhe a saída até aparecer STAGING PRONTO!.
- Aponte o DNS do domínio de staging para o servidor.
O que o painel faz:
| Etapa | Resultado |
|---|---|
| Arquivos | Copia o document root para /home/usuario/staging/<dominio-de-staging>. |
| Banco | Cria o banco <banco>_stg e copia os dados. O mesmo usuário do banco original ganha acesso a ele. |
| Laravel | Ajusta DB_DATABASE e APP_URL no .env da cópia. |
| Magento | Ajusta o dbname no app/etc/env.php e aponta o base_url do banco clonado para o staging. |
| Domínio | Cria o domínio com o mesmo usuário, versão do PHP e template de rewrite. |
Só aparecem na lista os bancos MariaDB/MySQL sem dono ou do mesmo dono do domínio.
Atenção: o staging copia apenas a pasta do document root. Se o site usa
public_html/public(Laravel) oupublic_html/pub(Magento), a cópia leva só essa subpasta, sem o restante da aplicação, e não funciona. Nesses casos, prepare o staging manualmente.
Atenção: no Magento, limpe o cache da cópia depois de criar:
bin/magento cache:flushna pasta do staging.
Atenção: o
APP_URLe obase_urldo staging são gravados comhttp://. Depois de emitir o certificado para o staging, ajuste parahttps://.
Limitações:
- Não funciona com apps Node.js nem com redirecionamentos.
- Não é possível criar staging de um staging.
- O staging aparece na lista como um domínio comum, com o selo staging. Para descartá-lo, remova o domínio e apague a pasta e o banco
_stg.
Rodar um deploy
O deploy executa comandos como o usuário dono do domínio, dentro do document root, e para no primeiro erro.
- Na linha do domínio, clique em Deploy (git pull + build).
- Em Pipeline, revise os comandos (um por linha) ou clique num modelo: Generic, Laravel, Magento, Node.js ou Node + build.
- Clique em Executar Deploy e confirme.
- Acompanhe a saída. O selo muda para Concluido! ou Falhou.
O pipeline usado fica salvo no domínio e reaparece na próxima vez. Se não houver pipeline salvo, o painel sugere o modelo do template de rewrite do site.
Ao final de um deploy com sucesso:
- site PHP: o PHP-FPM da versão do site é recarregado, o que limpa o OPcache;
- app Node.js: o serviço da app é reiniciado e o painel confere se ela subiu.
Modelo Laravel (exemplo com PHP 8.3):
git pull
php8.3 $(command -v composer) install --no-dev --optimize-autoloader
php8.3 artisan migrate --force
php8.3 artisan config:cache
php8.3 artisan route:cache
php8.3 artisan view:cache
Modelo Node + build:
git pull
npm ci
npm run build
npm prune --omit=dev
Atenção: os comandos rodam dentro do document root. Se o document root for
public_html/public(Laravel) oupublic_html/pub(Magento), ogit, oartisane obin/magentoestão uma pasta acima. Comece o pipeline comcd ...
Dica: o
git pullsó funciona se a pasta já for um repositório clonado e o usuário tiver acesso a ele (por exemplo, com uma chave SSH de deploy em/home/usuario/.ssh).