Visão Geral

Listagem, detalhes, estatísticas, logs e ciclo de vida

O recurso sonder.apps interage com as aplicações implantadas na plataforma. Esta página cobre leitura de dados e ciclo de vida (start/stop/restart/rebuild/delete). Para criar ou substituir código, veja Upload & Deploy e Commit & Backup. Para o filesystem remoto, veja Arquivos. Para configurar variáveis, veja Variáveis de Ambiente.

Todo método que recebe appId valida o formato antes de chamar a API. Um ID que não seja um UUID v4 válido lança erro localmente, sem requisição de rede.

Listar aplicações

const apps = await sonder.apps.list();

GET · /v1/apps

Retorna um array de AppListItem, com id, name, status, running, uptime, memoryMb, domain, entre outros campos. uptime informa o tempo de atividade em segundos desde o último início e vale 0 quando a aplicação está parada.

Obter detalhes

const app = await sonder.apps.get(appId);

Retorna AppDetails, incluindo command, createdAt, uptime, memoryUsage, oomKilled e oomNotified. uptime é o tempo de atividade em segundos desde o último início.

Estatísticas de uso

const stats = await sonder.apps.stats(appId);
// { running, cpu, ram, ramPercent, networkRx, networkTx, pids }

Logs

const { logs } = await sonder.apps.logs(appId, { tail: 200 });

tail · number · default: "100"

Número de linhas finais do log a retornar. O padrão de 100 é aplicado pela API quando omitido.

Ciclo de vida

await sonder.apps.start(appId);   // inicia com as variáveis de ambiente salvas
await sonder.apps.stop(appId);    // para o container sem excluir a aplicação
await sonder.apps.restart(appId); // reinicia com as variáveis de ambiente salvas
await sonder.apps.rebuild(appId); // reconstrói a imagem a partir do código atual
await sonder.apps.delete(appId);  // remoção permanente

• Start inicia o container usando a configuração e as variáveis de ambiente salvas. Se ele já estiver online, a API sincroniza o estado.
• Stop para o container; não exclui a aplicação nem remove suas configurações ou variáveis.
• Restart reinicia o container com os valores de ambiente atualmente salvos. Se as variáveis foram alteradas, use esta operação para aplicá-las. O restart não é permitido enquanto um rebuild está em andamento.

As ações de start, stop e restart retornam { success, appId, message }. Elas não recebem corpo de requisição. Consulte também as páginas de referência de start, stop e restart.

Referência de métodos

Método	Rota	Descrição
apps.list()	GET /v1/apps	Lista todas as aplicações do usuário.
apps.get(appId)	GET /v1/apps/:id	Detalhes de uma aplicação.
apps.stats(appId)	GET /v1/apps/:id/stats	Uso de CPU, RAM e rede.
apps.logs(appId, { tail })	GET /v1/apps/:id/logs	Últimas linhas de log.
apps.start(appId)	POST /v1/apps/:id/start	Inicia com a configuração salva.
apps.stop(appId)	POST /v1/apps/:id/stop	Para o container sem remover a aplicação.
apps.restart(appId)	POST /v1/apps/:id/restart	Reinicia; aplica as variáveis de ambiente salvas.
apps.rebuild(appId)	POST /v1/apps/:id/rebuild	Reconstrói a imagem.
apps.delete(appId)	POST /v1/apps/:id/delete	Remove a aplicação.