Pular para o conteúdo principal

​
🚀 Introdução

  • Antes de começar, certifique‑se de que o Python está instalado no seu sistema. Se ainda não o tiver, você pode baixá‑lo no site oficial do Python.
  • 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, Discord 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.

​
▶️ Iniciar a Aplicação

  • Se o campo START não estiver definido no arquivo de configuração, a Square Cloud executará python MAIN para executar o arquivo Python especificado em MAIN. Se o campo START estiver definido no arquivo de configuração, o valor nele será executado diretamente. Para mais informações sobre os parâmetros do arquivo de configuração, visite configuration parameters.
  • A Square Cloud usa pip install para instalar todas as dependências listadas em requirements.txt.

​
🖥️ Preparando seu Projeto Python

​
📁 Arquivos de Configuração Essenciais

Ao preparar seu projeto Python para deploy na Square Cloud, assegure‑se de incluir o arquivo de configuração (squarecloud.app/.config) e os arquivos essenciais da sua aplicação dentro de um arquivo zip.
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.

​
🗑️ Arquivos a Excluir Antes do Upload

  • ffmpeg: Este software já vem pré‑instalado no ambiente da Square Cloud, portanto não é necessário incluí‑lo no seu projeto.
  • .venv: Esta pasta contém o ambiente virtual do seu projeto. a Square Cloud fornece um ambiente isolado, então não é necessário enviar essa pasta.
  • poetry.lock: Como a Square Cloud não oferece suporte ao Poetry atualmente, este arquivo deve ser excluído para evitar problemas de compatibilidade durante o deploy.

​
🤔 Por que Excluir Esses Arquivos?

Excluir ffmpeg, .venv e poetry.lock é importante por vários motivos:
  1. Ambiente limpo: a Square Cloud cria um ambiente novo para seu projeto. Incluir esses arquivos é desnecessário e pode causar conflitos com as configurações do ambiente na nuvem.
  2. Eficiência: Remover esses arquivos reduz o tamanho do upload, tornando o processo mais rápido e enxuto.
  3. Compatibilidade: Excluir poetry.lock evita problemas de compatibilidade, já que a Square Cloud utiliza requirements.txt para instalar dependências.
Antes de enviar, compacte os arquivos do seu projeto em formato .zip, excluindo os arquivos desnecessários mencionados acima. Isso ajudará a garantir que sua aplicação Python esteja pronta para um deploy bem‑sucedido na Square Cloud.

​
📄 Arquivos Obrigatórios

  • main.py (Exemplo de arquivo principal).
  • requirements.txt (Arquivo de dependências).
  • OU [pyproject.toml] (Arquivo de dependências).
  • squarecloud.app (arquivo que contém a configuração da Square Cloud).

​
💡 Solução de Problemas

Este erro ocorre quando o arquivo definido como “main” para sua aplicação no arquivo de configuração não existe, está escrito incorretamente ou o caminho está incorreto. Se o seu arquivo principal estiver dentro de uma pasta, por exemplo, informe pasta/arquivo.py.
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 o erro LACK_OF_RAM.

​
📤 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.
⌘I