Conceptos clave

Antes de alojar una aplicación cliente web en Catalyst, asegúrate de subir los recursos del cliente en el formato correcto.

Formato de archivos fuente

Debes asegurarte de subir los recursos del cliente de tu aplicación web en el formato correcto para alojarla en Catalyst sin errores.

Para alojar una aplicación cliente web en Catalyst, necesitas subir los archivos fuente de la aplicación web en la estructura de directorio de proyecto estándar. Esto se explica en detalle en la página de ayuda de Project Directory Structure.

Aquí tienes un vistazo rápido a la estructura de directorio de proyecto estándar en Catalyst:

• El directorio del proyecto contiene fundamentalmente dos carpetas: functions y client. Debes subir solo el directorio client en Web Client Hosting. El directorio client debe contener todos los archivos cliente frontend de la aplicación, como los archivos JavaScript, HTML y CSS.
  

• El directorio client debe contener dos archivos: un archivo index.html que es la página principal de tu aplicación web, y un archivo client-package.json que contiene la información de configuración de los recursos del cliente. Todos los demás archivos de estilos, scripts o HTML del frontend son opcionales, según los requisitos de tu aplicación web.
  

• Debes proporcionar el nombre de tu aplicación web en el archivo client-package.json. Este será el nombre final de tu aplicación. Una vez que establezcas un nombre y alojes la aplicación, no debes cambiarlo.

• En caso de que renombres el archivo index.html o desees usar un archivo diferente como la página principal de tu aplicación web, debes hacer los cambios necesarios en el archivo client-package.json.

Una vez que hayas seguido todas las directrices mencionadas anteriormente, puedes alojar tu aplicación web desde la consola de Catalyst. Cualquier discrepancia con la estructura de directorio estándar podría resultar en un error al alojar la aplicación.

URL predeterminada de la aplicación web

Puedes obtener la URL predeterminada de tu aplicación desde Web Client Hosting o desde la sección de configuración de Environments en tu consola, después de que se aloje.

La URL predeterminada de la aplicación se genera para el entorno de desarrollo cuando alojas tu aplicación. Después de desplegar tu aplicación a producción, se genera una URL de producción.

Las URLs de desarrollo y producción difieren ligeramente en sus formatos. Ambas URLs contienen:

• Nombre de dominio del proyecto: El nombre de dominio único que se genera para tu proyecto cuando lo alojas en Web Client Hosting. Ejemplo: shipmenttracking-57673975.
• Dominio de la aplicación: El dominio para todas las aplicaciones de Catalyst que alojas, que es ‘catalystserverless.com’.

Sin embargo, la URL de la aplicación de desarrollo también contiene el tipo de entorno, y su valor es development. Por ejemplo, ‘https://shipmenttracking-57673975.development.catalystserverless.com’.

El tipo de entorno no se especifica en la URL de producción. Es decir, la URL de producción será ‘https://shipmenttracking-57673975.catalystserverless.com’.

Como se mencionó en la Introducción, también puedes mapear tu dominio con Catalyst y usar esa URL en su lugar.

Versionado de aplicaciones

El versionado de aplicaciones se puede manejar fácilmente en Catalyst. El archivo de configuración client-package.json contiene la información de versión de tu cliente web.

Se deben seguir las siguientes directrices al proporcionar la información de versión en el archivo client-package.json:

1. Debes especificar el número de versión de la aplicación en formato decimal en el campo version. El version se especifica como ‘1.0.0’ por defecto cuando se crea el archivo JSON.
2. Con cada actualización subsiguiente de tu aplicación web, debes modificar el número de versión en el archivo JSON de forma incremental para indicar la siguiente versión superior.
3. No debes decrementar el número de versión una vez que la aplicación web ha sido alojada. Esto causará errores.
4. No debes mantener el mismo número de versión si has modificado la aplicación web y estás desplegando los cambios al entorno de producción. Debes actualizar la versión de la aplicación web de forma incremental.
5. Si eliminas una versión de tu aplicación web que es inferior a la versión actualmente en producción, no podrás reemplazar esa versión, ya que no puedes desplegar una versión decremental. Sin embargo, si eliminas una versión de tu aplicación web que es superior a la versión actualmente en producción, puedes desplegar otra instancia de tu aplicación web con el mismo número de versión que la versión eliminada.

La información de versión de tu aplicación web se muestra en la sección App Version History en Web Client Hosting.