Pular para o conteúdo principal
A CLI da Square Cloud é uma ferramenta de linha de comando para fazer deploy e gerenciar suas aplicações, bancos de dados e workspaces pelo terminal.

Instale

Instalação da CLI da Square Cloud
  • Script de instalação: baixa a release mais recente, confere o download com os checksums da release e copia o squarecloud para ~/.local/bin (ou $SQUARECLOUD_INSTALL_DIR), sem sudo. Se essa pasta não estiver no seu PATH, ele pergunta antes de adicioná-la ao arquivo de inicialização do seu shell; sem um terminal para perguntar, ele imprime a linha a adicionar. Ele funciona com sh puro e suporta x86 (64 e 32 bits), arm64 e ARMv7.
  • Script do PowerShell: instala no Windows sem npm e sem direitos de administrador. Ele confere o download com os checksums da release, copia o squarecloud.exe para %LocalAppData%\squarecloud\bin (ou $env:SQUARECLOUD_INSTALL_DIR) e adiciona essa pasta ao PATH do seu usuário.
  • Pacotes .deb e .rpm: baixe o pacote da sua arquitetura na release mais recente e instale-o com o comando acima, a partir da pasta onde ele está.
  • Pacote npm: precisa do Node.js e do npm, então instale antes uma versão LTS atual do Node.js. Ele instala em x64 e arm64 (Apple Silicon, Windows on ARM, Linux) e em ARMv7 no Linux. Se o binário não puder ser baixado, o npm install falha em vez de deixar uma CLI que não consegue rodar.

Verifique um download

Toda release lista o SHA-256 de cada arquivo compactado e de cada pacote em checksums.txt, assinado com a assinatura keyless do cosign (checksums.txt.sigstore.json). Para conferir uma release à mão:

Verifique a instalação

Abra um novo terminal e execute:
Ele imprime Square Cloud CLI version seguido da versão instalada. Em seguida, faça login com squarecloud auth login.
A pasta que contém a CLI não está no seu PATH, ou o terminal foi aberto antes da instalação.
  1. Feche o terminal e abra um novo: um terminal só lê o PATH quando inicia.
  2. npm: execute npm prefix -g. No Windows, a pasta que ele imprime (em geral %AppData%\npm) precisa estar no seu PATH; no macOS e no Linux, a subpasta bin dela. Adicione-a nas configurações do sistema ou no perfil do seu shell.
  3. Script de instalação: confira se ~/.local/bin está no seu PATH com echo $PATH. Se não estiver, adicione ao perfil do seu shell a linha que o script imprimiu. Se o script avisou que outro squarecloud vem antes no seu PATH, remova essa cópia antiga.
Confira se o Node.js e o npm estão instalados com node --version e npm --version. Se não estiverem, instale o Node.js pelo nodejs.org, abra um novo terminal e execute o comando de instalação de novo.

Atualizar a CLI

Uso
Baixa a release mais recente para o seu sistema, confere o download com o checksums.txt da release e substitui o binário. No Windows, o binário em execução fica guardado como squarecloud.exe.old e é apagado na próxima execução. Ele não precisa de login.
Saída
Uma cópia instalada pelo npm ou por um pacote .deb ou .rpm pertence a esse gerenciador de pacotes, então o upgrade explica como atualizá-la:
Para um pacote, baixe antes o novo na release mais recente. A CLI verifica se há uma versão mais nova no máximo uma vez por dia, só em um terminal, e imprime o aviso no stderr, então ele nunca se mistura com a saída do --json. O aviso sugere o squarecloud upgrade.

Integração com o Explorador do Windows

Uso
O integration install adiciona Enviar para a Square Cloud ao menu de clique com o botão direito de pastas e arquivos .zip no Explorador de Arquivos do Windows (no Windows 11, em Mostrar mais opções). Ele grava em HKEY_CURRENT_USER, então não precisa de direitos de administrador. Ele aponta para o squarecloud.exe que o executou: execute-o de novo depois de mover a CLI. O integration uninstall remove todas as chaves que ele adicionou. Pelo menu, uma pasta cujo arquivo de configuração tem uma linha ID= recebe um commit nessa aplicação, como no squarecloud commit. Qualquer outra pasta ou arquivo .zip é enviado como uma nova aplicação, como no squarecloud upload. Uma notificação do Windows mostra o resultado. No macOS e no Linux, o comando explica que a integração só está disponível no Windows. Um atalho nesses sistemas leva poucas linhas:
  • GNOME Arquivos (Nautilus): salve este script como ~/.local/share/nautilus/scripts/Send to Square Cloud e torne-o executável.
  • macOS: no Automator, crie uma Ação Rápida que recebe pastas no Finder e executa o script de shell cd "$1" && squarecloud upload, com Passar entrada definido como como argumentos.

Idioma

Mensagens, ajuda e descrições das flags seguem o idioma do seu sistema, detectado a cada execução: inglês, português, espanhol, alemão, francês, italiano, japonês e chinês. A variável LANGUAGE, LC_ALL, LC_MESSAGES ou LANG tem prioridade quando definida; caso contrário, a CLI usa o idioma de exibição do sistema operacional (no Windows, o idioma de exibição, não o formato regional). Um idioma sem tradução volta para o inglês. Para escolher um idioma em uma única execução:

Próximos passos

Início rápido

Faça o deploy da sua primeira aplicação pelo terminal.

Autenticação

Faça login pelo navegador, com uma chave de API ou no CI.