cube faz pelo terminal o que a API pública faz: listar e ver projetos, enviar a pasta do projeto, acompanhar os logs, iniciar, parar e reiniciar, gravar variáveis de ambiente, mexer nos arquivos do projeto e no Blob. Ela usa a sua chave de API, com as mesmas permissões e limites.
Instalar
Precisa do Node.js 20 ou mais novo, no macOS, no Linux, no WSL ou no Windows.cube --version. Para atualizar:
npm i -g @cubehosting/cli@0.3.1.
O pacote da Cube no npm é só o
@cubehosting/cli: um pacote de nome parecido, como cube-cli, não é da Cube. Sem acesso ao registro do npm, instale pelo site da Cube: npm i -g https://cubehosting.com.br/cli/latest.tgz (ou cube-cli-0.3.1.tgz para uma versão fixa).Entrar
Crie uma chave em Chaves de API no painel. O modelo Leitura basta para ver projetos e logs; para enviar e controlar, o Deploy (CI/CD); para as variáveis, marquevariables:read e variables:write; para os arquivos do projeto, files:read (ls, cat e get) e files:write (put, rm e mv); para o Blob, blob:read e blob:write (o modelo Só Blob). O cube apply pede projects:deploy, e o cube deploy sem --project, que cria um projeto, projects:create. Para esperar a instalação, o cube deploy e o cube apply leem o log dela (projects:logs) ou o status do projeto (projects:read); o Deploy (CI/CD) tem as duas. Sem projects:logs, o log não aparece e o fim chega pelo status. Sem nenhuma das duas, a CLI não vê o fim: a versão 0.3.1 espera os 35 minutos e sai com 1, então use --no-wait. Veja as permissões.
cube logout apaga a chave deste computador. Ela continua valendo até você revogar em Chaves de API.
Comandos
O
<id> é o ID do projeto: está em cube projects e no topo da página do projeto no painel.
Opções de cube logs:
As linhas de
stderr saem na saída de erro do terminal. O log passa por um filtro que tira as sequências de controle do terminal (cores, título da janela), como no painel.
Variáveis sem deixar rastro
cube vars set <id> TOKEN=valor deixa o valor no histórico do terminal. Para evitar, passe só o nome: a CLI pede o valor sem mostrar na tela.
printf '%s' "$TOKEN" | cube vars set <id> DISCORD_TOKEN. A entrada padrão dá o valor de um nome só por comando; nome que fica sem valor é recusado, sem gravar nada (para gravar vazio, use NOME=). Variável nova ou trocada vale na próxima subida: a CLI avisa quando é preciso cube restart.
Arquivos do projeto
cube files mexe nos arquivos do projeto como a aba Arquivos do painel, nos planos pagos (no Free, files_not_allowed). O caminho é a partir da raiz do projeto, sem / no começo e sem ... A mudança fica nos arquivos e vale no projeto com o cube apply:
node_modules e as outras pastas que a instalação cria são só leitura: para mudar uma dependência, troque o package.json (ou o manifesto da sua linguagem) e rode cube apply.
Enviar com cube deploy
- Confere o limite do .zip do seu plano (5 MB no Free, 10 MB nos pagos).
- Compacta a pasta, deixando de fora o que o
.gitignoree o.cubeignoremandam (os da pasta e das subpastas, e também os das pastas acima até a raiz do repositório git, como faz o git), e as pastas que a Cube ignora de qualquer jeito (node_modules,.git,venv,.venv,__pycache__). Se passar do limite, para antes de enviar e mostra os maiores arquivos. A partir da versão 0.3.1, também deixa de fora as pastas que o build gera de novo (como a.nextcom o scriptbuild: “Aviso: Tiramos a pasta .next: ela é gerada no build aqui.”) e avisa quando a pasta é o compilado em vez do código-fonte; um programa compilado para Mac ou Windows como arquivo principal para o envio. Veja Envie o código-fonte, não o compilado. - Envia como um novo código do projeto: a configuração não muda, e as dependências só são reinstaladas se o
package.json, opackage-lock.jsonou orequirements.txtmudaram. - Mostra a instalação ao vivo até o projeto sair de “Instalando” (até 35 minutos; passou disso, sai com 1 e diz como acompanhar). Se ele subiu, confere por mais 15 segundos se continua no ar.
- Sai com o código 0 se o projeto ficou no ar (ou parado, se estava parado) e 1 se a instalação falhou ou se o app caiu, reiniciou ou parou nesses 15 segundos (um token errado, por exemplo). Uma queda depois disso não muda o resultado: acompanhe com
cube logs <id> --follow.
--no-wait envia e termina sem esperar a instalação.
Sem --project, o cube deploy cria um projeto novo a partir do cube.json da pasta, e já inicia. Sem cube.json, ele cria pelo arquivo de outra hospedagem (0.2.5), por um site só de HTML (o index.html na raiz), por um projeto Go (o go.mod na raiz, 0.2.6), por um site PHP (o composer.json na raiz, 0.2.7; com o package.json do Vite do Laravel junto, 0.2.8) por um projeto .NET (o projeto ou a solução na raiz, 0.2.9), por um projeto Elixir (o mix.exs na raiz, 0.2.9), por um projeto Rust (o Cargo.toml na raiz, 0.3.1) ou por um único .jar na raiz (Java, 0.2.6); fora disso (um projeto Ruby, por exemplo, precisa do comando), não envia nada. No fim, mostra o ID do projeto novo para os próximos envios.
O .cubeignore
Mesmo formato do.gitignore, na raiz ou em qualquer subpasta, lido depois do .gitignore da mesma pasta. Use para deixar de fora o que o git guarda mas o servidor não precisa, ou para trazer de volta, com !, algo que o .gitignore deixa de fora.
.cubeignore
Erros
Todo erro sai em português, com o código da API e o link de como resolver:cube deploy faz até 5 pedidos (6 com --project) e um cube apply, até 4, mais 1 a cada 20 segundos de instalação.
