Skip to main content

​
Introdução

Para hospedar sites e APIs na Square Cloud, é fundamental seguir os procedimentos adequados de configuração e atender aos pré-requisitos técnicos necessários. Este guia mostra o processo completo, do arquivo de configuração ao deploy.

​
Pré-requisitos técnicos

  • Conta na Square Cloud: crie sua conta através da página de cadastro, utilizando seu endereço de e-mail para registro.
  • Plano ativo: é necessário possuir um plano ativo para garantir recursos adequados e performance otimizada. Consulte nossos planos disponíveis e escolha o mais adequado às suas necessidades.

​
Configuração do arquivo Square Cloud

Aprenda sobre: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração essencial que será utilizado para configurar sua aplicação na Square Cloud. Ele define nome, descrição, versão, arquivo principal, entre outras configurações fundamentais.

​
Parâmetros essenciais para sites

O seu servidor precisa escutar na porta 80 e no host 0.0.0.0 (todas as interfaces de rede): é ali que a Square Cloud entrega o tráfego do seu subdomínio. Ela define as variáveis de ambiente PORT (80) e HOST (0.0.0.0) para você, então leia a porta da PORT e mantenha 80 como valor padrão:
Muitos frameworks, como o Next.js e o Nuxt, já leem a PORT sozinhos. Sites estáticos não precisam de servidor nem do parâmetro START. Parâmetros principais do arquivo de configuração squarecloud.app:
  • SUBDOMAIN: para hospedagem de sites, defina este parâmetro com o subdomínio desejado. Defina-o no primeiro upload: uma aplicação enviada sem subdomínio não pode ganhar um depois.
  • START: comando de inicialização personalizado (quando necessário).
  • MEMORY: RAM alocada para sua aplicação, em megabytes. Sites e APIs precisam de pelo menos 512. Curioso sobre por que existe um valor mínimo? Veja por que existem mínimos de RAM.
A URL do site será: meu-parametro-subdominio.squareweb.app

​
Exemplos de configuração

Exemplo 1: site estático sem comando de inicialização personalizado
Exemplo 2: site Next.js com comando de inicialização personalizado
Rode npm run build na sua máquina antes e inclua a pasta .next no zip: a Square Cloud não instala as devDependencies, então o build não roda no servidor. Com um comando START, o RUNTIME=nodejs escolhe o runtime Node.js e nenhum arquivo MAIN é necessário. Para os detalhes específicos do framework, veja o guia do Next.js.

​
Domínio personalizado

Para servir o seu site no seu próprio domínio (ex.: meusite.com) em vez de meusite.squareweb.app, você precisa do plano Standard ou superior. Siga como configurar seu próprio domínio na central de ajuda.

​
Suporte para múltiplas tecnologias

A Square Cloud oferece suporte abrangente para diversas tecnologias de desenvolvimento web, proporcionando flexibilidade na escolha da stack tecnológica mais adequada ao seu projeto.

React

Aprenda como hospedar seu site React na Square Cloud.

Next.js

Aprenda como hospedar seu site Next.js na Square Cloud.

NestJs

Aprenda como hospedar sua aplicação NestJs na Square Cloud.

Vite

Aprenda como hospedar seu site Vite na Square Cloud.

Vue

Aprenda como hospedar seu site Vue na Square Cloud.

Express

Aprenda como hospedar sua API Express na Square Cloud.

Flask

Aprenda como hospedar sua aplicação Flask na Square Cloud.

Django

Aprenda como hospedar sua aplicação Django na Square Cloud.

FastAPI

Aprenda como hospedar sua aplicação FastAPI na Square Cloud.

Lavalink

Aprenda como hospedar seu servidor Lavalink e transmitir música de alta qualidade para seu bot do Discord.

​
Próximos passos

A aplicação não inicia

Corrija conflitos de porta, módulos faltando e outras falhas na inicialização.

Variáveis de ambiente

Mantenha chaves de API e connection strings fora do código.

Banco de dados gerenciado

Crie um banco de dados para o seu site ou API.

​
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.