Sites
Sites são o coração do PrimeForge. Cada site representa uma aplicação hospedada em um servidor — uma app Laravel, um projeto PHP puro, um site estático, ou uma aplicação Node.js/Next.js. Esta página cobre a lista de sites, os cinco tipos de site que o PrimeForge suporta, o assistente de criação em quatro passos e a página de Visão geral de cada site.
Lista de sites
Acesse Infrastructure → Sites para ver todos os sites da organização. No topo, cartões de métricas da frota resumem o estado geral: o total de sites, quantos estão no ar, o uptime agregado e o número de servidores ativos. A tabela lista cada site com seu domínio, tipo, servidor, status e ações rápidas, para você localizar e agir sobre qualquer aplicação em segundos.
Tipos de site
O PrimeForge suporta cinco tipos de site, cada um com uma configuração de runtime e um conjunto de serviços disponíveis diferentes:
| Tipo | Runtime | Serviços suportados | Descrição |
|---|---|---|---|
| Laravel | PHP-FPM + Nginx | DB, Redis, Horizon, Agendador, Reverb, S3 | Framework PHP full-stack com filas e tempo real |
| PHP Clássico | PHP-FPM + Nginx | DB, Redis, S3 | Aplicação PHP pura, sem framework |
| HTML Estático | Apenas Nginx | Nenhum | HTML, CSS e JavaScript servidos pelo Nginx |
| Node.js | Processo Node + Nginx (reverse proxy) | DB, Redis, S3 | Express, Fastify, Koa ou qualquer framework Node.js |
| Next.js | Processo Node + Nginx (reverse proxy) | DB, Redis, S3 | App React Next.js com renderização no servidor (SSR) |
Disponibilidade de serviços por tipo
Nem todo tipo de site pode usar todo serviço. Esta tabela mostra o que cada um suporta:
| Serviço | Laravel | PHP Clássico | Estático | Node.js | Next.js |
|---|---|---|---|---|---|
| Banco (PG/MySQL/SQLite) | Sim | Sim | Não | Sim | Sim |
| Redis | Sim | Sim | Não | Sim | Sim |
| Horizon | Sim | Não | Não | Não | Não |
| Agendador | Sim | Não | Não | Não | Não |
| Reverb | Sim | Não | Não | Não | Não |
| S3 (MinIO) | Sim | Sim | Não | Sim | Sim |
Node.js e Next.js usam campos extras: o start_command (processo que o supervisor mantém vivo, padrão npm start), o build_command (passo de build, padrão npm run build) e o app_port (porta em que a app escuta dentro do container, padrão 3000, para a qual o Nginx faz reverse proxy).
Criar Site
O assistente de criação de site tem quatro passos, com um indicador de progresso no topo; você pode voltar a qualquer passo já concluído para editar. Acesse Infrastructure → Sites e clique em Criar Site.
Se você abrir o assistente a partir da sub-página Sites de um servidor específico, o seletor de servidor fica oculto — o site só pode ser criado naquele servidor, o que elimina uma classe de erros de operação.
Passo 1 — Tipo de site e servidor de destino
| Campo | Descrição |
|---|---|
| Tipo de site | Laravel, PHP Clássico, HTML Estático, Node.js ou Next.js |
| Servidor | Qual servidor provisionado vai hospedar o site. Cada cartão de servidor mostra os serviços disponíveis localmente (DB / Redis / S3 / Reverb) para você escolher o servidor certo. |
Passo 2 — Repositório e Domínio
| Campo | Descrição |
|---|---|
| Domínio | O domínio em que o site será servido (por exemplo app.exemplo.com). O assistente valida o DNS ao vivo, mostrando se o registro A já aponta para o IP do servidor. |
| URL do repositório | A URL Git completa (por exemplo https://github.com/acme/app) |
| Provedor Git | Necessário para repositórios privados. Selecione um provedor GitHub conectado. |
| Branch | Padrão main. |
| Fazer deploy após a criação | Define se o primeiro deploy roda automaticamente depois da preparação do site. |
A validação de DNS ao vivo é importante: o TLS automático (Let's Encrypt) só é emitido depois que o domínio resolve para o IP do servidor. Se o registro A ainda não aponta para lá, o assistente informa exatamente qual registro criar.
Passo 3 — Serviços
Para cada serviço você escolhe um servidor hospedeiro (ou desabilita). O PrimeForge lê o .env.example do seu repositório e mostra uma dica de "Auto-detectado" em cada seção, para você saber de relance o que a aplicação espera:
- Banco de dados — PostgreSQL ou MySQL em um servidor específico, ou SQLite (arquivo local, sem servidor). SQLite é ótimo para sites simples; PostgreSQL/MySQL em um servidor dedicado é o caminho para aplicações que crescem ou compartilham o banco.
- Redis — qualquer servidor com Redis, ou Desabilitado. Habilitar Redis libera o interruptor de Horizon para sites Laravel.
- Reverb — qualquer servidor com Reverb, ou Desabilitado (somente Laravel).
- S3 / MinIO — qualquer servidor com S3, ou Armazenamento Local.
- Agendador — ligue para sites Laravel que precisam de
php artisan schedule:run.
Abaixo dos serviços você define o Runtime e os Limites de recursos:
- Runtime — as versões de PHP e Node disponíveis são governadas pelo registro de versões da plataforma; sites novos só recebem versões não descontinuadas, com uma pré-selecionada como padrão da frota. Para Node.js e Next.js você também informa o
start_command, obuild_commande oapp_port. - Limites de recursos — memória (256M / 512M / 1G / 2G, padrão 512M) e CPU (0.25 / 0.5 / 1.0 / 2.0, padrão 1.0). Se um build pesado de Laravel/Node/Next.js (por exemplo
npm ci+npm run build) falhar por falta de memória, aumente para 1G ou 2G.
Passo 4 — Revisão
Confirme todas as configurações e clique em Criar. O PrimeForge então:
- Cria a estrutura de diretórios do site no servidor
- Gera a configuração do Docker Compose
- Gera o arquivo
.envcom todas as credenciais de serviço - Provisiona o bucket MinIO e as chaves de acesso (se S3 habilitado)
- Registra a app Reverb (se Reverb habilitado)
- Registra o webhook de push do GitHub (se o deploy automático estiver ligado)
- Dispara o deploy inicial
Visão geral do site
Cada site tem uma página de detalhe com sub-navegação (Visão geral, Deployments, Ambiente, Logs, Atividade, Configurações e mais). A aba Visão geral é o painel de controle do dia a dia.
Ela mostra as informações do site, o status dos serviços, a saúde do container, o estado do certificado TLS, o servidor primário e o código HTTP mais recente da sonda de saúde. Também traz:
- Cartão de Domínio e DNS — indica se o registro A/AAAA do seu domínio resolve para o IP do servidor (um "DNS OK" verde ou uma dica âmbar dizendo qual registro A criar), com botão de copiar o IP e uma ação Verificar novamente.
- Diagnóstico de TLS — quando o certificado está faltando, pendente ou expirado, o cartão de TLS expande com uma verificação de correspondência de DNS ao vivo e o último erro ACME, para você entender por que o certificado não está sendo emitido.
- Ações rápidas — a partir da visão geral você dispara um Deploy, e controla o ciclo dos containers: Start (subir os containers), Stop (parar de forma graciosa — a intenção do painel é mantê-los parados) e Restart (reiniciar, aplicando mudanças de
.env). O PrimeForge também reinicia containers que travam automaticamente (até 3 tentativas, marcando o site como Falhou depois disso, e como Live de novo se ele se recuperar sozinho).
Próximos passos
- Configuração de Sites — edite o
.env, ajuste versões de runtime, veja logs e a atividade do site - Serviços, Bancos e Armazenamento — prepare os servidores que hospedarão o banco, Redis e S3 do seu site
- Monitoramento, Agendador e Firewall — acompanhe o consumo de recursos do site