Inicializar AppSail

Introducción

AppSail es una plataforma serverless de Catalyst que puedes usar para desplegar servicios web de cualquier escala en la nube y gestionar sus instancias de plataforma. Puedes inicializar un servicio AppSail de dos formas:

• Como un runtime gestionado por Catalyst: Inicializa y despliega aplicaciones de runtimes específicos de Java, Node.js y Python soportados por Catalyst directamente en la consola remota

• Como una imagen de contenedor: Inicializa y despliega una imagen OCI de tu aplicación de cualquier runtime o framework desde tu registro local a la consola remota

Consulta aquí para más detalles.

En ambos casos, puedes inicializar un servicio AppSail para una aplicación lista para ser desplegada y asociarla con un proyecto de Catalyst mediante este comando.

Inicializar AppSail como un Runtime Gestionado por Catalyst

Puedes inicializar un servicio AppSail para un runtime gestionado por Catalyst directamente en el directorio de tu aplicación, o desde un nuevo directorio. Si seleccionaste AppSail durante la inicialización del proyecto, Catalyst lo configurará después de la inicialización del Client.

Catalyst crea un archivo app-config.json cuando se inicializa un servicio AppSail con este método.

1. El CLI te pedirá que selecciones el tipo de runtime como Catalyst-Managed Runtime o Docker Image cuando se inicialice AppSail. Selecciona la primera opción.

2. Ahora puedes elegir comenzar con un proyecto de ejemplo listo usando 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”, el CLI te pedirá que escribas la ruta absoluta del 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 del build de tu aplicación como prefieras.

5. Ingresa la ruta de build absoluta para tu aplicación, luego presiona Enter.

6. Selecciona un stack y runtime para tu aplicación y presiona Enter.

Si seleccionas Java, el CLI te pedirá además 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 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.

Esta inicialización solo creará el archivo de configuración app-config.json específico de AppSail en el directorio fuente de tu aplicación. Puedes editar los valores como el comando de inicio, variables de entorno o memoria en este archivo antes de desplegar.

Inicializar AppSail como un Runtime Personalizado

Puedes inicializar AppSail para una imagen OCI compatible de tu aplicación desde un nuevo directorio. Catalyst soporta dos protocolos que puedes usar para asociar la imagen de tu aplicación con AppSail. Cada protocolo tiene un esquema distinto para identificación y funcionamiento.

• Protocolo Docker Image: Usa esto para asociar una imagen preconstruida de tu aplicación presente en el registro local de Docker. La imagen debe estar construida y etiquetada para apuntar al registro local. Ejemplo: docker://localhost/expres-hw:latest

• Protocolo Docker Archive: Usa esto para apuntar a un archivo de respaldo (.tar o .tar.gz) de una imagen preconstruida de tu aplicación en el directorio de tu sistema. Ejemplo: docker-archive://test.tar

No necesitas proporcionar ningún otro detalle excepto el nombre del AppSail para imágenes de contenedor. No es necesario configurar la ruta fuente o de build de la aplicación, el stack ni el comando de inicio para imágenes OCI, ya que están definidos en las imágenes.

1. El CLI te pedirá que selecciones el tipo de runtime como Catalyst-Managed Runtime o Docker Image cuando se inicialice AppSail. Selecciona la segunda opción.

2. Selecciona el protocolo como Docker Image o Docker Archive.

3. Protocolo Docker Image:

Si seleccionas Docker Image, el CLI listará todas las imágenes disponibles con etiquetas en el registro local de Docker. Selecciona la imagen que necesitas.

Protocolo Docker Archive:

Si seleccionas Docker Archive, el CLI te pedirá que ingreses la ruta absoluta al archivo TAR de la imagen de tu aplicación en tu sistema local.

4. Proporciona un nombre para el servicio AppSail. Puedes nombrarlo como prefieras.

AppSail ahora está inicializado en tu directorio local, y la imagen de la aplicación está ahora asociada con el servicio AppSail. Las configuraciones se actualizarán en el archivo catalyst.json de manera correspondiente.

Ahora puedes codificar tu lógica de negocio en tu aplicación, luego servir el servicio AppSail a través de un localhost para depurar y probar, o desplegarlo directamente en la consola remota.