Faça deploy e controle suas aplicações pelo terminal
Entre com um código no navegador, envie qualquer pasta com um só comando e acesse logs, bancos de dados e áreas de trabalho no mesmo prompt, com uma saída que seus scripts conseguem ler.
Instale com um só comando
O script de instalação e o pacote npm baixam o build do seu sistema da release mais recente e conferem o checksum antes de instalar.
macOS, Linux e WSL
curl -fsSL https://cli.squarecloud.app/install | bashInstala em /usr/local/bin, por isso pode pedir sua senha.
Windows
npm i -g @squarecloud/cliRequer o Node.js com npm. O mesmo comando também funciona no macOS e no Linux.
- Conferido com os checksums SHA-256 da release
- Builds para x86 e ARM, incluindo Apple silicon
- Para atualizar, rode o mesmo comando de novo
Faça login sem copiar nenhuma chave
A CLI mostra um código, você aprova no navegador e o terminal recebe uma chave só dele, do mesmo jeito que a extensão para VS Code se conecta.
- 1
O terminal mostra um código
Rode o comando de login e o navegador abre na página de aprovação, enquanto o terminal mostra um código de oito caracteres e uma contagem regressiva.
- 2
Você aprova no navegador
Digite o código na página da Square Cloud e aprove. Nunca digite um código que alguém enviou para você.
- 3
A CLI está autenticada
O terminal confirma sua conta e salva uma chave criada para ele, só com as permissões que os comandos usam.
- Cada chave vale 90 dias, e
auth whoamimostra até quando - Pergunta antes de trocar outra conta nesta máquina
- Via SSH,
--no-browsermostra o link para abrir em qualquer lugar - Já tem uma chave? Use
--tokenou--with-token
Deploy de qualquer pasta
Envie a pasta em que você está como uma nova aplicação, mande alterações para uma que já existe ou vincule um repositório do GitHub para que cada push faça o deploy.
Enviar uma aplicação
A CLI compacta a pasta atual com suas regras de exclusão, cria a aplicação e mostra o link da página dela no painel.
uploadupload --file- Ou envie um zip que você já tem
- Grava o novo ID no squarecloud.app, se o projeto tiver um
Commit de alterações
Envie a pasta, ou um zip, para uma aplicação que já existe. Ela mantém o ID, o domínio e as configurações.
commitcommit -rcommit --path- Reinicia a aplicação depois, se você pedir
- Pode colocar os arquivos numa pasta da aplicação
Deploy a cada push
Vincule um repositório e uma branch pelo GitHub App da Square Cloud, ou crie um webhook com um token do GitHub, sem sair do terminal.
app deploy github linkapp deploy webhookapp deploy list- Lista os deploys recentes com commit, estado e branch
- Ou rode a CLI no GitHub Actions
Um só arquivo de exclusão para a CLI e o VS Code
upload, commit e zip deixam de fora o que o squarecloud.ignore lista na raiz do projeto. A extensão para VS Code lê o mesmo arquivo, com as mesmas regras.
A sintaxe do .gitignore
#para comentários,!para trazer um caminho de volta,dir/só para pastas,/buildsó na raiz, e*,?,[abc]e**. Vale a última linha que corresponder, sem diferenciar maiúsculas de minúsculas.Padrões sensatos
node_modules,.git,.github,.vscodee os lockfiles do npm, pnpm e Yarn ficam de fora antes das suas regras. Uma linha como!yarn.locktraz um de volta.Confira antes de enviar
squarecloud zipgera o mesmo arquivo compactado na sua pasta, para você abrir e ver exatamente o que seria enviado.
As variáveis chegam exatamente como você digitou
Sua aplicação carrega as variáveis por meio de um shell. Desde a versão 3.1.1, a CLI envia entre aspas os valores com espaços ou caracteres como $, & ou ;, para que o shell não os corte nem os expanda.
Defina pelo terminal
Passe quantos pares KEY=VALUE quiser. A CLI pega a aplicação do squarecloud.app ou deixa você escolher numa lista.
app env setapp env list- Aspas simples, ou duplas quando o valor tem uma
- Um valor que já está entre aspas vai como foi escrito
Carregue um .env
Lê linhas KEY=VALUE de um arquivo e ignora comentários e linhas em branco. Linhas que começam com export e valores entre aspas também funcionam.
--from-file .env- Funciona ao definir ou substituir variáveis
- A listagem mostra tudo de volta como KEY=VALUE
Mudanças em massa
Substitua todas as variáveis de uma vez ou remova todas. As duas ações pedem confirmação antes de mudar qualquer coisa, e substituir exige pelo menos uma variável nova.
app env replaceapp env remove --all-y- Uma flag confirma por você em scripts
- Responda não e nada muda
Feita para scripts e CI
Resultados que um programa consegue ler, códigos de saída que dizem a verdade e uma chave que funciona sem navegador.
JSON quando você pede
Comandos que mostram dados podem responder em JSON, só com o resultado no stdout. Os outros recusam a flag com um erro, em vez de imprimir um texto que atrapalharia um parser.
--jsonCódigos de saída fiéis
Toda falha sai com 1. Quando não dá para pedir uma confirmação, sem terminal e sem uma flag que responda, o comando falha e não muda nada.
-yUm stdout limpo
Erros, perguntas e avisos vão para o stderr, e o progresso também quando você pede JSON, então um pipe leva só o resultado.
stdoutstderrChave para pipelines
Defina uma chave da sua conta numa variável de ambiente e todo comando passa a usá-la, sem login. Com CI igual a true, o login pelo navegador não começa.
SQUARECLOUD_API_KEYCI=trueDepuração sem segredos
Uma variável mostra no stderr o método, o caminho, o status e a duração de cada chamada à API, nunca cabeçalhos, query strings ou corpos.
SQUARECLOUD_DEBUG=1GitHub Actions
A Action da Square Cloud instala a CLI no runner, confere com os checksums da release e roda qualquer comando com a sua chave.
squarecloudofc/github-action@v2
O resto da plataforma também
Logs, métricas, arquivos, snapshots, domínios, bancos de dados e áreas de trabalho, cada um a um comando de distância.
Logs e stream ao vivo
Mostre as últimas linhas ou acompanhe a saída ao vivo junto com cada mudança de status. O que a sua aplicação escreve no stderr continua no stderr.
app logsapp realtimeStatus e métricas
CPU, memória, disco e uptime de uma aplicação ou uma linha para cada uma, além das métricas das últimas 24 horas.
app status --allapp metricsArquivos remotos
Liste, leia, escreva, mova e exclua os arquivos da aplicação. Escrever a partir de um arquivo preserva binários, e ler para um arquivo pergunta antes de sobrescrevê-lo.
app file readapp file writeSnapshots
Crie um snapshot e baixe, liste as versões e restaure uma, para aplicações e bancos de dados.
app snapshot createdb snapshot restoreDomínios e tráfego
Defina um domínio personalizado, obtenha os registros DNS a criar, leia analytics, erros e desempenho da edge e limpe o cache.
app network domainapp network analyticsBancos de dados
Crie bancos MongoDB, MySQL, PostgreSQL e Redis, inicie ou pare cada um, baixe o certificado TLS e troque a senha.
db createdb credentials reset
Cuidadosa, aberta e no seu idioma
Em oito idiomas
Mensagens, ajuda e tabelas seguem o idioma de exibição do seu sistema sempre que você usa a CLI. LC_ALL escolhe outro para um único comando.
Sem ID para decorar
A maioria dos comandos pega a aplicação do squarecloud.app ou lista as suas para você escolher.
Pede confirmação
Excluir, substituir todas as variáveis, restaurar um snapshot ou limpar o cache pergunta antes, e scripts podem confirmar com uma flag.
Código aberto
O código está no GitHub, e cada release publica seus builds com checksums SHA-256.
Um plano para cada fase do seu projeto
Comece pequeno e escale quando precisar, sem contratos de fidelidade.
Hobby
Para validar ideias, bots e projetos pessoais
A partir de R$ 12,49/mês
- 1 GB de RAM
- 1 vCPU
- Até 4 projetos
- Escala até 2 GB no mesmo plano
Standard
RecomendadoPara produção, com bancos de dados e domínio próprio
A partir de R$ 44,99/mês
- 4 GB de RAM
- 4 vCPU
- Até 16 projetos
- Escala até 8 GB no mesmo plano
Pro
Para alta escala, com snapshots diários das aplicações e analytics avançado
A partir de R$ 124,99/mês
- 12 GB de RAM
- 6 vCPU
- Até 48 projetos
- Escala até 24 GB no mesmo plano
4,9 de 5 · 402 avaliações no Google + TrustpilotTrustpilot