Deployments remotos
No código desktop atual, a página abre no modo Local e não exige conta nem plano LaraEnv. Configurações e histórico ficam no computador; detectar, aplicar, fazer deploy e consultar atividade acessam diretamente o host SSH selecionado. A versão 0.5.7 e imagens anteriores podem mostrar o modelo antigo, restrito à nuvem.
Visão geral
Faça deploy de uma aplicação Laravel, Node ou estática em um servidor remoto vinculado a um dos seus hosts SSH salvos. O LaraEnv conduz todo o ciclo de vida e mostra a saída passo a passo de cada ação.
Crie um destino local e selecione um host SSH salvo antes de iniciar. O uso local não exige ativar a integração com a nuvem. O repositório público e o guia offline descrevem esse modelo independente de conta.
Ciclo de vida
Detect (Detectar)
Escaneia o servidor remoto — família/versão do SO e software instalado — e salva um perfil de detecção que orienta o restante do fluxo.
Apply (Aplicar)
Você fornece as configurações:
- URL do repositório Git e branch
- Domínio e SSL
- Variáveis de ambiente
- Versão do PHP
- Banco de dados
- Um preset de deploy
O LaraEnv então configura o servidor: clona o repositório, faz o bootstrap do banco de dados, compila os assets, escreve a configuração do servidor web e muito mais — com saída passo a passo.
O HTTPS via Let's Encrypt pode ser provisionado durante o apply, para que seu domínio seja servido por SSL.
Deploy
Executa o deploy no servidor configurado.
Destroy (Destruir)
Executa o plano de remoção no host remoto e exclui o cadastro local após o sucesso. Se a remoção remota falhar, o cadastro e o resultado da tentativa permanecem disponíveis.
Excluir o cadastro remove somente o registro e seu histórico local; não desmonta o servidor.
Acesso remoto ao banco
Permitir acesso remoto ao banco fica desativado por padrão para MySQL e PostgreSQL. Ative-o em Apply e informe endereços individuais IPv4 ou IPv6 separados por vírgulas ou linhas. Hostnames, curingas e intervalos CIDR não são aceitos.
É necessário um firewall UFW ativo; o LaraEnv adiciona regras por origem e não ativa o UFW por você. O firewall do provedor também pode precisar das mesmas regras de origem permitida. Apply pode reiniciar o serviço de banco compartilhado para alterar seu listener.
Use um usuário de banco dedicado por deployment. A aplicação mantém sua conexão local. Reaplicar com o acesso desativado revoga as contas e regras gerenciadas para aquele deployment; regras não relacionadas são preservadas. O listener compartilhado continua aceitando acesso remoto enquanto outro deployment gerenciado precisar dele. Alterar essa opção tem efeito em Apply, não a cada Git pull automático.
Veja o guia público de acesso ao banco para detalhes de credenciais, provisionamento PostgreSQL e limpeza.
Log de atividades
O desktop armazena configurações e histórico locais em <raiz do LaraEnv>/state/deployments/, protegidos pelo DPAPI do Windows independentemente da conta da nuvem. Mantém as 100 execuções mais recentes por destino, com até 4 MiB por log e indicação de truncamento. Para backup, preserve a pasta de dados completa; copiá-la para outro perfil Windows pode deixar os registros bloqueados.
Uma execução ativa passa a aparecer como interrompida depois que o processo desktop fecha. Confira o servidor antes de repeti-la: o registro local interrompido não desfaz comandos já enviados por SSH. Se a execução remota terminar e a gravação do resultado local falhar, o desktop não repete os comandos automaticamente.
Deployments hospedados existentes
Cadastros hospedados não são convertidos nem executados automaticamente. Após ativar explicitamente a nuvem e entrar na conta, você pode escolher um destino hospedado para importar e mapeá-lo para um host SSH local. Também é possível importar um JSON fornecido pelo usuário em Local → Importar JSON. A importação cria registros locais sem executar scripts ou abrir SSH; dados conflitantes preservam a versão local existente. O histórico hospedado pode fornecer resumos sem os corpos completos dos logs antigos.
Uma operação por vez pode modificar um servidor a partir deste processo desktop, incluindo os modos local e nuvem. Outros processos desktop, computadores e sessões TUI não compartilham esse bloqueio.
Preservação de dados
Seu arquivo .env e o diretório storage\ sobrevivem a um re-apply. Eles são mantidos entre execuções por um diretório de retenção seguro, de modo que os dados e a configuração da aplicação não sejam perdidos ao aplicar novamente.
Veja também Presets de deploy e Hosts SSH.