Skip to main content
A Square Cloud roda o Deno no runtime Node.js: você adiciona o Deno ao projeto como um pacote npm e inicia a sua aplicação com npx deno.

Antes de começar

  • Deno na sua máquina, pelo instalador oficial do Deno, ou pelo pacote npm (npm install deno).
  • Uma conta na Square Cloud: cadastre-se com seu e-mail ou GitHub.
  • Um plano ativo. Veja os planos e escolha o que combina com o seu projeto.

Configure a Square Cloud

Se você envia sua aplicação pelo dashboard, pode pular esta seção: o dashboard cria o arquivo de configuração squarecloud.app para você.

Referência do arquivo de configuração

O arquivo squarecloud.app diz à Square Cloud como executar a sua aplicação: o arquivo principal, a memória, a versão do runtime, o nome e, para um site, o subdomínio.
Primeiro, adicione o pacote deno às dependencies do seu projeto, para que o comando npx deno esteja disponível na Square Cloud. Não o adicione às devDependencies: elas não são instaladas em produção.
Depois, defina RUNTIME=nodejs e inicie a sua aplicação com o Deno no campo START, com as permissões de que ela precisa. Um arquivo de configuração completo para cada tipo de aplicação:
squarecloud.app
Ajuste as permissões (--allow-net, --allow-env, --allow-read e outras) ao que a sua aplicação usa. Se você usa tasks definidas no deno.json, inicie com START=npx deno task start.

O que a Square Cloud executa

  • O START é executado diretamente. Para mais informações sobre os parâmetros do arquivo de configuração, visite parâmetros de configuração.
  • Se a aplicação não tiver uma pasta node_modules, a Square Cloud executa npm install --no-audit --no-fund antes de iniciá-la, o que também instala o deno e todos os módulos npm listados no package.json. Os pacotes em devDependencies não são instalados, porque o runtime define NODE_ENV=production. Quando a node_modules já existe, a etapa de instalação é pulada.

Porta e host para sites e APIs

O Deno.serve() escuta na porta 8000 por padrão e não lê a variável de ambiente PORT. Passe a porta e o host você mesmo: a Square Cloud define a PORT como 80, e 0.0.0.0 aceita conexões de fora do container.
main.ts
Ler a PORT exige --allow-env, e servir exige --allow-net, como nos exemplos de START acima.

Prepare o projeto

Arquivos necessários

  • squarecloud.app, na raiz do ZIP.
  • O seu arquivo de entrada, por exemplo main.ts.
  • package.json, com o deno em dependencies. Um upload sem ele falha com INVALID_DEPENDENCY.
  • Opcionalmente, um deno.json ou deno.jsonc para tasks, imports e outras configurações do Deno.
O arquivo de configuração (squarecloud.app) deve estar localizado na raiz do arquivo zip. Caso contrário, a Square Cloud não conseguirá encontrá-lo durante o deploy.

O que deixar de fora

  • node_modules: a Square Cloud remove esta pasta do seu upload e instala as dependências do package.json na primeira inicialização.
  • deno_dir ou .cache/deno: o diretório de cache do Deno, que o Deno preenche de novo no servidor.
  • Lockfiles: a CLI e a extensão do VS Code deixam package-lock.json, yarn.lock e pnpm-lock.yaml de fora por padrão. Quando você precisar das versões exatas do seu package-lock.json, inclua-o de volta com !package-lock.json no seu squarecloud.ignore.

Solução de problemas

O Deno bloqueia o acesso à rede e ao ambiente, a menos que você permita. Adicione ao seu comando START a flag citada no erro, como --allow-net ou --allow-env.
A quantidade mínima de RAM necessária para hospedar um bot é 256MB e para um site/API é 512MB. No entanto, dependendo do tamanho e complexidade da sua aplicação, pode ser aconselhável alocar uma quantidade maior de RAM para evitar que a aplicação fique sem memória e trave.
Para outros problemas, veja Solução de problemas.

Faça o deploy

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.
2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.
Enviando aplicação para a Square Cloud
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Via CLI

Para usar esse método, seu projeto precisa de um arquivo de configuração chamado squarecloud.app na raiz. Ele informa à Square Cloud como executar a sua aplicação.

Guia do arquivo de configuração

Saiba como criar o arquivo de configuração squarecloud.app que define o ambiente da sua aplicação.
1

Instale a CLI

Instale a CLI da Square Cloud. Se você já a tem, execute o mesmo comando para atualizá-la:
2

Faça login

Execute o comando abaixo. Ele abre o seu navegador: aprove o login lá e a CLI está pronta. Não há nenhuma chave de API para copiar. Para scripts e CI, veja autenticação da CLI.
3

Envie o seu projeto

Na pasta do seu projeto, execute o comando abaixo. A CLI compacta a pasta atual, deixando de fora o que o squarecloud.ignore lista, e faz o upload:
Para enviar um zip que você mesmo criou, passe-o com --file:
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. Verifique o status e os registros da sua aplicação diretamente pelo terminal:
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Próximos passos

Variáveis de ambiente

Mantenha segredos e configurações fora do código e leia-os em tempo de execução.

Domínio personalizado

Sirva a sua aplicação no seu próprio domínio, a partir do plano Standard.

Solução de problemas

Corrija uma aplicação que não inicia ou um site que não responde.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.