Introducción
Para desarrollar y alojar en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.Requisitos previos
- Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
- Plan de pago activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.
Creando el proyecto
Para crear una aplicación Django, necesitas tener Python y pip instalados en tu sistema antes de seguir los pasos.Instalando la biblioteca
Con Python y pip instalados, puedes crear un nuevo proyecto Django. Primero, instala Django usando pip:Desarrollando el proyecto
Crea un nuevo archivo Python (por ejemplo,app.py) y añade el siguiente código para crear una aplicación Django básica:
app.py
Eligiendo un servidor de producción
El servidor de desarrollo integrado de Django no es adecuado para uso en producción. En su lugar, recomendamos usar un servidor WSGI listo para producción como Gunicorn.Gunicorn
Gunicorn es un servidor HTTP WSGI de Python para UNIX. Utiliza un modelo de workers pre-fork, lo que significa que crea múltiples procesos worker para gestionar las solicitudes.
Esto lo convierte en una excelente opción para ejecutar aplicaciones web de Python en producción.
Desplegando
Después de preparar los archivos de tu proyecto, ya puedes subirlos a Square Cloud y alojar tu proyecto. Para hacerlo, crea un archivo ZIP que contenga todos los archivos de tu proyecto.Si tienes un proyecto Django que necesita aplicar migraciones, asegúrate de aplicarlas antes de desplegar en Square Cloud.
Puedes hacerlo ejecutando el siguiente comando en tu entorno local:
Puedes hacerlo ejecutando el siguiente comando en tu entorno local:
A través del panel
Accede a la página de subida
Accede a la página de subida y sube el archivo zip de tu proyecto.
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.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
A través de la CLI
Para usar este método, necesitas crear un archivo de configuración llamadosquarecloud.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.
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:Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
- Windows
- Linux, macOS y WSL
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:
Recursos adicionales
Para más información sobre Django y sus herramientas, visita la documentación oficial de Django. Allí encontrarás guías detalladas, tutoriales y documentación de la API para ayudarte a aprovechar al máximo Django.Solución de problemas
Dominio personalizado
Para usar un dominio personalizado (por ejemplo,
mysite.com) en lugar de la URL predeterminada mysite.squareweb.app, necesitas el plan Standard o superior. El subdominio se define mediante el campo SUBDOMAIN en el archivo de configuración.Requisitos mínimos de RAM
Mínimo: 512MB de RAM para sitios web/APIs sencillos. Para sitios con frameworks (Next.JS, React, Vue, Angular, etc.), siempre recomendamos al menos 1GB de RAM. Para aplicaciones más grandes, asigna más RAM para evitar que la aplicación se quede sin memoria y falle.
No se pudo encontrar este sitio.
Verifica que el subdominio/dominio coincida con lo configurado en el campo SUBDOMAIN o en la configuración del dominio personalizado. Si acabas de subir el sitio, espera hasta 60 segundos para que Square habilite el primer acceso.
El sitio tardó demasiado en responder…
Verifica que hayas configurado correctamente el puerto 80 y el host 0.0.0.0 en la aplicación. Recomendamos usar las variables de entorno forzadas de Square: PORT y HOST del archivo
.env.

