Pular para o conteúdo principal

​
Introdução

Para desenvolver e hospedar um aplicativo no Square Cloud, é essencial seguir uma sequência estruturada de configurações e pré-requisitos. Este guia técnico abordará todo o processo, desde a configuração inicial até a implantação em produção.

​
Pré-requisitos

  • Conta Square Cloud: Plataforma de hospedagem para seu aplicativo. Cadastre-se através da página de cadastro usando seu e-mail.
  • Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.
Está se perguntando quanta RAM e CPU seu plano precisa para hospedar Aplicações Vite?
Não se preocupe, estamos aqui para ajudar. Nosso plano Standard oferece 4GB de RAM e 4vCPU, o que deve ser suficiente para a maioria dos Aplicações Vite. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui.

​
Criando o projeto

Antes de começar, certifique-se de ter o Node.js e o npm instalados em seu sistema. Se ainda não os tem, você pode baixá-los no site oficial do Node.js. Para criar um novo projeto Vite, execute o seguinte comando: 
npm create vite@latest my-vite-app
No comando acima, my-vite-app é o nome do seu novo projeto. Substitua-o por qualquer nome desejado para seu projeto. Por padrão, este comando configura um projeto Vite com JavaScript.

​
Escolhendo um Template Específico

O Vite permite escolher diferentes templates para o seu projeto. Ao criar um novo projeto, você pode especificar o template desejado usando a opção --template. Aqui estão alguns exemplos: Selecione um template como: react, vue e lit. 
npm create vite@latest my-vite-app --template [template]
Escolha o template que melhor se adapta às suas necessidades e ajuste o nome do projeto conforme necessário.

​
Entendendo a Diferença entre JavaScript e TypeScript

Quando você escolhe JavaScript, o Vite configura o projeto com as configurações padrão de JavaScript. Por outro lado, ao escolher TypeScript, o Vite configura o projeto com as configurações de TypeScript, incluindo a geração de um arquivo tsconfig.json.

​
Compilando o projeto

Antes de fazer o upload para produção, gere os artefatos de produção usando o build do Vite: 
npm run build
Para servir a versão de produção localmente (útil para testar no ambiente de deploy), recomendamos usar o comando vite preview expondo a aplicação em todas as interfaces e na porta 80: 
npx vite preview --host 0.0.0.0 --port 80
Você pode também adicionar um script no package.json para simplificar: 
{
	"scripts": {
		"build": "vite build",
		"preview": "vite preview --host 0.0.0.0 --port 80"
	}
}
Observação: em alguns ambientes a porta 80 exige privilégios especiais. Se houver restrição, use outra porta (ex.: 8080) e mapeie no host/serviço.

​
Escolhendo um servidor de produção

Para produção você tem basicamente duas opções:
  • Com nosso runtime estático HTML/CSS, apenas renomeie index.html para vite.html.
  • Usar o próprio vite preview (útil para testar o comportamento de produção ou em containers que executam o processo Node diretamente).

​
Runtime HTML/CSS

Se optar pelo runtime estático, gere o build (npm run build) e copie o conteúdo de dist/ para o arquivo compactado zip que será enviado para a Square Cloud. Lembre-se de renomear index.html para vite.html para que o runtime reconheça o arquivo inicial corretamente como uma aplicação Vite e faça o tratamento adequado dos assets.

​
Usando vite preview em produção (ou em containers)

vite preview serve os arquivos gerados por vite build com comportamento parecido com um servidor estático de produção. Para expor a aplicação para a rede (por exemplo, dentro de um container na Square Cloud) use: 
npx vite preview --host 0.0.0.0 --port 80
Isso faz o processo escutar em todas as interfaces (0.0.0.0) e na porta 80.

​
Exemplo de vite.config.js com opções de preview

import { defineConfig } from 'vite'

export default defineConfig({
	preview: {
		host: '0.0.0.0',
		port: 80,
		strictPort: true
	}
})

​
Deploying

Após preparar os arquivos do seu projeto, você pode enviá-los para a Square Cloud e hospedar seu projeto. Para fazer isso, crie um arquivo ZIP contendo todos os arquivos do seu projeto.

​
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 no Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no painel.

​
Via CLI

Para usar esse método, você precisa criar um arquivo de configuração chamado squarecloud.app no diretório raiz do seu projeto. Esse arquivo conterá a configuração necessária para o seu projeto.

Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar seu aplicativo; ele será usado para definir seu ambiente.
1

Primeiro Passo

Primeiro, você precisa ter a CLI instalada em seu ambiente. Se você ainda não a possui, execute o seguinte comando em seu terminal:
npm install -g @squarecloud/cli
Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
squarecloud update
2

Segundo Passo

Agora, para autenticar e usar outros comandos da CLI, você encontrará sua chave de autorização aqui clicando em "Solicitar Chave da API". Após obter sua chave de autorização, execute o seguinte comando:
squarecloud auth login
3

Terceiro Passo

Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:
squarecloud upload
Ou se já possui o zip criado:
squarecloud upload --file <caminho/para/zip>

​
Recursos Adicionais

Para mais informações sobre o Vite e suas ferramentas, visite a documentação oficial do Vite. Lá, você encontrará guias detalhados, tutoriais e documentação da API para ajudá-lo a tirar o máximo proveito do Vite.

​
Solução de Problemas

​
Domínio Personalizado

Para usar domínio personalizado (ex: meusite.com) ao invés da URL padrão meusite.squareweb.app, você precisa do plano Standard ou superior. O subdomínio é definido pelo campo SUBDOMAIN no arquivo de configuração. Veja: Como configurar seu domínio personalizado.

​
Requisitos Mínimos de RAM

Mínimo: 512MB de RAM para websites/APIs simples. Para sites com frameworks (Next.JS, React, Vue, Angular, etc.), sugerimos sempre pelo menos 1GB de RAM. Para aplicações maiores, use mais RAM para evitar erro LACK_OF_RAM e garantir performance.

​
Não foi possível encontrar esse site.

Verifique se o subdomínio/domínio corresponde ao configurado no campo SUBDOMAIN ou nas configurações de domínio personalizado. Se você acabou de enviar o site, aguarde até 60 segundos para a Square liberar o primeiro acesso.

​
Site demorou demais para responder...

Verifique se configurou corretamente a porta 80 e host 0.0.0.0 na aplicação. Recomendamos usar as variáveis de ambiente forçadas da Square: PORT e HOST do arquivo .env.

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