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

​
📤 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.
Acesse o Dashboard da Square Cloud e faça o upload dos arquivos do seu projeto.
If you continue facing technical difficulties, our specialized support team is available to assist you. Contact us and we'll be happy to help you resolve any issue.