Skip to main content

Como usar ambarks.json

O arquivo ambarks.json permite dizer ao AmbarksCloud como preparar e iniciar seu projeto quando o comportamento automático não é suficiente. Crie o arquivo na raiz do projeto:
Também é aceito o nome ambarks.config.json.

Exemplo completo

Campos (resumo)

Regras importantes

  • O JSON precisa ser válido.
  • O arquivo deve estar na raiz do projeto enviado.
  • O comando de start deve manter o processo rodando.
  • Servidores web devem escutar em 0.0.0.0.
  • A porta usada pelo comando deve bater com a porta interna configurada no projeto.

Exemplos por stack

Discord bot (Node.js)

Para bots, o mais importante é: processo em execução e logs claros (não há porta HTTP).
Veja: Deploy de bot Discord (Node.js).

Express (Node.js)

FastAPI (Python)

Site estático com build (Vite)

Exemplos inválidos (e por quê)

JSON inválido

Motivo: vírgula extra.

Campo desconhecido

Motivo: startCommand não é um campo reconhecido.

run.command vazio

Motivo: o comando precisa ser uma string não vazia.

Quando não usar

Se seu projeto precisa instalar pacotes do sistema, copiar arquivos para pastas específicas ou usar várias etapas de build, prefira Dockerfile.