GitHub Actions

Com este workflow, cada push na main envia o código para o projeto na Cube e espera a instalação. Se a instalação falhar ou o app cair nos primeiros 15 segundos depois de subir, o passo falha e o GitHub avisa.

1. Guarde a chave e o ID

No painel, crie uma chave de leitura e escrita em Chaves de API e copie o ID do projeto (fica no topo da página do projeto, ou em cube projects). No repositório do GitHub, em Settings › Secrets and variables › Actions:

Onde	Nome	Valor
Aba Secrets	`CUBE_API_KEY`	a chave `cube_…`
Aba Variables	`CUBE_PROJECT_ID`	o ID do projeto

A chave vai só nos segredos. Nunca escreva a chave no workflow nem em outro arquivo do repositório: quem lê o repositório poderia enviar código e mexer nas variáveis do seu projeto. Se ela vazar, revogue em Chaves de API e crie outra.

2. Crie o workflow

.github/workflows/deploy.yml

name: Deploy na Cube
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v5
        with:
          node-version: 22
      - run: npm i -g https://cubehosting.com.br/cli/latest.tgz
      - run: cube deploy --project "$CUBE_PROJECT_ID"
        env:
          CUBE_API_KEY: ${{ secrets.CUBE_API_KEY }}
          CUBE_PROJECT_ID: ${{ vars.CUBE_PROJECT_ID }}

Faça o commit e o push: a execução aparece na aba Actions do repositório, com a saída da instalação.

O que é enviado

O cube deploy envia a raiz do repositório, respeitando o .gitignore e o .cubeignore, dentro do limite do .zip do seu plano. As dependências são instaladas na Cube, então node_modules e venv nunca vão. Detalhes em CLI cube.

Projeto numa subpasta: cube deploy ./bot --project "$CUBE_PROJECT_ID". O .gitignore da raiz do repositório também vale para a subpasta.
Build no CI: rode o build antes do cube deploy e traga a pasta gerada de volta no .cubeignore (!dist/) se o .gitignore a deixa de fora. Sem isso, a Cube roda o build do cube.json na instalação.
Não esperar a instalação: acrescente --no-wait.
Travar a versão da CLI: troque latest.tgz pelo número, como cube-cli-0.1.2.tgz.

Sem a CLI

O mesmo envio com curl está em Enviar novo código. Ele não espera a instalação nem respeita o .gitignore.

Começando

Hospedagem

Conta e planos

Cube AI

Ferramentas

Segurança

1. Guarde a chave e o ID

2. Crie o workflow

O que é enviado

Sem a CLI

​1. Guarde a chave e o ID

​2. Crie o workflow

​O que é enviado

​Sem a CLI

1. Guarde a chave e o ID

2. Crie o workflow

O que é enviado

Sem a CLI