Pular para o conteúdo principal

​
🚀 Introdução

  • Antes de começar, certifique‑se de que o Ruby está instalado no seu sistema. Se ainda não o tiver, você pode baixá‑lo no site oficial do Ruby, ou usar gerenciadores de versões como rbenv ou rvm.
  • Em seguida, será necessário criar uma conta na Square Cloud, o que pode ser feito através da página de login. Você pode usar seu e‑mail, GitHub ou ambos para criar a conta.
  • Por fim, é necessário ter um plano pago ativo na sua conta. Você pode ver nossos planos e adquirir um conforme sua necessidade aqui.

​
⚙️ Criando o arquivo de configuração do squarecloud

Saiba mais: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar sua aplicação; ele servirá para definir nome, descrição, versão, arquivo principal, entre outras coisas.

​
📄 Arquivos Obrigatórios

  • main.rb (Exemplo de arquivo principal — seu ponto de entrada Ruby).
  • Gemfile (Arquivo de dependências, caso use Bundler).
  • Gemfile.lock (Gerado pelo Bundler; recomendado incluir para builds reprodutíveis).
  • squarecloud.app (arquivo que contém a configuração da Square Cloud).

​
▶️ Iniciar a Aplicação

  • Se o campo START não estiver definido no arquivo de configuração, a Square Cloud executará ruby MAIN, onde o arquivo especificado em MAIN é o arquivo Ruby (por exemplo main.rb). Se o campo START estiver definido, o valor nele será executado diretamente. Em aplicações que usam Bundler, é comum definir START como bundle exec ruby main.rb ou outro comando de inicialização adequado. Para mais informações sobre os parâmetros do arquivo de configuração, visite configuration parameters.
Para aplicações Ruby que utilizam Bundler, é importante configurar adequadamente as variáveis de ambiente para otimizar o processo de instalação de dependências na Square Cloud. A Square Cloud executa a instalação do bundler usando variáveis de ambiente. Para excluir grupos de gems desnecessários em produção, configure a variável BUNDLE_WITHOUT=development:test. Isso também ajuda a remover deprecations do Bundler 2.x.

​
🖥️ Preparando o Projeto para Upload

Antes de hospedar seu projeto na Square Cloud, verifique se os arquivos do projeto estão corretamente configurados para hospedagem.
O arquivo de configuração (squarecloud.app/.config) deve estar localizado na raiz do arquivo zip. Caso contrário, a Square Cloud não conseguirá encontrá‑lo durante o deploy.

​
📤 Enviando o Projeto para a Square Cloud

Após preparar os arquivos do projeto, você pode enviá‑los para a Square Cloud e hospedar sua aplicação.
  • Envio via Dashboard
  • Envio via CLI
Acesse o Dashboard da Square Cloud e faça o upload dos arquivos do seu projeto.
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.