Fazendo seu primeiro deploy via Dashboard (Passo a passo)

Pré-requisitos

Antes de iniciar o processo na Dashboard, certifique-se de que você possui:

Uma conta ativa e validada na Square Cloud.
Um plano com recursos suficientes (RAM/CPU) para a sua aplicação.
O código da sua aplicação finalizado e testado localmente.

1. Preparando o seu projeto

Para que a Square Cloud entenda e execute o seu projeto corretamente, você precisa garantir que a estrutura dos arquivos está adequada.

O Arquivo de Configuração (`squarecloud.app`)

Este é o passo mais importante. Todo projeto precisa ter um arquivo chamado squarecloud.app na pasta raiz. Ele dita como a infraestrutura deve lidar com o seu código.

Embora nossa plataforma conte com um sistema inteligente de criação automática de configurações via dashboard, nada impede que você exerça seu lado 'power user'. Se preferir se antecipar e configurar os arquivos manualmente, sinta-se à vontade: nós apreciamos, e incentivamos esse nível de capricho técnico! 😉

Exemplo básico de um squarecloud.app para Node.js:

DISPLAY_NAME=Meu Primeiro App
DESCRIPTION=Uma aplicação incrível rodando na Square Cloud
MAIN=index.js
MEMORY=512
VERSION=recommended

Arquivos de Dependências

Certifique-se de que o arquivo que lista as bibliotecas do seu projeto está na raiz:

Node.js: package.json
Python: requirements.txt
Java: pom.xml ou build.gradle

Basicamente lembre-se de manter o arquivo de dependências correspondente a seu runtime selecionado.

2. Compactando os arquivos (.zip)

O Dashboard aceita o upload de projetos no formato .zip. Para garantir que o arquivo seja gerado corretamente:

Selecione todos os arquivos da raiz do seu projeto (incluindo o squarecloud.app, seu arquivo principal e os arquivos de dependência).
Clique com o botão direito e selecione a opção de compactar/zipar.
Atenção: Compacte os arquivos, não a pasta que os contém. Se você abrir o .zip, deve ver o código imediatamente, e não uma única pasta raiz.
O que NÃO incluir no .zip: Evite enviar pastas pesadas de dependências geradas localmente, como node_modules (Node.js), venv (Python) ou arquivos ocultos pesados como a pasta .git. A Square Cloud instalará as dependências automaticamente durante o deploy.

3. Realizando o Upload no Dashboard

Com o seu arquivo .zip pronto, é hora de enviar o projeto para a plataforma.

Acesse o Dashboard da Square Cloud e faça o login.
Na tela inicial, localize o botão "New Application" (Nova Aplicação) ou a área de upload.
Clique para selecionar o arquivo no seu computador ou simplesmente arraste e solte o seu arquivo .zip na área indicada.
Aguarde a barra de progresso ser concluída. O tempo varia de acordo com o tamanho do seu projeto e a sua conexão com a internet.

4. Acompanhando o Build e os Logs

Assim que o upload for concluído, a Square Cloud iniciará automaticamente o processo de build (construção) do seu ambiente.

Você será redirecionado para a página de gerenciamento da sua aplicação.
Acesse a aba "Logs" (ou Terminal).
Acompanhe as mensagens na tela. Você verá a plataforma baixando suas dependências (ex: executando npm install ou pip install) e, em seguida, iniciando o seu arquivo principal.
Se o seu código rodar sem erros, você verá a mensagem de sucesso no terminal, indicando que a aplicação está Online.

Deu algum erro?

A grande maioria dos erros no primeiro deploy está relacionada à ausência do arquivo squarecloud.app, erros de digitação dentro dele, ou ao .zip ter sido compactado de forma errada (zipando a pasta ao invés dos arquivos). Revise os passos acima ou consulte a Documentação Oficial para mais detalhes sobre a sua linguagem de programação específica.

Atualizado em: 07/04/2026

Este artigo foi útil?

Obrigado!