--- title: "Desplegar desde la CLI" url: https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/deploy-from-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-08-17T12:16:04Z service: Serverless type: general --- # Desplegar AppSail como un runtime gestionado por Catalyst desde la CLI ### Inicializar o agregar un servicio de AppSail Puedes [inicializar un servicio de AppSail](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/initialize-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](https://docs.catalyst.zoho.com/es/cli/v1/cli-command-reference/). También puedes [agregar un servicio de AppSail](https://docs.catalyst.zoho.com/es/cli/v1/add-appsail/) a un directorio de proyecto de Catalyst existente, donde se han inicializado otros recursos. Puedes [desplegar el servicio de AppSail](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/deploy-from-cli/#deploy-an-appsail-service) después de inicializarlo o agregarlo. Catalyst crea un archivo **[`app-config.json](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)`** 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: ```sh catalyst init ``` Puedes agregar un servicio de AppSail en un directorio de proyecto de Catalyst existente ejecutando este comando de CLI: ```sh 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. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_0.webp) 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. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_1.png) La aplicación de ejemplo se descargará en el directorio. Proporciona un nombre para ella cuando se te solicite. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_2.png) Si deseas inicializar tu propia aplicación, ingresa "N", luego presiona **Enter**. 3. Selecciona si este será tu [directorio fuente](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path) 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. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_3.png) 4. Ingresa un nombre para tu aplicación. Puedes nombrar el archivo principal de la compilación de tu aplicación como prefieras. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_4.png) > **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](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path) absoluta para tu aplicación, luego presiona **Enter**. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_5.png) 6. Selecciona un stack y runtime para tu aplicación y presiona **Enter**. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_6.png) 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í](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/). ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_7.png) 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`](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/catalyst-json/) de manera correspondiente. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_8.webp) Este proceso solo creará el archivo de configuración [`app-config.json](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)` 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. ![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_9.webp) ### Desplegar un servicio de AppSail Catalyst te permite desplegar [servicios de AppSail](https://docs.catalyst.zoho.com/es/serverless/help/appsail/introduction/) 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](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/initialize-appsail/) o al [agregarlo en un directorio de proyecto existente](https://docs.catalyst.zoho.com/es/cli/v1/add-appsail/). * **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](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path) especificada. ### 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. ![Desplegar AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/cli-appsail-deploy-proj-init-1.png) 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. ```sh catalyst deploy appsail ``` El proceso de despliegue es el mismo. ![Desplegar AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/cli-appsail-deploy-proj-init-2.webp) ### 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](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/) 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](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/deploy-from-cli/#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](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path) automáticamente. * El archivo [`app-config.json`](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file) 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. 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: ```sh 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. ![Desplegar AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-1.webp) > **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**. ![Desplegar AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-2.webp) 4. Selecciona un stack para tu aplicación y presiona **Enter**. ![Desplegar AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-3.webp) 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í. ![Desplegar Functions](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-4.webp) 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. ![Desplegar Functions](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-5.webp) 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. ![Desplegar Functions](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-6.webp) ### 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 <name>** 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: ```sh --name DemoApp ``` **--build-path <path>** Usa esto para especificar la [ruta de compilación](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path) de tu aplicación. Proporciona un valor de ruta absoluta. Esto es aplicable solo a aplicaciones de runtime gestionado por Catalyst. Ejemplo: ```sh --build-path /users/amelia/catalystapp/demoapp/ ``` **--stack <stack>** 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: ```sh --stack NodeJS 20 ``` **--platform <javase|war>** 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: ```sh --platform javase ``` **--command <command>** Usa esto para especificar el [comando de inicio](https://docs.catalyst.zoho.com/es/serverless/help/appsail/appsail-configurations/#startup-commands) 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: ```sh --command npm start ```