Instale

- Script de instalação: baixa a release mais recente, confere o download com os checksums da release e copia o
squarecloudpara~/.local/bin(ou$SQUARECLOUD_INSTALL_DIR), semsudo. Se essa pasta não estiver no seuPATH, 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 comshpuro 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.exepara%LocalAppData%\squarecloud\bin(ou$env:SQUARECLOUD_INSTALL_DIR) e adiciona essa pasta aoPATHdo seu usuário. - Pacotes
.debe.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 installfalha 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 emchecksums.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:Square Cloud CLI version seguido da versão instalada. Em seguida, faça login com squarecloud auth login.
squarecloud: command not found
squarecloud: command not found
A pasta que contém a CLI não está no seu
PATH, ou o terminal foi aberto antes da instalação.- Feche o terminal e abra um novo: um terminal só lê o
PATHquando inicia. - npm: execute
npm prefix -g. No Windows, a pasta que ele imprime (em geral%AppData%\npm) precisa estar no seuPATH; no macOS e no Linux, a subpastabindela. Adicione-a nas configurações do sistema ou no perfil do seu shell. - Script de instalação: confira se
~/.local/binestá no seuPATHcomecho $PATH. Se não estiver, adicione ao perfil do seu shell a linha que o script imprimiu. Se o script avisou que outrosquarecloudvem antes no seuPATH, remova essa cópia antiga.
O npm install falha no Windows
O npm install falha no Windows
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
.deb ou .rpm pertence a esse gerenciador de pacotes, então o upgrade explica como atualizá-la:
--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 Cloude 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ávelLANGUAGE, 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.

