Fazer deploy de um app

Use a API de Apps quando quiser deploys a partir de CI/CD, ferramentas internas ou seu próprio painel. Dois caminhos: enviar um ZIP pronto ou apontar para um repositório GitHub conectado.

Escolha a fonte de deploy

Fonte	Melhor para
ZIP	Artefatos de build gerados por CI
GitHub	Código-fonte em repositório conectado, com auto deploy

Deploy a partir de um ZIP

Empacote seu app

Crie um ZIP com os arquivos que a Hyze deve executar: entrypoint do app e manifesto de dependências.

Envie a requisição de deploy

curl -X POST https://api.hyzecloud.com/api/apps/deploy \
  -H "Authorization: Bearer hyze_sua_chave" \
  -F "file=@app.zip" \
  -F "name=my-api" \
  -F "runtime=node" \
  -F "memoryMB=512" \
  -F "exposePort=3000"

startupCommand é opcional. Omita (ou use auto) para a Hyze detectar o comando certo. Override só se precisar: -F "startupCommand=node server.js".

Verifique o resultado

Consulte GET /api/apps/:appId até status: running e abra os logs:

curl "https://api.hyzecloud.com/api/apps/app_001/logs?tail=200&timestamps=true" \
  -H "Authorization: Bearer hyze_sua_chave"

Deploy pelo GitHub

Use POST /api/apps/deploy-from-repo após conectar o GitHub no dashboard:

{
  "name": "my-api",
  "runtime": "node",
  "memoryMB": 512,
  "exposePort": 3000,
  "autoDeploy": true,
  "repository": {
    "id": "repo_001",
    "owner": "hyzecloud",
    "name": "my-api",
    "branch": "main"
  }
}

Com autoDeploy: true, pushes na branch disparam novos deploys automaticamente.

Runtimes

Runtime	Auto detect	Observações
`node`	Sim (API, site estático, Vite, Next…)	Exponha a mesma porta em que seu servidor escuta.
`bun`	Sim	Mantenha o lockfile no artefato quando possível.
`python`	Sim	Inclua o arquivo de dependências no ZIP.

Exemplos de override opcional: node server.js, bun run start, python main.py.

Com porta exposta, informe o host completo como subdomínio (ex.: my-api.hyzecloud.app), não só o prefixo.

Problemas comuns

Deploy conclui mas o app não responde

Confira exposePort e se o servidor escuta em 0.0.0.0. Veja os logs para descartar crash no boot.

Comando de start errado

Passe startupCommand com override (ex.: node server.js) ou deixe auto para a detecção padrão.

Deploy

Operação

Fazer deploy de um app

Escolha a fonte de deploy

Deploy a partir de um ZIP

Deploy pelo GitHub

Runtimes

Problemas comuns

Próximos passos

Referência de Apps

Backups de app

​Escolha a fonte de deploy

​Deploy a partir de um ZIP

​Deploy pelo GitHub

​Runtimes

​Problemas comuns

​Próximos passos

Referência de Apps

Backups de app

Escolha a fonte de deploy

Deploy a partir de um ZIP

Deploy pelo GitHub

Runtimes

Problemas comuns

Próximos passos