Pular para o conteúdo
Documentação

Staging e deploy

Como clonar um site para um domínio de testes (com cópia do banco) e como rodar um pipeline de deploy (git pull, composer, build) pelo painel.

R Regis Manze 20/11/2026 4 min de leitura

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.

  1. Na linha do domínio, clique em Criar staging (clonar site).
  2. Em Dominio de staging, confira o nome sugerido (staging.exemplo.com.br) ou digite outro.
  3. Em Clonar banco (MariaDB), escolha o banco do site ou deixe - nao clonar -.
  4. Clique em Criar Staging e confirme.
  5. Acompanhe a saída até aparecer STAGING PRONTO!.
  6. 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) ou public_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:flush na pasta do staging.

Atenção: o APP_URL e o base_url do staging são gravados com http://. Depois de emitir o certificado para o staging, ajuste para https://.

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.

  1. Na linha do domínio, clique em Deploy (git pull + build).
  2. Em Pipeline, revise os comandos (um por linha) ou clique num modelo: Generic, Laravel, Magento, Node.js ou Node + build.
  3. Clique em Executar Deploy e confirme.
  4. 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) ou public_html/pub (Magento), o git, o artisan e o bin/magento estão uma pasta acima. Comece o pipeline com cd ...

Dica: o git pull só 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).

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!