Cómo configurar y ejecutar una aplicación Python en tu hosting cPanel con Imagina Colombia

21.01.2025

Cómo configurar y ejecutar una aplicación Python en tu hosting cPanel con Imagina Colombia

 

Paso 1: Accede a la sección de configuración de aplicaciones Python

Una vez hayas iniciado sesión en tu cuenta de cPanel, desplázate hacia abajo hasta encontrar la sección "Software". Allí, haz clic en la opción "Setup Python App". Esta herramienta te permitirá configurar y gestionar tus aplicaciones basadas en Python dentro de tu hosting proporcionado por Imagina Colombia.

Paso 2: Crear una nueva aplicación Python

En la interfaz de configuración de Python, verás una sección titulada "Web Applications". Para comenzar con la configuración de tu aplicación, haz clic en el botón azul "Create Application". Esto abrirá un formulario donde podrás especificar detalles importantes, como la versión de Python, la ubicación de tu aplicación y otros parámetros necesarios.

Paso 3: Configurar los detalles de la aplicación Python

Uploaded image

Al hacer clic en "Create Application", serás dirigido a un formulario donde deberás completar la configuración básica de tu aplicación. A continuación, se explican los campos que debes rellenar:

  1. Python Version:
    Selecciona la versión de Python que deseas utilizar para tu aplicación. En este caso, se ha seleccionado 3.11.10. Asegúrate de elegir la versión compatible con tu código.

  2. Application Root:
    Especifica el directorio donde se almacenarán los archivos de tu aplicación en el servidor. En este ejemplo, se ha configurado como testapp. Este será el nombre del directorio dentro de tu hosting.

  3. Application URL:
    Aquí se configura la URL desde la cual tu aplicación será accesible. Puedes especificar el subdirectorio que desees utilizar para que los usuarios accedan a la aplicación (en este caso, /testapp).

  4. Application Startup File:
    Este campo se utiliza para indicar el nombre del archivo principal que ejecutará tu aplicación. Por ejemplo, si tu archivo principal es app.py, deberás escribir app (sin la extensión .py).

  5. Application Entry Point:
    Define el punto de entrada WSGI de tu aplicación. Este campo se utiliza para indicar la función que iniciará tu aplicación. Por ejemplo, si tienes una aplicación Flask, el valor podría ser app

 

Nota: Valores predeterminados para los campos "Startup File" y "Entry Point"

Si decides dejar en blanco los campos Application Startup File y Application Entry Point, el sistema configurará automáticamente los valores predeterminados:

  1. Application Startup File:
    El sistema asignará el archivo passenger_wsgi.py como el archivo de inicio predeterminado. Este archivo es un estándar para aplicaciones Python en entornos de hosting con cPanel.

  2. Application Entry Point:
    El valor predeterminado será application, lo que significa que el servidor buscará una variable llamada application dentro del archivo passenger_wsgi.py para inicializar la aplicación.

Paso 4: Estructura de carpetas y archivo predeterminado

Cuando configures tu aplicación Python en cPanel y completes los pasos anteriores, se creará automáticamente una carpeta en el directorio especificado en Application Root. Esta carpeta contendrá algunos archivos y directorios iniciales que el sistema genera por defecto:

  1. Estructura inicial de carpetas:

    • passenger_wsgi.py: Archivo principal que actúa como el punto de entrada de la aplicación.
    • stderr.log: Archivo de registro de errores estándar, donde se almacenarán los mensajes de error generados por la aplicación.
    • public: Carpeta que puede usarse para contenido público o estático.
    • tmp: Carpeta temporal para datos generados por la aplicación.
  2. Contenido del archivo passenger_wsgi.py: Este archivo incluye un código básico que verifica si la aplicación está funcionando correctamente. Su contenido inicial es el siguiente:

    python

    import os import sys sys.path.insert(0, os.path.dirname(__file__)) def application(environ, start_response): start_response('200 OK', [('Content-Type', 'text/plain')]) message = "It works!\n" version = "Python %s\n" % sys.version.split()[0] response = '\n'.join([message, version]) return [response.encode()]

    Descripción del código:

    • sys.path.insert(0, os.path.dirname(__file__)): Añade el directorio raíz de la aplicación al sistema de rutas de Python para que se puedan importar módulos locales.
    • application: Esta función define el punto de entrada WSGI. Devuelve un mensaje básico que incluye "It works!" junto con la versión de Python que está utilizando el servidor.
  3. Directorio raíz de la aplicación: En este ejemplo, la aplicación se encuentra en:

    /home/imagina/testapp

    Puedes acceder a este directorio a través de SSH o el administrador de archivos en cPanel para modificar los archivos según los requerimientos de tu aplicación.

 

Próximos pasos:

  • Si necesitas personalizar tu aplicación, puedes editar el archivo passenger_wsgi.py o agregar nuevos archivos y dependencias.
¡Hablemos!