.zip é o código-fonte: o package.json, o go.mod, o .csproj e os arquivos que você escreve. O resultado de um build feito no seu computador (o Next.js exportado, os .pyc, um programa compilado para o seu sistema) roda pior aqui, ou nem roda.
O envio analisa o que chegou e avisa, em português, quando parece o compilado. Ele nunca trava: dá para seguir com “Continuar mesmo assim”. A única exceção é um programa compilado para Mac ou Windows como arquivo principal, que não roda no servidor e aparece como erro.
O que cada linguagem precisa
Também ficam sempre de fora o
.git e o __MACOSX (a sobra do “Comprimir” do macOS). Mesmo saindo, essas pastas contam no tamanho do .zip: veja Limites do .zip.
Uma pasta só sai quando o build automático da Cube vai gerá-la de novo. Ela fica como veio quando:
- o
cube.jsondesliga o build ("build": "") ou traz um build seu (como"build": "prisma generate"); - o comando de início usa a pasta (
dotnet bin/Release/net8.0/publish/App.dlldeixa obin;node .output/server/index.mjsdeixa o.output); - a
.nextestá numa subpasta (comoweb/.next): onpm run buildroda só nopackage.jsonda raiz; - não tem o manifesto ao lado: o
binde um projeto Node, otargetdo Maven (onde mora o.jar) e odistde um site pronto continuam no projeto.
cube.json do .zip novo.Next.js: código-fonte ou site estático
Um Next.js comoutput: 'export' vira, no seu computador, um site estático: a pasta _next, o index.html, o 404.html e uma pasta por página. Enviado assim, ele roda como site estático: as páginas abrem, mas rotas de API, páginas com servidor e middleware não funcionam.
1
Para rodar o Next de verdade
Envie o código-fonte: o
package.json com os scripts build (next build) e start (next start), sem node_modules e sem .next. A Cube instala, faz o build a cada envio e liga o site com o npm start. Se a .next vier junto, ela sai do envio e o painel diz isso.2
Para manter o site estático
No Novo projeto, o aviso “Isto é o Next.js já compilado como site estático” tem o botão Continuar como site estático: o site sobe como veio, servido pela Cube.
nuxt generate (a pasta _nuxt com o index.html) é um site estático; para o Nuxt com servidor, envie o código-fonte com o script build (nuxt build).
Programa compilado para Mac ou Windows
O servidor é Linux. Um programa compilado no Mac (Mach-O) ou no Windows (.exe) não roda aqui: se ele é o arquivo principal ou está no comando de início, o painel mostra o erro “compilado para Mac” (ou Windows) e o envio não sai até você trocar o comando ou o arquivo. Um programa que só veio junto do código (o chromedriver ao lado do main.py) não é o principal e não trava nada. Com um build seu que gera o programa (como "build": "go build -o bot ."), o do Mac é trocado pelo de Linux a cada envio, e o envio segue. A CLI faz o mesmo a partir da versão 0.3.1.
O caminho é mandar o código: no Go, o go.mod com o código, e a Cube compila a cada envio. Um programa já compilado para Linux roda como veio, mas sem compilar a cada envio; o envio avisa e deixa seguir.
Pela API e pela CLI
A CLI, a partir da versão 0.3.1, faz a mesma análise antes de compactar: deixa de fora as pastas do build, com as mesmas regras (nocube deploy --project, com a configuração do projeto), e mostra cada aviso como Aviso: …. Só o programa de Mac ou Windows como arquivo principal para o envio.
Pela API, a resposta do envio (POST /projects e POST /projects/{id}/code) traz hints, com um código fixo em inglês e a mensagem em português:
Os avisos nunca mudam o resultado do envio: o projeto instala do mesmo jeito. Use o
code no seu código, como nos códigos de erro.
