Pular para o conteúdo principal

​
O que é o arquivo de configuração?

O arquivo de configuração é um arquivo que contém os parâmetros da sua aplicação, como o arquivo principal, memória, versão e outros parâmetros. Esse arquivo é usado para configurar e implantar sua aplicação na plataforma Square Cloud.
squarecloud.app

​
Criando o arquivo de configuração

É 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.
1

Selecionar extensão

O arquivo de configuração pode ter duas extensões: .app ou .config. Na prática, pode ser: squarecloud.app ou squarecloud.config e você pode escolher o que preferir. Dica: use .app para ajudar a promover a Square Cloud. 🥰😂
No macOS, recomendamos usar a extensão .config.
Observação: .app ou .config é a extensão do arquivo, não o nome.
2

Criar arquivo

Crie um arquivo com a extensão selecionada e coloque os parâmetros de configuração dentro dele.

​
Parâmetros de configuração

Abaixo você pode ver todos os parâmetros de configuração disponíveis para seu arquivo de configuração.
Parâmetros editáveis (✅) podem ser modificados no painel após deploy. Não editáveis (❌) requerem reenvio completo da aplicação para alterações.

​
Detalhando os parâmetros de configuração

Abaixo você pode ver os parâmetros de configuração que pode usar no seu arquivo de configuração.

MAIN [*]

Tipo: String | Editável: ❌ | Limite: 32 caracteres.Define o arquivo principal da sua aplicação.
Exemplo:
Também suporta diretórios:
Quando este parâmetro é definido, o ambiente de execução é inferido baseado na extensão do arquivo
Esta configuração é IGNORADA se você usar o parâmetro START.

MEMORY [*]

Tipo: Integer | Editável: ✅ | Limite: Mínimo 256MB (bot), 512MB (site).Define a quantidade de memória que sua aplicação usará.
O valor deve ser especificado em megabytes (MB).

VERSION [*]

Tipo: String | Editável: ❌ | Valores: recommended, latest ou versão específica.
Recomendamos usar recommended para melhor estabilidade.
Define a versão da linguagem da sua aplicação.

DISPLAY_NAME [*]

Tipo: String | Editável: ✅ | Limite: 32 caracteres.Define o nome de exibição da sua aplicação.

DESCRIPTION

Tipo: String | Editável: ✅ | Limite: 280 caracteres.Define a descrição da sua aplicação.

AUTORESTART

Tipo: Boolean | Editável: ✅ | Valores: true, false | Padrão: falseDefine se a aplicação deve reiniciar automaticamente em caso de falha.

SUBDOMAIN

Tipo: String | Editável: ✅ | Limite: 63 caracteres. | Padrão: não definido.Define o subdomínio do seu site (apenas para aplicações web).
O URL final será: mysite.squareweb.app

RUNTIME

Tipo: String | Editável: ❌Define o ambiente de execução manualmente.
Veja os valores aceitos abaixo.
Se você definir este parâmetro, não precisa definir o MAIN; em vez disso, defina um comando START personalizado.

START

Tipo: String | Editável: ✅ | Limite: 256 caracteres. | Padrão: não definido.Define um comando personalizado de inicialização.
Este parâmetro substitui o comportamento padrão do MAIN.

​
Exemplos de configuração para bots

Temos alguns exemplos de configurações para bots; abaixo você pode ver alguns exemplos.
Parâmetros obrigatórios.
Exemplo com todos os parâmetros.

​
Exemplos de configuração para sites

Temos alguns exemplos de configurações para sites; abaixo você pode ver alguns exemplos.
O URL do site será: mysite.squareweb.app
Exemplo com todos os parâmetros.
MAIN next.config.js usado apenas para o sistema reconhecer o projeto como um projeto JavaScript ou TypeScript (outro arquivo .ts/.tsx)
Exemplo de site Next.js.