Como publicar uma aplicação a partir do Cursor, do Claude Code ou do Windsurf
O caminho mais curto para publicar uma aplicação que escreveu com o Cursor, o Claude Code ou o Windsurf é deixar que a mesma ferramenta o faça. 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 que tem o projeto aberto. A ferramenta lê as instruções, liga o código ao servidor através do GitHub, executa a compilação e entrega-lhe um endereço HTTPS a funcionar.
Isto funciona porque estas ferramentas conseguem executar comandos no seu computador e ler páginas web, como descrevem a documentação do Cursor Agent e a do Claude Code. O Windsurf passou a chamar-se Devin Desktop, que o seu criador descreve como o mesmo editor com um novo nome, por isso os passos não mudam.
Passo a passo
- Escolha um tamanho na página do VPS Next.js e conclua o pagamento. O painel de publicação Coolify instala-se sozinho no servidor.
- No seu painel da Seturack, abra o servidor em Os meus servidores. No separador Resumo, confirme que a linha Aplicação diz que está pronta.
- Copie a linha Cole na sua ferramenta de IA. Segue este modelo, com um endereço e uma chave que pertencem ao seu servidor:
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 a pasta do projeto na sua ferramenta. O Cursor e o Devin Desktop têm um painel de agente para isto, e no Claude Code executa
claudedentro da pasta. - Cole o texto, envie-o e responda ao que a ferramenta pedir.
- Quando receber o endereço, abra-o e experimente as páginas que lhe interessam.
Nos nossos testes, uma publicação demorou de 1 a 6 minutos. Os tipos de projeto que já passámos pelo Coolify são Next.js, TanStack Start, Vite (estático), HTML simples, Astro e Flask.
O que faz a ferramenta pelo caminho?
O texto aponta a ferramenta para um ficheiro chamado deploy.txt, que não é específico de nenhuma ferramenta. Abrange estas fases:
| Fase | O que a ferramenta faz | O que precisa de si |
|---|---|---|
| Verificação do projeto | Descobre a framework, o comando de compilação e a porta, confirma que os ficheiros .env estão no .gitignore e passa uma aplicação que escuta em localhost para 0.0.0.0 | Valores de variáveis que não consegue encontrar |
| Repositório | Usa um repositório público tal como está. Sem repositório, cria um privado depois de o aprovar. Um repositório privado recebe uma chave de implementação que só pode ler esse repositório | Aprovação e um início de sessão no GitHub |
| Aplicação | Cria a aplicação através da API do Coolify e define as variáveis | Nada |
| Publicação | Inicia a compilação e espera. Se falhar, a ferramenta lê o registo, corrige a causa e tenta de novo | Nada |
| Resultado | Abre o endereço HTTPS para confirmar que funciona e depois avisa-o | Uma última verificação |
Para o GitHub, a ferramenta usa a ferramenta de linha de comandos gh. Se não tiver sessão iniciada, pode pedir-lhe que execute gh auth login.
Como tratar os pedidos de aprovação?
As três ferramentas executam comandos de acordo com as suas definições de permissões. O Cursor guarda-as em Settings, Agents, Approvals & Execution. O Claude Code tem modos de permissão, e o Devin Desktop tem regras Allow, Ask e Deny. Numa primeira publicação, fique num modo que pergunta, para ver cada comando antes de ser executado.
Trate a chave da API desse texto como uma palavra-passe. As instruções dizem à ferramenta para nunca a imprimir nem a pôr no projeto ou no repositório. Mesmo assim, fica no seu histórico de conversa, por isso só a cole numa ferramenta em que confie e tenha cuidado ao partilhar o ecrã.
O que pode pedir depois do lançamento?
- «Publica de novo a cada git push.» A ferramenta adiciona um webhook assinado no GitHub, e cada push compila uma nova versão.
- «Serve a aplicação em app.example.com.» Primeiro aponta um registo A para o endereço IP do servidor. O certificado é emitido automaticamente.
- «Acrescenta PostgreSQL a esta aplicação.» A base de dados corre no mesmo servidor, não é acessível do exterior e o seu endereço entra na aplicação como
DATABASE_URL.
E se ficar presa?
| Sintoma | Causa | Solução |
|---|---|---|
| A compilação pára com o código de saída 137 | Sem memória | Aumente no separador Tamanho e publique de novo. O IP e os dados mantêm-se |
| A ferramenta não consegue ler as instruções | O acesso à web não foi aprovado | Aprove-o, ou cole por si o conteúdo do ficheiro |
| Os comandos do GitHub falham | Sem início de sessão no GitHub | Execute gh auth login |
| O site abre mas não mostra dados | Falta uma variável | Dê o valor à ferramenta e publique de novo |
Não é obrigatório usar uma ferramenta. O endereço do painel, o e-mail e a palavra-passe estão no separador Resumo, e pode fazer o mesmo trabalho à mão no Coolify. Tem acesso root, e pode gerir tudo a partir do painel se preferir. Se foi outra ferramenta a gerar o seu código, o guia geral liga a um artigo sobre ela.
Perguntas frequentes
Com que tamanho devo começar?
A página de vendas recomenda pelo menos 4 GB de RAM, 2 vCores e 40 GB de disco, e o motivo é a compilação. 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. Mais tarde pode aumentar a partir do painel.
Quanto custa por mês?
O tamanho mínimo recomendado 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. A subscrição da sua ferramenta de programação é à parte. O nosso artigo sobre preço fixo ajuda a fazer as contas.
Como ligo o meu próprio domínio?
Aponte um registo A para o endereço IP do servidor e depois diga à ferramenta o nome do domínio. Ela adiciona o domínio e publica de novo, e o certificado é emitido automaticamente. O nosso artigo de ajuda explica o registo DNS.
Como atualizo a aplicação mais tarde?
Com o webhook configurado, envia o código com git push e o servidor compila-o. Sem webhook, peça à ferramenta que publique de novo ou prima Redeploy no Coolify.
Onde deve ficar a base de dados?
Se a aplicação guarda dados de utilizadores, a opção limpa é o PostgreSQL do mesmo painel. Com o SQLite, monte a respetiva pasta com Persistent Storage, porque o contentor é reconstruído a cada publicação e os ficheiros escritos lá dentro desaparecem.
Isto funciona com outras ferramentas de programação?
O mesmo texto funciona em qualquer ferramenta que consiga executar comandos e ler páginas web. Uma ferramenta que seja apenas uma janela de conversa não consegue chegar a um servidor, por isso siga antes o nosso guia para publicar um site feito com o ChatGPT ou o Claude.
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.