Skip to main content

O que é

sonder.config é um arquivo de texto simples que você pode incluir na raiz do .zip enviado para POST /v1/apps/upload. Ele permite configurar o app sem precisar preencher campos no formulário — ideal para quem versiona a configuração junto com o código (CI/CD, scripts de deploy, etc.).
Campos enviados explicitamente no formulário de upload (appName, language, command, memory, domain) sempre têm prioridade sobre o que estiver no sonder.config. Use o arquivo como um valor padrão versionado, e o formulário para overrides pontuais.

Formato

Texto plano, uma chave por linha, no formato CHAVE=valor. Linhas vazias e linhas iniciadas com # são ignoradas (comentários).
sonder.config

Chaves suportadas

string
Nome do app.
string
Linguagem/runtime do app. Veja a tabela completa abaixo.
string
Comando usado para iniciar o app dentro do container.
string
Memória alocada, em MB.
string
Subdomínio desejado.
Qualquer outra chave é ignorada silenciosamente. Não há campo TYPE reconhecido neste parser — o tipo do app é definido pelo domain informado (se houver domínio, o app é tratado como aplicação web).

Linguagens suportadas

Internamente, o valor de LANGUAGE só importa para decidir qual Dockerfile especializado vai ser usado no build. As linguagens abaixo têm um builder dedicado:
Qualquer outro valor (incluindo js, node, nodejs, vazio, ou não informado) faz o app ser construído com o builder Node.js, que é o padrão da plataforma. Se seu projeto é Node.js, LANGUAGE=js funciona, mas também funcionaria omitir a chave.

Exemplo completo — API em Node.js

sonder.config

Exemplo completo — Bot em Python (sem domínio)

Bots e workers que não expõem uma porta HTTP não precisam de DOMAIN:
sonder.config