Skip to main content

​
Como fazer deploy via ZIP

O deploy via ZIP é indicado para testes rápidos, protótipos e projetos que ainda não estão conectados ao GitHub.

​
Preparação do ZIP

O ZIP deve conter o código do projeto e os arquivos necessários para instalar, buildar e iniciar a aplicação. Estrutura recomendada: 
meu-projeto.zip
  package.json
  package-lock.json
  src/
  ambarks.json
Também pode existir uma única pasta raiz dentro do ZIP: 
meu-projeto.zip
  meu-projeto/
    package.json
    src/

​
Evite incluir

  • node_modules
  • .git
  • pastas de cache
  • arquivos temporários
  • builds locais muito grandes, quando eles puderem ser gerados no deploy

​
Enviar pelo dashboard

  1. Clique em Criar Novo Projeto.
  2. Escolha Arquivo ZIP.
  3. Selecione o arquivo .zip.
  4. Confirme as configurações de memória, porta e runtime.
  5. Clique em Criar & Deploy.
  6. Abra os logs para acompanhar o progresso.

​
Limite de tamanho do ZIP

  • Tamanho máximo por upload: 100 MB

​
Quando usar ambarks.json

Adicione ambarks.json na raiz do ZIP quando:
  • O comando de instalação não for o padrão.
  • O projeto precisa rodar um build antes de iniciar.
  • O comando de start não é npm start, python main.py ou equivalente.
  • Você quer deixar o deploy previsível para próximos envios.

​
Problemas comuns

ProblemaO que verificar
ZIP não enviaConfirme formato .zip e tamanho do arquivo
Runtime não detectadoEscolha o runtime no dashboard ou adicione ambarks.json
Build falhaVeja se as dependências e lockfiles foram incluídos
App inicia mas não abreConfira porta interna e se o app escuta em 0.0.0.0