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
squarecloud.app para você.Referência do arquivo de configuração
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.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.
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:
- Bot ou worker
- Site ou API
--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 executanpm install --no-audit --no-fundantes de iniciá-la, o que também instala odenoe todos os módulos npm listados nopackage.json. Os pacotes emdevDependenciesnão são instalados, porque o runtime defineNODE_ENV=production. Quando anode_modulesjá existe, a etapa de instalação é pulada.
Porta e host para sites e APIs
ODeno.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.
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 odenoemdependencies. Um upload sem ele falha comINVALID_DEPENDENCY.- Opcionalmente, um
deno.jsonoudeno.jsoncpara tasks, imports e outras configurações do Deno.
O que deixar de fora
node_modules: a Square Cloud remove esta pasta do seu upload e instala as dependências dopackage.jsonna primeira inicialização.deno_dirou.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.lockepnpm-lock.yamlde fora por padrão. Quando você precisar das versões exatas do seupackage-lock.json, inclua-o de volta com!package-lock.jsonno seusquarecloud.ignore.
Solução de problemas
PermissionDenied: Requires net or env access
PermissionDenied: Requires net or env access
START a flag citada no erro, como --allow-net ou --allow-env.Memória insuficiente
Memória insuficiente
Faça o deploy
Via dashboard
Acesse a página de upload
Configure seu ambiente
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
Faça o deploy do projeto

Confirme que seu app está no ar
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.
Via CLI
Para usar esse método, seu projeto precisa de um arquivo de configuração chamadosquarecloud.app na raiz. Ele informa à Square Cloud como executar a sua aplicação.
Guia do arquivo de configuração
squarecloud.app que define o ambiente da sua aplicação.Instale a CLI
Faça login
Envie o seu projeto
squarecloud.ignore lista, e faz o upload:--file:Confirme que seu app está no ar
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.

