Saltar al contenido principal

​
🚀 Introducción

  • Antes de empezar, asegúrate de que Python esté instalado en tu sistema. Si aún no lo tienes, puedes descargarlo desde el sitio web oficial de Python.
  • A continuación, deberás crear una cuenta en Square Cloud, lo cual puedes hacer a través de la página de inicio de sesión. Puedes usar tu correo electrónico, GitHub o ambos para crear la cuenta.
  • Por último, necesitas tener un plan de pago activo en tu cuenta. Puedes ver nuestros planes y adquirir uno según tus necesidades aquí.

​
⚙️ Configuración del archivo squarecloud.app

Si estás subiendo tu aplicación a través del sitio web de Square Cloud, puedes ignorar esta sección. El sitio crea automáticamente el archivo de configuración squarecloud.app por ti.

Más información: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; servirá para definir el nombre, la descripción, la versión, el archivo principal, entre otras cosas.

​
📄 Archivos requeridos

  • Si el campo START no está definido en el archivo de configuración, Square Cloud ejecutará python MAIN para correr el archivo Python especificado en MAIN. Si el campo START está definido en el archivo de configuración, se ejecutará directamente el valor que contenga. Para más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
  • Square Cloud usa pip install para instalar todas las dependencias listadas en requirements.txt.

​
🖥️ Preparando el proyecto

​
📁 Archivos de configuración esenciales

Al preparar tu proyecto Python para el deploy en Square Cloud, asegúrate de incluir el archivo de configuración (squarecloud.app/.config) y los archivos esenciales de tu aplicación dentro de un archivo zip.
El archivo de configuración (squarecloud.app/.config) debe estar ubicado en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.

​
🗑️ Archivos a excluir antes de subir

  • ffmpeg: Este software viene preinstalado en el entorno de Square Cloud, por lo que no es necesario incluirlo en tu proyecto.
  • .venv: Esta carpeta contiene el entorno virtual de tu proyecto. Square Cloud proporciona un entorno aislado, por lo que no es necesario subir esta carpeta.
  • poetry.lock: Dado que Square Cloud actualmente no es compatible con Poetry, este archivo debe excluirse para evitar problemas de compatibilidad durante el deploy.

​
🤔 ¿Por qué excluir estos archivos?

Excluir ffmpeg, .venv y poetry.lock es importante por varias razones:
  1. Entorno limpio: Square Cloud crea un nuevo entorno para tu proyecto. Incluir estos archivos es innecesario y puede causar conflictos con las configuraciones del entorno en la nube.
  2. Eficiencia: Eliminar estos archivos reduce el tamaño de la subida, haciendo el proceso más rápido y ligero.
  3. Compatibilidad: Excluir poetry.lock evita problemas de compatibilidad, ya que Square Cloud usa requirements.txt para instalar las dependencias.
Antes de subir, comprime los archivos de tu proyecto en formato .zip, excluyendo los archivos innecesarios mencionados anteriormente. Esto ayudará a asegurar que tu aplicación Python esté lista para un deploy exitoso en Square Cloud.

​
📄 Archivos requeridos

  • main.py (Ejemplo de archivo principal).
  • requirements.txt (Archivo de dependencias).
  • O [pyproject.toml] (Archivo de dependencias).
  • squarecloud.app (archivo que contiene la configuración de Square Cloud).

​
💡 Solución de problemas

Este error ocurre cuando el archivo definido como “main” para tu aplicación en el archivo de configuración no existe, está escrito incorrectamente o la ruta es incorrecta. Si tu archivo principal está dentro de una carpeta, por ejemplo, especifica folder/file.py.
La cantidad mínima de RAM requerida para alojar un bot es de 256MB y para un sitio/API es de 512MB. Sin embargo, dependiendo del tamaño y la complejidad de tu aplicación, puede ser recomendable asignar una mayor cantidad de RAM para evitar que tu aplicación se quede sin memoria y se caiga.

​
📤 Cómo alojar tu proyecto

Ahora que has preparado todos los archivos para tu proyecto Python, el siguiente paso es subirlos a Square Cloud y poner tu aplicación en línea. Hay varias formas de subir, pero cubriremos dos: a través del Dashboard o a través de la CLI.

​
A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.
2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.
Subiendo aplicación a Square Cloud

​
A través de la CLI

Para usar este método, necesitas crear un archivo de configuración llamado squarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.
1

Instala la CLI

Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:
npm install -g @squarecloud/cli
Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
squarecloud update
2

Autentícate

Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:
squarecloud auth login
3

Sube tu proyecto

Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:
squarecloud upload
O si creaste el zip manualmente, puedes usar:
squarecloud upload --file <path/to/zip>

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema.