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 de controle.

Escolha uma fonte de deploy

Upload ZIP

Melhor para artefatos de build gerados por CI.

Repositório GitHub

Melhor quando a Hyze Cloud deve baixar o código de um repositório conectado.

Deploy a partir de um ZIP

Empacote seu app

Crie um ZIP com os arquivos que a Hyze Cloud deve executar. Inclua o entrypoint do seu app e o 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".

Veja 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"
  }
}

Defina autoDeploy como true quando quiser que a Hyze Cloud faça redeploy após pushes na branch selecionada. Omita startupCommand (ou use "auto") a menos que precise de um comando custom.

Checklist de 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 seu arquivo de dependências no ZIP.

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

Como fazer

Exemplos

Fazer deploy de um app

Escolha uma fonte de deploy

Upload ZIP

Repositório GitHub

Deploy a partir de um ZIP

Deploy pelo GitHub

Checklist de runtimes

Endpoints relacionados

Referência de Apps

Backups de app

​Escolha uma fonte de deploy

Upload ZIP

Repositório GitHub

​Deploy a partir de um ZIP

​Deploy pelo GitHub

​Checklist de runtimes

​Endpoints relacionados

Referência de Apps

Backups de app

Escolha uma fonte de deploy

Deploy a partir de um ZIP

Deploy pelo GitHub

Checklist de runtimes

Endpoints relacionados