Deploy pelo GitHub - Hyze Cloud

Use deploys por GitHub quando seu código-fonte já estiver em um repositório. A Hyze baixa a branch, instala dependências, detecta o comando de start e inicia o app.

Pré-requisitos

Conecte o GitHub no dashboard antes de usar este fluxo: Dashboard → GitHub (ou verifique o status com GET /api/integrations/github/status).

Deploy de um repositório

curl -X POST https://api.hyzecloud.com/api/apps/deploy-from-repo \
  -H "Authorization: Bearer hyze_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "api",
    "runtime": "node",
    "memoryMB": 512,
    "exposePort": 3000,
    "autoDeploy": true,
    "repository": {
      "owner": "hyzecloud",
      "name": "api",
      "branch": "main"
    }
  }'

Com autoDeploy: true, todo push na branch selecionada dispara um novo deploy automaticamente.

Verificar o resultado

Confirme o status: GET /api/apps/:appId — aguarde status: running
Abra os logs: GET /api/apps/:appId/logs para ver a inicialização

Problemas comuns

404 ao listar repositórios

A integração GitHub não está conectada no workspace, ou o app foi instalado com acesso restrito a outros repositórios. Reconecte em Dashboard → GitHub.

Deploy falha na etapa de build

Verifique o histórico: GET /api/apps/:appId/builds. Causas comuns: lockfile ausente, versão de runtime incompatível ou comando de start errado. O startupCommand é opcional — omita e a Hyze detecta (Vite, Next, Node, estático, Python).

App sobe mas não responde

Confira exposePort: ele deve ser a mesma porta em que seu servidor escuta, e o servidor deve aceitar conexões em 0.0.0.0.

Próximos passos

Ver logs

Inspecione a saída de inicialização e runtime.

Referência de Apps

Todos os endpoints de apps, incluindo deploy por ZIP.

Última modificação em 1 de setembro de 2026

​Pré-requisitos

​Deploy de um repositório

​Verificar o resultado

​Problemas comuns

​Próximos passos

Ver logs

Referência de Apps

Pré-requisitos

Deploy de um repositório

Verificar o resultado

Problemas comuns

Próximos passos