Cómo crear una aplicación Python

El Python Selector ejecuta una aplicación web en Python en su dominio o en una ruta del dominio, como https://sudominio.com/py/. Admite aplicaciones WSGI, la interfaz estándar que usan Flask, Django y otros frameworks similares. Cada aplicación tiene su propio entorno de Python, así que sus paquetes no se mezclan con los de otras aplicaciones.

Una aplicación WSGI arranca desde un archivo de arranque y un punto de entrada: el nombre del objeto WSGI dentro de ese archivo. Ambos deben coincidir con lo que configure en el selector.

Prepare su aplicación

• Liste sus paquetes en un archivo requirements.txt.

• Agregue un archivo de arranque llamado passenger_wsgi.py que exponga la aplicación como application. Para una aplicación Flask definida en app.py:

  from app import app as application
  

  Para Django, apunte al módulo WSGI de su proyecto:

  from miproyecto.wsgi import application
  

Cree la aplicación

Las pantallas de CloudLinux están en inglés, así que los nombres de botones y campos aparecen aquí tal como los verá.

1. En el panel de control de hospedaje web, abra CloudLinux → Python Selector (el ícono de nube en el menú izquierdo).
2. Haga clic en Create Application.
3. Complete el formulario:
   • Python version: la lista inicia en Python 2.7, que ya no tiene soporte. Cámbiela por una versión actual de Python 3 compatible con su aplicación.
   • Application root: la carpeta del código, dentro de su carpeta principal y fuera de la carpeta pública de su sitio, por ejemplo apps/mi-python.
   • Application URL: elija el dominio en la lista (puede mostrar un texto provisional como [object Object] hasta que elija uno) y escriba una ruta en el campo de al lado, por ejemplo py.
   • Application startup file: passenger_wsgi.py.
   • Application Entry point: application.
4. Agregue con Add Variable, en Environment variables, los ajustes que lee su aplicación en lugar de guardarlos en archivos.
5. Haga clic en Create.

Si deja la ruta vacía, la aplicación responde por todo el dominio. Use una ruta como py si quiere conservar su sitio actual.

Suba el código e instale paquetes

1. Suba el proyecto a la raíz de la aplicación con el administrador de archivos o por FTP.
2. En el Python Selector, haga clic en el ícono de lápiz junto a la aplicación para abrirla.
3. En Configuration files, escriba requirements.txt en el campo, haga clic en Add y luego en Run Pip Install.
4. Para Django, ejecute comandos puntuales en Execute python script, con la ruta a manage.py dentro de la raíz de su aplicación, por ejemplo /home/suusuario/apps/mi-python/manage.py migrate, y haga clic en Run Script.
5. Haga clic en Restart y luego en Open junto a la dirección de la aplicación para verificar que responde con HTTPS.

Después de cada cambio de código, suba los archivos y reinicie la aplicación, con Restart dentro de la aplicación o con el ícono de flecha circular en la lista. Si cambia un ajuste del formulario, haga clic en Save.

Detener, iniciar o eliminar

La lista Web Applications muestra el estado (Status) y la versión de Python de cada aplicación, con íconos en Actions para detenerla, reiniciarla, editarla y eliminarla. Los mismos controles están dentro de la aplicación.

• Stop App (ícono cuadrado en la lista) deja la aplicación fuera de línea hasta que la vuelva a iniciar. Sus archivos se conservan.
• Destroy (ícono de papelera en la lista) quita la aplicación del selector. No es lo mismo que detenerla. Descargue primero una copia de su código.

Bueno saber

• El selector ejecuta aplicaciones WSGI. Los frameworks ASGI (FastAPI en modo asíncrono, Django Channels), los WebSockets y los procesos en segundo plano de larga duración requieren un VPS.
• Instale los paquetes en el entorno de la aplicación, no en el Python del sistema.

Si no funciona

• Página de error: revise que el archivo de arranque y el punto de entrada coincidan con su código y reinicie.
• Errores de módulos faltantes: agregue el paquete a requirements.txt, ejecute Run Pip Install de nuevo y reinicie.
• Los cambios no aparecen: reinicie la aplicación después de cada carga.

Si falta el selector o la aplicación sigue sin iniciar, abra un ticket con el dominio, la versión de Python, la dirección que falla, la hora aproximada y el mensaje de error (sin contraseñas ni llaves).