Desplegar AppSail como un runtime personalizado desde la CLI

Inicializar o agregar un servicio de AppSail

Puedes inicializar un servicio de AppSail para una aplicación de runtime personalizado 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.

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:

Catalyst admite dos protocolos para aplicaciones de runtime personalizado 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 docker local. 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 archivado (.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. La ruta fuente o de compilación de la aplicación, el stack y el comando de inicio no necesitan ser configurados para imágenes OCI, ya que ya están definidos en las imágenes. 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. Selecciona la segunda opción.

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

3. Protocolo Docker Image:

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

Protocolo Docker Archive:

Si seleccionas Docker Archive, la 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 de AppSail. Puedes nombrarlo como prefieras.

AppSail ahora está inicializado en tu directorio local, y la imagen de la aplicación ahora está asociada con el servicio de 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 de AppSail a través de un localhost para depurar y probarlo, o desplegarlo en la consola remota directamente.

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.

La imagen OCI de tu aplicación que está asociada con AppSail se despliega, junto con el archivo de configuración de tu 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.

Puedes usar el comando de despliegue independiente con estas opciones para desplegar aplicaciones como imágenes de contenedor: –name <name>, –source <image>, –command <command>, –port <port>. Las dos primeras son obligatorias, mientras que las dos últimas son opcionales y se pueden usar para anular cualquier comando de inicio o puerto ya configurado en la definición de la imagen de contenedor. Las opciones se explican en detalle a continuación.

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.

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:

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

–source <image>

Usa esto para especificar la fuente de la imagen docker a desplegar. Esto es aplicable solo a aplicaciones de imagen de contenedor. Debes comenzar con ‘docker://’ para el protocolo Docker image y ‘docker-archive://’ para el protocolo Docker archive. Consulta aquí para más detalles. Ejemplo:

–port <port>

Usa esto para especificar el puerto para el AppSail. Esto es aplicable solo a aplicaciones de imagen de contenedor. Esto anulará cualquier valor ya configurado en la definición de la imagen de contenedor. Ejemplo: