Introdução

O arquivo de configuração é um arquivo que será usado para configurar sua aplicação, ele será usado para definir o nome, descrição, versão, entre outras coisas.

Criando o arquivo de configuração

Nota: .app ou .config é a extensão do arquivo, não o nome.

É muito simples criar o arquivo de configuração, basta criar um arquivo com o nome squarecloud.app ou squarecloud.config e colocar os parâmetros de configuração dentro dele.

Parâmetros de configuração

Mínimo de memória para o bot é 100 MB (256MB MÍNIMO RECOMENDADO) e para o site 512 MB
Parâmetros obrigatóriosDescriçãoExemplo
MAINArquivo principal da sua aplicaçãoMAIN=index.js
MEMORYQuantidade de memória RAMMEMORY=256
VERSIONVersão da sua aplicaçãoVERSION=recommended
DISPLAY_NAMENome da aplicaçãoDISPLAY_NAME=My app!
SUBDOMAINSe você estiver enviando um siteSUBDOMAIN=mysite
Parâmetros opcionaisDescrição
DESCRIPTIONDescrição da sua aplicação
AUTORESTARTReiniciar sua aplicação se ela travar
START*Comando de inicialização personalizado

Exemplos de configuração

Este exemplo usa apenas parâmetros obrigatórios. (configuração mínima)
MAIN=index.js
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My app!
Este exemplo usa todos os parâmetros.
MAIN=index.js
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My app!
DESCRIPTION=My app is very cool!
URL do site será: mysite.squareweb.app
Este exemplo usa todos os parâmetros e comandos de inicialização personalizados em um site.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website!
DESCRIPTION=My website is very cool!
SUBDOMAIN=mysite
START=npm run start-build
AUTORESTART=true

Versões

Para cada linguagem, existe um parâmetro VERSION diferente, abaixo você pode ver as versões disponíveis para cada linguagem. Atualizado em 29/07/2023.

LanguageVersion recommendedVersion latestOld version
JavaScript [Node.js]20.9.0 (LTS - 2023)21.1.0
Python3.11.63.12
JavaJDK 17JDK 18
Elixir1.15.41.15.4
Rust1.76.01.76.0
PHP8.2.108.2.10
Go1.21.31.21.3
HTML/CSSBuild 07-29-23Build 07-29-23

Limites técnicos

Por razões de segurança e desempenho, existem limites nos parâmetros de configuração, abaixo você pode ver os limites de cada parâmetro.

ParameterLimit
MAIN32 characters
DISPLAY_NAME32 characters
DESCRIPTION280 characters
START128 characters
SUBDOMAIN63 characters

Este artigo foi traduzido por Square Cloud e pode estar desatualizado, recomendamos sempre conferir a versão original dele em inglês clicando aqui.