Upload & Deploy

apps.upload() cria uma aplicação do zero a partir de um .zip de código. É o principal ponto de entrada para colocar uma aplicação nova no ar via SDK.

upload(zipFile: FileInput, options?: UploadAppOptions, fileName?: string): Promise<UploadAppResponse>

Exemplo completo

import { readFile } from 'node:fs/promises';

const zipBuffer = await readFile('./meu-app.zip');

const result = await sonder.apps.upload(
  zipBuffer,
  {
    appName: 'minha-api',
    language: 'node',
    command: 'node index.js',
    memory: 512,
    domain: 'minha-api',
  },
  'meu-app.zip',
);

console.log(result.appId, result.status);

Parâmetro `zipFile`

FileInput

required

Conteúdo do .zip a ser enviado. Aceita Buffer, Blob, ArrayBuffer ou Uint8Array.

import { readFile } from 'node:fs/promises';
const zipBuffer = await readFile('./meu-app.zip');
await sonder.apps.upload(zipBuffer);

const blob = new Blob([bytes], { type: 'application/zip' });
await sonder.apps.upload(blob);

const file = inputElement.files[0]; // File estende Blob
await sonder.apps.upload(file, {}, file.name);

Parâmetro `options`

string

Nome de exibição da aplicação.

string

Linguagem/runtime da aplicação (ex: node, python).

string

Comando de start customizado, sobrescrevendo o padrão detectado.

string | number

Limite de memória em MB.

string

Subdomínio desejado para a aplicação. Depois de criada, esse subdomínio pode ser consultado e ter um domínio customizado apontado para ele — veja Domínios.

Todos os campos de options são opcionais e omitidos da requisição quando não informados — o SDK só anexa ao FormData os campos presentes.

Parâmetro `fileName`

string

default:"app.zip"

Nome do arquivo enviado no campo file do multipart/form-data.

Resposta — `UploadAppResponse`

Campo	Tipo	Descrição
`appId`	`string`	ID (UUID) da aplicação criada.
`name`	`string`	Nome da aplicação.
`type`	`string`	Tipo da aplicação.
`domain`	`string?`	Domínio atribuído, se houver.
`language`	`string`	Linguagem/runtime detectada ou informada.
`imageTag`	`string`	Tag da imagem gerada para o build.
`containerName`	`string`	Nome do container criado.
`buildLogPath`	`string`	Caminho do log de build.
`runLogPath`	`string`	Caminho do log de execução.
`memoryMb`	`number`	Memória alocada, em MB.
`status`	`string`	Status inicial da aplicação após o upload.

O upload é enviado como multipart/form-data. Não defina o header Content-Type manualmente ao usar fetch customizado — o boundary precisa ser gerado pelo runtime.

Substituir código de uma app existente

Para reimplantar código em uma aplicação já criada, use apps.commit() em vez de apps.upload().

Comece aqui

Aplicações

Databases

Conta

Tratamento de Erros

Exemplo completo

Parâmetro `zipFile`

Parâmetro `options`

Parâmetro `fileName`

Resposta — `UploadAppResponse`

Substituir código de uma app existente

​Exemplo completo

​Parâmetro zipFile

​Parâmetro options

​Parâmetro fileName

​Resposta — UploadAppResponse

Substituir código de uma app existente

Exemplo completo

Parâmetro `zipFile`

Parâmetro `options`

Parâmetro `fileName`

Resposta — `UploadAppResponse`