Implementation

The implementation section acts as a step-by-step procedure guide on hosting, updating, and rolling back a web application from the Catalyst console.

Host a Web Application

As mentioned earlier, the client-package.json file contains all the configuration information of the web app. You must provide the name, description, version, and homepage information of your web app in it. You will not be required to provide this information again while hosting the web app from the console.

To host the client files from the Catalyst console, you must upload them in Web Client Hosting in a zip file format. You can name the zip file whatever you wish.

This will automatically make the files available in your console. Once the client package is deployed, Catalyst will generate the web app URL for your application.

Note: When Catalyst extracts the zip file, the client-package.json file must be present in the root. Therefore, instead of compressing the client folder as a whole, you must navigate inside the client folder, select all the files in it and then compress them together.

Let’s host a web application in the ShipmentTracking project.

To host a web app from the Catalyst console:

  1. Navigate to Web Client Hosting under Host and Manage in the Catalyst Cloud Scale console.
  2. Click Upload to upload the zip file of your web app.
    catalyst_webapp_hosting
  3. Select the zip file to upload from your computer in the pop-up window, then click Upload.
    catalyst_webapp_upload

Your web app will be hosted automatically and displayed in Web Client Hosting.

catalyst_webapp_hosted

When your application is successfully hosted, the default application URL will be automatically generated for it, and displayed here. You will now be able to access the application from this URL.

Update a Web Application

As discussed previously, you must provide your application’s version information in the client-package.json file before you update your application. You must follow all the guidelines of uploading a web application while uploading an updated version of it as well.

All your version upgrades are displayed under App Version History, along with all the necessary details.

To upload an updated version of a web app:

  1. Click the ellipsis icon on the right-hand corner, then click Update.
    catalyst_webapp_update

  2. Select the zip file to upload from your computer in the pop-up window, then click Upload.
    catalyst_webapp_upload

The updated version of your application will be hosted and the details will be displayed in this section.

catalyst_webapp_version_history

You can upload any number of updates of your application as required, but you will not be able to rename the application.

Deploy an Older Version of a Web Application

You can roll back to an older version of your application in the following way:

  1. Select the required older version of the application using the checkbox, under the App Version History section.
    catalyst_webapp_roll_back

  2. Click Confirm in the pop-up window.
    catalyst_webapp_version_change_confirmation

The older version of your application will now be hosted.

catalyst_webapp_version_changed

You can switch to any previously deployed version of the application in the same manner.

Delete a Version of a Web Application

You can delete any version of your application that is not currently hosted in the following way:

  1. Click the delete icon for the version that you want to delete under App Version History.
    catalyst_webapp_version_delete

  2. Click Yes, Proceed in the pop-up window.
    catalyst_webapp_version_delete_confirmation

Download a Web Application

You can download the current version of your web application that is hosted from Web Client Hosting to your local system, in case you require it. This can be done by clicking the ellipsis icon on the right-hand corner, then clicking Download.

catalyst_webapp_download

A zip file of the client package that you had uploaded while hosting the application will be downloaded to your system.

Last Updated 2023-06-07 21:05:57 +0530 +0530