Deploy e atualização
Como publicar uma versão nova, o que acontece em cada etapa e por que o log ao vivo importa.
Publicar uma versão nova de uma aplicação existente chama-se commit. Ele está na aba Commit dentro da aplicação e substitui os arquivos sem apagar o que já está lá.
As etapas de uma publicação
- 1Preparando — o painel abre o seu .zip, remove pastas pesadas, confere o arquivo principal e ajusta a porta.
- 2Enviando — o pacote sobe. A barra mostra bytes reais transferidos.
- 3Instalando — o ambiente instala as dependências do seu arquivo de dependências. É a etapa mais demorada.
- 4Iniciando — o processo sobe e imprime as primeiras linhas no console.
- 5No ar — a aplicação está de pé e respondendo.
O log é o do seu container, ao vivo
As linhas que aparecem durante o deploy não são mensagens genéricas da plataforma: é a saída real do seu processo. Se uma dependência falhar ao instalar, o erro exato aparece ali na hora.
Envio somando arquivos
Um commit ADICIONA e SOBRESCREVE arquivos, mas não remove o que não veio no pacote. Isso é proposital — protege dados que a aplicação gravou em disco. Se você renomeou ou apagou arquivos no projeto, remova as versões antigas pelo Explorador de Arquivos.
Projeto completo ou arquivo solto
| Você envia | O que acontece |
|---|---|
| Um .zip | Passa pelo preparo automático (limpeza de pastas pesadas, conferência do arquivo principal e da porta) e é extraído na raiz da aplicação. Limite de 100.0 MB. |
| Um arquivo qualquer | Vai do jeito que está, sem preparo, para a pasta de destino que você escolher (em branco = raiz). Serve para trocar um `config.json` ou um único script sem reenviar o projeto inteiro. |
A opção Reiniciar a aplicação depois do commit vem ligada. Desligue quando estiver enviando vários arquivos seguidos e reinicie só no último — o processo relê tudo de uma vez.
Deixando arquivos de fora com .rtcloudignore
Crie um arquivo chamado `.rtcloudignore` na raiz do seu .zip, com a mesma sintaxe do `.gitignore`. O que casar com as regras não é enviado. O arquivo principal e o arquivo de dependências nunca são ignorados, mesmo que uma regra os pegue.
# .rtcloudignore
.env.local
logs/
*.log
tests/
!tests/fixtures/essencial.jsonPastas pesadas já saem sozinhas
`node_modules`, `.git`, `__pycache__`, `.venv` e similares são removidos pelo preparo automático — não precisa listá-los. O ambiente reinstala as dependências a partir do seu arquivo de dependências.
Publicação automática pelo GitHub
Na aba Deploy você pode conectar um repositório. A partir daí, todo push na branch escolhida publica uma versão nova sozinho. O histórico de cada publicação, com as etapas e os arquivos alterados, fica na aba Publicações.
Continue lendo
Explorador de arquivos
Ver, editar, criar, renomear e apagar arquivos dentro da aplicação, direto do painel.
Problemas comuns
Os oito casos que respondem pela maioria dos chamados, com a causa e a correção de cada um.
Console e logs
Onde ver o que a sua aplicação está imprimindo, em tempo real, e como usar isso para achar problemas.