Configuraciones de AppSail

Comandos de inicio

Puedes configurar comandos de inicio para tus servicios de AppSail que especifican el arranque de la aplicación según el stack de programación, el framework, los archivos de la aplicación y el servidor web utilizado. Esencialmente, este es el comando que proporcionarías en tu entorno local para iniciar una aplicación con tu servidor configurado.

Los comandos de inicio se pueden configurar mientras despliegas la aplicación desde la CLI durante el despliegue, o directamente en la consola después de que la aplicación está desplegada en la nube.

El comando de inicio se puede configurar para una aplicación de dos maneras:

• Aplicaciones desplegadas desde la CLI: Configura esto en el archivo app-config.json para la clave command, si inicializas o agregas la aplicación antes de desplegarla. Si haces un despliegue independiente, puedes proporcionar esto como entrada durante el proceso de despliegue. Aún puedes configurar esto directamente en la consola después de desplegarlo.

• Aplicaciones desplegadas en la consola: Configura esto directamente en la consola.

Comandos de inicio para runtimes gestionados por Catalyst

Java:

Las aplicaciones Java típicamente incluyen servidores embebidos en el código de la aplicación, según el framework utilizado. Por ejemplo, las aplicaciones Spring Boot vienen con servidores web incluidos de manera predeterminada. Sin embargo, ciertos frameworks o formatos podrían no incluir servidores de manera predeterminada, y necesitarás configurar un servidor embebido de forma independiente en tu código Java. Algunos servidores web comunes que se utilizan son Eclipse Jetty o Apache Tomcat.

Node.js y Python:

Para aplicaciones Node.js y Python, dependiendo de los frameworks que uses, los servidores de despliegue podrían incluirse como parte del framework. Necesitarás configurar y gestionar los servidores de aplicaciones de manera correspondiente, y proporcionar los comandos de inicio apropiados para tus aplicaciones. Catalyst no proporciona ningún soporte integrado para ningún servidor para estos entornos de programación.

Ciertos frameworks esperan que el puerto de escucha HTTP se especifique en la línea de comandos al iniciar el servidor.

Por ejemplo:

python3 -m http.server ${X_ZOHO_CATALYST_LISTEN_PORT}

Sin embargo, en AppSail, los comandos de inicio se ejecutan directamente sin involucrar ninguna operación de shell. Por lo tanto, cuando sea necesario, debes especificar que el comando de inicio se ejecute como un comando de shell para cualquier completado de shell.

Por ejemplo:

sh -c 'python3 -m http.server ${X_ZOHO_CATALYST_LISTEN_PORT}'

Variables de entorno

Las variables de entorno se declaran fuera del código fuente principal y pueden ser referenciadas cuando sea necesario. Catalyst te permite almacenar y gestionar variables tanto para los entornos de desarrollo como de producción. Declara una única variable y configura valores para ambos entornos. Por ejemplo, si necesitas declarar una variable de token de autenticación que contendrá diferentes valores en ambos entornos, puedes hacerlo.

Puedes configurar variables de entorno para aplicaciones de runtime gestionado por Catalyst y para aplicaciones de runtime personalizado. Estas serán enviadas a la instancia de la plataforma cuando tu servicio se genere, y podrán ser accedidas con código específico del runtime.

AppSail te permite configurar variables de entorno de dos maneras:

• Aplicaciones desplegadas desde la CLI: Configura esto en el archivo app-config.json para la clave env_variables, si inicializas o agregas la aplicación antes de desplegarla. Si haces un despliegue independiente, configura esto en la consola.

• Aplicaciones desplegadas en la consola: Configura esto directamente en la consola.

Usar una variable de entorno

Después de crear una variable de entorno, puedes llamarla en el código de tu aplicación por su nombre de clave de diferentes maneras en diferentes entornos de programación. La sintaxis para cada entorno de programación se muestra a continuación:

• Java:

System.getenv(variable_name)

• Node.js:

process.env.[variable_name]

• Python:

os.getenv(variable_name)

variable_name: El nombre de clave declarado para la variable

Asignación de memoria y disco

Puedes asignar memoria para la ejecución de tu aplicación según su carga y requisitos de rendimiento. Si no configuras específicamente una memoria para tu aplicación, se asignará la memoria predeterminada de 512 MB para su ejecución. También puedes asignar el espacio en disco necesario para tu aplicación según su tamaño. El almacenamiento predeterminado asignado para tu aplicación será de 256 MB también.

Siempre puedes editar y reconfigurar la memoria y el almacenamiento después de analizar los requisitos de tu aplicación según su rendimiento, y optimizarla aún más.

AppSail te permite configurar la memoria de dos maneras:

• Aplicaciones desplegadas desde la CLI: Configura esto en el archivo app-config.json para la clave memory, inicializa o agrega la aplicación antes de desplegarla. Si haces un despliegue independiente, configura esto en la consola.

• Aplicaciones desplegadas en la consola: Configura esto directamente en la consola.

Puertos para ejecuciones de aplicaciones

AppSail escucha a través de puertos HTTP y otorga acceso de red en tu aplicación. Es decir, todas las conexiones entrantes a la aplicación serán escuchadas a través de un puerto específico. Puedes configurar el puerto de escucha en Catalyst haciendo referencia a la clave de variable de entorno X_ZOHO_CATALYST_LISTEN_PORT en el código de tu aplicación y conectarte a Internet. Catalyst verificará el proceso escuchando en este puerto.

Consulta la sección de guía de ayuda para ejemplos de configuración del puerto de escucha de AppSail en el código de tu aplicación.

Dependiendo del framework de tu runtime, podrías necesitar especificar el puerto de escucha HTTP en tu comando de inicio al iniciar el servidor.