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 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:

Puedes agregar un servicio de AppSail en un directorio de proyecto de Catalyst existente ejecutando este comando de CLI:

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.

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.

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.

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.

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.

El proceso de despliegue es el mismo.

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.

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.

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:

2. Ingresa un nombre para tu aplicación. Puedes nombrar el archivo principal de la compilación de tu aplicación como prefieras.

3. Selecciona la ruta de compilación para tu aplicación de la lista y presiona Enter.

4. Selecciona un stack 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á.

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.

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.

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:

–build-path <path>

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:

–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:

–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:

–command <command>

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: