# Runtimes gestionados por Catalyst -------------------------------------------------------------------------------- title: "Conceptos clave" description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: "2026-07-30T07:10:05.820Z" source: "https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/" service: "Serverless" -------------------------------------------------------------------------------- # Runtimes gestionados por Catalyst ## Conceptos clave ### Descripción general Puedes desplegar una aplicación como un runtime gestionado por Catalyst si su stack es uno de los runtimes soportados. Puedes desarrollar este servicio web usando cualquier framework, biblioteca, plugin o dependencia según sea necesario. Como el término sugiere, solo es el runtime lo que es gestionado por Catalyst. Aún necesitarás gestionar las dependencias que tu código incluye. Puedes desplegar directamente los archivos de compilación de tu aplicación, ya sea a través de la CLI o desde la consola. Catalyst gestiona actualmente los siguientes runtimes: * Java: Java 25, Java 21, Java 17, Java 11, Java 8 en los formatos Java SE y Java WAR * Node.js: Node 24, Node 22, Node 20, Node 18, Node 16 * Python: Python 3.13, Python 3.12, Python 3.11, Python 3.10, Python 3.9 Aunque AppSail no incluye muchas configuraciones específicas de Catalyst ni restricciones de formato, hay ciertas definiciones que se empaquetan con tu aplicación que contienen información sobre el alojamiento y la ejecución de la aplicación. Estas se discuten a continuación. <br> ### El archivo app-config.json Cuando inicializas o agregas un servicio de AppSail como un runtime gestionado por Catalyst desde la CLI, Catalyst crea un archivo de configuración app-config.json e incluye la configuración de tu aplicación en él. Este archivo se crea en el directorio en el que inicializas la aplicación, también llamado el [directorio fuente](#source-directory-and-build-path). Nota: El archivo app-config.json no se crea cuando haces un despliegue independiente sin inicializar o agregar la aplicación primero. La configuración que este archivo contiene se obtiene directamente como entrada tuya en la CLI durante el despliegue. Este archivo tampoco se crea para aplicaciones inicializadas como un runtime personalizado. A continuación se muestra un archivo app-config.json de ejemplo creado para una aplicación Java: { "command": "java -jar demo-0.0.1-SNAPSHOT.jar", "buildPath": "/Users/emma-426/CatalystDirectories/DemoApp", "stack": "java8", "env_variables": { "clientid":xxxxxxx, "clientsecret":xxxxxx }, "memory": 256, "platform": "javase" "scripts": { "preserve": "mvn install -DskipTests" "predeploy": "mvn install -DskipTests" } } * command: El comando de inicio para tu aplicación * buildPath: El directorio que contiene los [archivos de compilación](#common-build-files) de tu aplicación * stack: El runtime gestionado por Catalyst de tu aplicación * env_variables: Las variables de entorno para tu aplicación * memory: La memoria asignada para la ejecución de tu aplicación * platform: Define si tu aplicación es del formato javase o javawar, aplicable solo al stack Java * scripts: Los scripts que se pueden ejecutar antes de servir o desplegar tu aplicación a través de preserve y predeploy Los valores para los parámetros stack, buildPath y platform se obtienen obligatoriamente al inicializar o agregar la aplicación. Puedes configurar los otros valores en este archivo antes de desplegar tu aplicación en la nube. También puedes configurar las variables de entorno, la memoria y el comando de inicio directamente en la consola después del despliegue. <br> ### Directorio fuente y ruta de compilación * De manera predeterminada, el directorio fuente de tu aplicación es el directorio desde el cual ejecutas el comando de inicialización o adición de la aplicación. También puedes seleccionar otro directorio además del directorio actual para que sea la fuente durante la inicialización. * Debes agregar los archivos fuente de tu aplicación al directorio fuente. * El archivo [app-config.json](#the-app-configjson-file) se crea en el directorio fuente de tu aplicación. * El directorio de destino es el directorio que contendrá los archivos de compilación de tu servicio web desplegable. * Puedes especificar el directorio de destino de tu aplicación cuando la inicializas o la agregas, o agregarlo para el parámetro build-path en el archivo app-config.json. * Cuando haces un despliegue independiente, el directorio actual será el directorio de compilación. * No necesitas empaquetar o comprimir todos los archivos de compilación juntos, ya que AppSail los empaquetará automáticamente durante el servido o despliegue de la aplicación desde el build-path especificado. * Puedes nombrar el archivo principal de la compilación de tu aplicación como prefieras. Sin embargo, cuando compilas tu aplicación como un archivo Java WAR, necesitarás nombrar el archivo principal root.war. Esto es para asegurar que se eviten configuraciones adicionales de tu parte cuando se genera la URL del endpoint para tu aplicación. Si nombras tu archivo WAR de otra manera, necesitarás agregar algunos controladores necesarios en tu código de manera correspondiente. <br> ### Archivos de compilación comunes Para runtimes gestionados por Catalyst, según el runtime y el framework, tu código compilado o desplegable podría ser de cualquier formato en cualquier estructura. Algunos formatos comunes se mencionan a continuación: * Java: El archivo de compilación final de una aplicación Java WAR es del formato .war. Un archivo WAR es esencialmente un formato desplegable estándar que se puede ejecutar directamente en cualquier servidor de aplicaciones. Es un contenedor para archivos JAR, JavaServer Pages, Java Servlets, clases Java, archivos XML, HTML, CSS, etc. del código fuente de la aplicación. Si tus archivos de compilación son de cualquier otro formato además de un archivo *.war*, puedes seleccionar la plantilla Java SE. Algunos otros formatos incluyen .jar o archivos de clase compilados, .class. Si usas cualquier framework o biblioteca de Java, debes incluir esos archivos en la ruta de compilación. * Node.js: El archivo principal desplegable es típicamente un archivo .js. Según los estándares del framework o las dependencias que agregues, habrá módulos de node y archivos de configuración incluidos en el directorio de tu aplicación. Debes asegurarte de agregar todos los módulos de node y archivos de configuración, junto con el archivo principal y los archivos del cliente nativo en la ruta de compilación. * Python: El archivo principal desplegable es típicamente un archivo .py. Según los estándares del framework, plugins o dependencias que agregues, habrá archivos de Python y de configuración incluidos en el directorio de tu aplicación. Debes asegurarte de agregar todos los módulos y archivos de configuración, junto con el archivo principal y los archivos del cliente nativo en la ruta de compilación. Puedes consultar la guía de ayuda sobre la construcción de aplicaciones de ejemplo para aprender más sobre el uso de frameworks populares en cada stack y desplegarlos como servicios de AppSail. -------------------------------------------------------------------------------- title: "Desplegar desde la CLI" description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: "2026-07-30T07:10:05.821Z" source: "https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/deploy-from-cli/" service: "Serverless" -------------------------------------------------------------------------------- # Desplegar AppSail como un runtime gestionado por Catalyst desde la CLI ### Inicializar o agregar un servicio de AppSail Puedes inicializar un servicio de AppSail para un runtime gestionado por Catalyst directamente en el directorio de tu aplicación, o desde un nuevo directorio usando la CLI de Catalyst. También puedes agregar un servicio de AppSail a un directorio de proyecto de Catalyst existente, donde se han inicializado otros recursos. Puedes [desplegar el servicio de AppSail](#deploy-an-appsail-service) después de inicializarlo o agregarlo. Catalyst crea un archivo app-config.json cuando un servicio de AppSail se inicializa con este método. Para inicializar un servicio de AppSail en un nuevo directorio, crea una carpeta para tu proyecto en tu máquina local y navega a ella desde tu terminal. Inicializa un proyecto ejecutando el siguiente comando desde ese directorio: catalyst init Puedes agregar un servicio de AppSail en un directorio de proyecto de Catalyst existente ejecutando este comando de CLI: catalyst appsail:add Los pasos para inicializar o agregar el servicio de AppSail serán los mismos como se describe a continuación: 1. La CLI te pedirá que selecciones el tipo de runtime como **Catalyst-Managed Runtime** o **Docker Image** cuando AppSail se inicializa o agrega. Selecciona la primera opción. 2. Ahora puedes elegir comenzar con un proyecto de ejemplo listo ingresando "Y" y presionando **Enter**, luego seleccionando una aplicación de ejemplo de la lista. La aplicación de ejemplo se descargará en el directorio. Proporciona un nombre para ella cuando se te solicite. Si deseas inicializar tu propia aplicación, ingresa "N", luego presiona **Enter**. 3. Selecciona si este será tu directorio fuente de tu aplicación ingresando "Y". Si ingresas "N", la CLI te pedirá que escribas la ruta absoluta para el código fuente de tu aplicación en tu directorio. Presiona **Enter** después de las entradas. 4. Ingresa un nombre para tu aplicación. Puedes nombrar el archivo principal de la compilación de tu aplicación como prefieras. Nota: Cuando compilas tu aplicación como un archivo Java WAR, necesitarás nombrar el archivo principal root.war o agregar controladores específicos según tu código. 5. Ingresa la ruta de compilación absoluta para tu aplicación, luego presiona **Enter**. 6. Selecciona un stack y runtime para tu aplicación y presiona **Enter**. Si seleccionas Java, la CLI te pedirá adicionalmente que elijas entre Java SE o Java WAR como el formato desplegable de tu aplicación. Puedes aprender más sobre esto aquí. Si seleccionas cualquier otro stack, esto se omitirá. AppSail ahora está inicializado o agregado en el directorio fuente que seleccionaste, y la aplicación está ahora asociada con el proyecto de Catalyst. Las configuraciones se actualizarán en el archivo catalyst.json de manera correspondiente. Este proceso solo creará el archivo de configuración app-config.json que es específico de AppSail en el directorio fuente de tu aplicación. Puedes editar los valores como el comando de inicio, las variables de entorno o la memoria en este archivo antes de desplegar. <br> ### Desplegar un servicio de AppSail Catalyst te permite desplegar servicios de AppSail de dos maneras diferentes: * Despliegue regular: La ejecución del despliegue regular se aplica cuando ya has inicializado un recurso de AppSail ya sea durante la inicialización del proyecto o al agregarlo en un directorio de proyecto existente. * Despliegue independiente: Puedes hacer un despliegue independiente de una aplicación directamente sin inicializarla como un servicio de AppSail previamente. Catalyst desplegará todos los archivos ejecutables de tu aplicación presentes en la ruta de compilación que especificaste durante la inicialización de la aplicación, en este caso junto con las configuraciones del proyecto. Nota: No necesitas empaquetar o comprimir todos los archivos de compilación juntos, ya que AppSail los empaquetará automáticamente durante el servido o despliegue de la aplicación desde la ruta de compilación especificada. <br> ### Despliegue regular Si la aplicación de AppSail ya está inicializada en el directorio del proyecto, la CLI desplegará automáticamente la aplicación junto con el resto de los recursos del proyecto cuando ejecutes el comando catalyst deploy. La CLI mostrará la URL del endpoint de la aplicación después de que se despliegue, con la que puedes abrirla. <br> Si tienes múltiples aplicaciones de AppSail en el directorio de tu proyecto, puedes acceder a todas sus URLs de endpoint desde la CLI. También puedes ejecutar el siguiente comando para desplegar solo el servicio de AppSail desde el directorio fuente de tu aplicación. catalyst deploy appsail El proceso de despliegue es el mismo. <br> <br> ### Despliegue independiente Debes ejecutar el comando de despliegue independiente desde la raíz del directorio del proyecto de Catalyst. Es decir, catalyst.json y otros archivos de dependencia del proyecto deben estar presentes en el directorio. Nota: Si ejecutas el comando de despliegue independiente sin ninguna de las [opciones específicas para desplegar imágenes de contenedor](#standalone-deploy-appsail-options), la CLI te pedirá entradas relacionadas solo con aplicaciones de runtime gestionado por Catalyst de manera predeterminada. Debes recordar los siguientes puntos sobre el despliegue independiente: * Debes asegurarte de que los archivos de compilación desplegables de tu aplicación estén presentes en el directorio desde el que ejecutas el comando. Esto se debe a que ese directorio se considerará el directorio de compilación automáticamente. * El archivo app-config.json no se crea cuando haces un despliegue independiente para desplegar una aplicación sin inicializarla. La información que este archivo contiene se obtiene como entrada tuya en la CLI durante el despliegue. <br> Puedes hacer el despliegue independiente de una aplicación de AppSail de la siguiente manera: 1. Navega al directorio donde están presentes los archivos desplegables de la aplicación y ejecuta el siguiente comando: catalyst deploy appsail 2. Ingresa un nombre para tu aplicación. Puedes nombrar el archivo principal de la compilación de tu aplicación como prefieras. <br> Nota: Sin embargo, cuando compilas tu aplicación como un archivo Java WAR, necesitarás nombrar el archivo principal root.war o agregar controladores específicos según tu código. 3. Selecciona la ruta de compilación para tu aplicación de la lista y presiona **Enter**. <br> 4. Selecciona un stack para tu aplicación y presiona **Enter**. <br> Si seleccionas Java, la CLI te pedirá adicionalmente que elijas entre Java SE o Java WAR como el formato desplegable de tu aplicación. Puedes aprender más sobre esto aquí. <br> Si seleccionas cualquier otro stack, esto se omitirá. 5. Adicionalmente debes especificar el comando de inicio para tu aplicación según el stack, framework y servidor web utilizado. Esta información se desplegará directamente y estará disponible en la sección Configurations de tu consola después del despliegue de la aplicación. <br> Tu aplicación ahora está directamente desplegada en el proyecto remoto asociado sin requerir que la inicialices como un recurso de AppSail. Ahora puedes acceder a ella con su URL de endpoint mostrada en la CLI. <br> <br> ### Opciones de despliegue independiente de AppSail El comando independiente catalyst deploy appsail admite las siguientes opciones. Algunas de estas son aplicables tanto a aplicaciones de runtime gestionado por Catalyst como a imágenes de contenedor, mientras que algunas son específicas solo para una de ellas. --name &lt;name&gt; Usa esto para especificar el nombre de tu aplicación. Esto es aplicable tanto a aplicaciones de runtime gestionado por Catalyst como a imágenes de contenedor. Ejemplo: --name DemoApp --build-path &lt;path&gt; Usa esto para especificar la ruta de compilación de tu aplicación. Proporciona un valor de ruta absoluta. Esto es aplicable solo a aplicaciones de runtime gestionado por Catalyst. Ejemplo: --build-path /users/amelia/catalystapp/demoapp/ --stack &lt;stack&gt; Usa esto para especificar el stack o runtime de tu aplicación. Solo debes especificar los runtimes que están soportados por Catalyst. Esto es aplicable solo a aplicaciones de runtime gestionado por Catalyst. Ejemplo: --stack NodeJS 20 --platform &lt;javase|war&gt; Usa esto para especificar la plataforma del stack Java únicamente que están soportados en Catalyst: javase o war. Esto es aplicable solo a aplicaciones de runtime gestionado por Catalyst. Ejemplo: --platform javase --command &lt;command&gt; Usa esto para especificar el comando de inicio para tu aplicación. Esto es aplicable tanto a aplicaciones de runtime gestionado por Catalyst como a imágenes de contenedor. Esto anulará cualquier valor ya configurado en la definición de la imagen de contenedor. Ejemplo: --command npm start -------------------------------------------------------------------------------- title: "Desplegar desde la consola" description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: "2026-07-30T07:10:05.821Z" source: "https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/deploy-from-console/" service: "Serverless" -------------------------------------------------------------------------------- # Desplegar AppSail como un runtime gestionado por Catalyst desde la consola AppSail te permite desplegar una aplicación como un runtime gestionado por Catalyst desde la consola remota de Catalyst directamente de la siguiente manera: 1. Navega al servicio **Serverless** en tu proyecto de Catalyst en el que deseas desplegar tu aplicación, luego haz clic en **AppSail** en *Compute*. <br /> Al hacer clic en **Deploy from CLI**, una ventana emergente te mostrará las instrucciones para desplegar un servicio de AppSail desde la CLI. Consulta la sección de ayuda de la CLI para pasos detallados. 2. Haz clic en **Deploy from Console** para desplegar tu aplicación directamente aquí. 3. Selecciona el tipo de despliegue como **Catalyst-Managed Runtime** y proporciona un nombre para tu servicio de AppSail. Selecciona el runtime que usa tu aplicación de una lista de los runtimes soportados por Catalyst. Proporciona un comando de inicio para tu aplicación según el runtime de tu aplicación. Sube un archivo ZIP del directorio de compilación de tu AppSail. Nota: Cuando despliegas la aplicación en la consola directamente, el directorio de compilación no necesita incluir el archivo app-config.json, ya que solo es necesario mientras despliegas desde la CLI. Puedes proporcionar los detalles de configuración aquí. Si el archivo app-config.json está presente, los valores que proporciones aquí anularán los de ese archivo. <br /> 4. Puedes configurar ajustes avanzados para tu aplicación. * Configura un puerto personalizado para la ejecución de tu aplicación, si es necesario. Los puertos dentro del rango de 0 a 1024 están reservados, con la excepción de los puertos 80 y 443. Puedes usar cualquier otro puerto fuera de este rango. El puerto 9000 se usará de manera predeterminada. Nota: Si no has configurado el puerto en tu código, asegúrate de configurar el mismo puerto para escuchar al iniciar el servidor en el comando de inicio de tu aplicación. * Configura la memoria requerida para la ejecución de tu aplicación, según tus requisitos. Puedes seleccionar 128, 256, 512, 1024 o 2048 MB. Información: También puedes configurar el tamaño del disco para la ejecución de tu aplicación después de desplegar la aplicación desde la sección de configuración. * Configura variables de entorno para tu servicio de AppSail según sea necesario. <br /> Puedes agregar múltiples variables de entorno haciendo clic en el ícono **+**, y eliminarlas haciendo clic en el ícono **—**. Información: La variable de entorno se agregará al entorno de Catalyst (desarrollo o producción) en el que estás trabajando actualmente. Puedes cambiar el entorno desde el menú desplegable en la parte superior de la consola y agregar variables según sea necesario. <br /> 5. Después de configurar los detalles, haz clic en **Deploy**. Tu aplicación se desplegará en la consola. Ahora podrás ver y gestionar tu aplicación desde la consola. <br /> Consulta aquí para ayuda sobre la gestión de tu servicio de AppSail.