Skip to main content

squarecloud help

Uso
Lista todos os comandos ou explica um deles. A ajuda segue o idioma do seu sistema.
Saída

Flags globais

Os comandos destrutivos também aceitam -y/--yes para pular a confirmação y/N. A página de cada comando indica quando.

squarecloud status

Uso
Confere se a plataforma da Square Cloud está operando normalmente. Funciona sem login. Para uma aplicação ou um banco de dados, use squarecloud app status ou squarecloud db status.
Saída
Quando a plataforma informa um problema, a linha começa com X. Veja também a página de status.

Depuração

  • Defina SQUARECLOUD_DEBUG=1 para registrar cada requisição à API no stderr: método, caminho, status e duração. Cabeçalhos, query strings e corpos nunca são registrados, então a saída é segura para compartilhar.
  • As requisições de leitura são repetidas automaticamente após um erro de rede ou quando a plataforma está ocupada por alguns instantes.
  • Ctrl+C cancela a requisição em andamento; um segundo Ctrl+C encerra um comando que está aguardando uma resposta sua.

Scripts e CI

A CLI se comporta de forma previsível quando roda sem uma pessoa no teclado:
  • Autenticação: defina SQUARECLOUD_API_KEY em vez de executar o auth login. Veja Autenticação.
  • Passe os IDs explicitamente. Os seletores de aplicação e de banco de dados precisam de um terminal. Veja como a CLI encontra sua aplicação.
  • Códigos de saída: toda falha sai com código 1, inclusive quando a CLI foi instalada pelo npm. Confira os códigos de saída, não o texto das mensagens.
  • Confirmações falham de forma segura. Responder não, ou rodar sem terminal e sem -y um comando que pede confirmação, sai com código 1 e não altera nada. Os comandos que pedem confirmação são app delete, app env replace, app env remove --all, app file delete, app file read -o sobre um arquivo existente, app network purge-cache, app snapshot restore, db delete, db snapshot restore, db credentials reset, workspace delete, workspace leave, workspace member remove e o auth login quando ele substituiria a chave de outra conta.
  • O stdout traz só resultados. Erros, a mensagem de “não logado”, as perguntas de confirmação, as linhas de falha e o aviso de atualização vão para o stderr. Com upload --json, as mensagens de progresso também vão para o stderr.
  • Leia o --json, não as tabelas. Em sistemas que não estão em inglês, os cabeçalhos das tabelas e os rótulos do info são traduzidos. Para forçar o inglês, rode com LC_ALL=en_US.UTF-8.
  • Já estar no estado pedido é sucesso. Iniciar uma aplicação ou um banco de dados que já está rodando, ou parar um que já está parado, avisa e sai com código 0.
Para fazer deploy pelo GitHub Actions, veja o workflow de deploy automático na central de ajuda.

Relacionados