squarecloud help
Uso
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
squarecloud app status ou squarecloud db status.
Saída
X. Veja também a página de status.
Depuração
- Defina
SQUARECLOUD_DEBUG=1para 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_KEYem vez de executar oauth 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
-yum comando que pede confirmação, sai com código1e não altera nada. Os comandos que pedem confirmação sãoapp delete,app env replace,app env remove --all,app file delete,app file read -osobre um arquivo existente,app network purge-cache,app snapshot restore,db delete,db snapshot restore,db credentials reset,workspace delete,workspace leave,workspace member removee oauth loginquando 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 doinfosão traduzidos. Para forçar o inglês, rode comLC_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.

