Como publicar uma aplicação criada com IA?
O caminho mais curto para publicar uma aplicação criada com uma ferramenta de IA é este: encomende um servidor Next.js à Seturack, copie a linha Cole na sua ferramenta de IA do separador Resumo do seu painel e cole-a na ferramenta de programação que tem o seu projeto aberto. A ferramenta liga o código ao servidor através do GitHub, faz a compilação e dá-lhe um endereço HTTPS. A partir daí, cada git push pode pôr uma nova versão no ar.
Seja qual for a ferramenta que o escreveu, o resultado costuma ser um projeto comum em Next.js, Vite, Astro, Node ou Python. O senão é que as ferramentas de IA são boas a pôr o código a funcionar e menos cuidadosas com o que a produção exige, por isso este guia inclui uma lista de verificação.
Um guia para a sua ferramenta
| Onde o criou? | Como o código sai de lá | Guia |
|---|---|---|
| Cursor, Claude Code, Windsurf | Já está no seu computador | A ferramenta publica-o |
| Lovable | Sincronização com o Git ou um zip | Guia do Lovable |
| Bolt.new | GitHub ou um zip | Guia do Bolt.new |
| v0 | GitHub | Guia do v0 |
| Replit | Painel Git ou um zip | Guia do Replit |
| ChatGPT, Claude | Guardar o código num ficheiro | Publicar do zero |
Publicar com o texto que cola
- Encomende um servidor na página do VPS Next.js. Esta opção vem com o painel Coolify, que não se limita ao Next.js.
- No seu painel da Seturack, abra o servidor em Os meus servidores e espere que a linha Aplicação do separador Resumo diga que está pronta.
- Copie a linha Cole na sua ferramenta de IA. Segue este modelo:
Deploy this project to my Seturack server. Read and follow the instructions first: https://www.seturack.com/deploy.txt Panel: PANEL-ADDRESS API key: API-KEY - Abra o projeto numa ferramenta de programação que consiga executar comandos e cole o texto.
- A ferramenta inspeciona o projeto, liga o repositório, cria a aplicação e acompanha a compilação. Pede-lhe os valores em falta e as aprovações.
- Abra o endereço HTTPS que ela lhe dá e experimente a aplicação por si.
Guarde a chave da API que está nesse texto com o mesmo cuidado que uma palavra-passe. Nos nossos testes, funcionaram projetos Next.js, TanStack Start, Vite (estático), HTML simples, Astro e Flask, e as publicações demoraram de 1 a 6 minutos.
O que deve verificar antes de entrar em produção?
| Verificar | Porque importa | Como ver |
|---|---|---|
| Há segredos no código? | Uma chave registada num commit fica no histórico do Git mesmo depois de apagar o ficheiro. | git ls-files | grep -i env |
| A compilação passa? | O código que corre localmente ainda pode falhar a compilação por erros de tipos. | npm run build |
| Existe um ficheiro lock? | O servidor precisa dele para instalar as versões que testou. | ls *lock* |
| Sobraram endereços locais? | Um URL localhost não funciona em produção. | grep -rn localhost app src |
| Em que endereço escuta a aplicação? | Um servidor em 127.0.0.1 não é acessível do exterior. Use 0.0.0.0. | grep -rn "127.0.0.1" app src |
| A base de dados é um ficheiro? | O contentor é reconstruído a cada publicação, e um ficheiro SQLite lá dentro desaparece. | grep -rln sqlite app src |
Os comandos grep terminam com um código de erro quando não encontram nada, o que não faz mal. Se app ou src não existir, retire esse nome.
O erro mais comum nas aplicações criadas com IA é uma chave de modelo a vazar para o navegador. No Next.js, uma variável que comece por NEXT_PUBLIC_ é escrita no código do navegador durante a compilação, por isso qualquer pessoa a pode ler. Nunca dê esse prefixo a chaves de modelos ou de pagamentos. Se já enviou uma chave, apagá-la não chega: revogue-a junto do fornecedor e emita uma nova.
Como pôr o código no GitHub?
O servidor publica a partir de um repositório Git. Se não tiver nenhum, a sua ferramenta de programação cria um privado quando o aprovar. Para o fazer por si, confirme que o .gitignore tem uma linha para .env e depois execute estes comandos na pasta do projeto. A ferramenta de linha de comandos gh cria o repositório e envia o código:
git init
git add .
git commit -m "first version"
gh repo create project-name --private --source . --push
Publicar à mão no painel
Pode fazer o mesmo trabalho no Coolify sem uma ferramenta de programação. Tem acesso root, e pode gerir tudo a partir do painel se preferir. O endereço e a palavra-passe estão no separador Resumo. O nosso guia do Next.js aborda repositórios privados, webhooks e domínios. Alguns campos mudam para outros projetos. Experimentámos estas definições num servidor real com os projetos de exemplo do Coolify:
| Projeto | Definições |
|---|---|
| Next.js | Porta 3000 |
| Vite (estático) | Output type: Static site, Publish directory: /dist |
| Astro (servidor) | Porta 4321, Start command: HOST=0.0.0.0 node dist/server/entry.mjs |
| Python (Flask) | Porta 5000, Start command: python -m flask run --host=0.0.0.0 --port=5000 |
O que deve ver depois do lançamento?
- Verifique se todos os endpoints do lado do servidor validam a sessão. As ferramentas de IA costumam proteger a interface e esquecer a rota da API que está por trás.
- Limite o número de pedidos de qualquer endpoint que chame um modelo, ou desconhecidos podem fazer disparar a sua fatura.
- Leia a página Logs da aplicação no Coolify algumas vezes no primeiro dia.
- Teste as suas cópias de segurança. Enquanto não restaurar uma, não sabe realmente se a tem.
Perguntas frequentes
Que capacidade deve ter o servidor?
A página de vendas recomenda pelo menos 4 GB de RAM, 2 vCores e 40 GB de disco. Um pequeno projeto Next.js compilou com 2 GB, enquanto um com 85 pacotes ficou sem memória com 2 GB e compilou com 4 GB. Se uma compilação falhar, aumente o servidor a partir do painel. O IP e os dados mantêm-se.
Quanto custa por mês?
Esse tamanho custa cerca de $6 por mês (IVA incluído) e, fora da Turquia, paga em dólares norte-americanos. As cópias de segurança diárias estão incluídas no preço e o tráfego é ilimitado. Comparamos isto com o alojamento faturado por utilização neste artigo.
Como ligo o meu domínio?
Aponte um registo A para o endereço IP do servidor e depois diga à ferramenta o domínio, ou adicione-o na página Domains do Coolify. O certificado é emitido automaticamente, e o servidor fica em Istambul. O nosso artigo de ajuda explica o registo.
Como atualizo a aplicação depois do lançamento?
Peça à ferramenta que publique a cada push, ou configure o webhook à mão. Depois, o git push compila e publica cada nova versão. Sem webhook, prima Redeploy no Coolify.
Onde deve ficar a base de dados?
Não deixe dados de utilizadores dentro do contentor. Crie o PostgreSQL no mesmo painel: fica fora da internet pública e o seu endereço vai para uma variável como DATABASE_URL. No SQLite, monte a pasta com Persistent Storage. Se o projeto usa o Supabase, veja o VPS Supabase.
Comentários0
Ainda não existem comentários
Seja a primeira pessoa a partilhar a sua opinião.
Inicie sessão ou crie uma conta para deixar um comentário.