Objective

Become familiar with how the SOAJS Dashboard notifies you about catalog recipe updates for SOAJS services & daemons that are deployed in any Environment and learn how to pull and apply these updates in any Environment.

Steps

1. Understand what Catalog Recipe Updates mean and Locate the Update Notifications
2. Apply the Code Update

Step 1

The Dashboard contains a notification system that informs you whenever new catalog recipe updates or upgrades.

Catalog Recipe updates happen after you deploy a service. Upon deploying another environment than Dashboard, a catalog recipe should be provided for Nginx and the custom services that were deployed in any Environment.

These recipes can be modified under Develop → Catalog Recipes in the Dashboard. Whenever you change any of the recipes used to deploy the services in any environment, the dashboard notifies you so can apply these changes of these services.

These notifications appear Under Deploy pillar → Updates & Upgrades.

In Updates & Upgrades you will see notifications about new catalog recipes and which services were affected.

Step 2

Once a catalog recipe has been updated, you can apply it on the deployed services as follow:

1. Go to Deploy pillar → Clouds & Deployments
2. Make sure to pick the right environment
3. Lookup the service you want to update
   1. Open the Service Operations menu
   2. Click Redeploy Service

Redeploy Service

This operation will load the catalog recipe again, if the catalog recipe has changed then the service will be affected then it redeploys the service with the new recipe changes.

The SOAJS deployer inside the custom image will perform a git clone operation that will clone the latest code updates from the specified branch.

Once the code is pulled, the deployer will run an NPM INSTALL command to install the dependencies needed and will start your service.

While the deployer is running, your old service remains operational until the new service is flagged as running by either Docker Swarm or Kubernetes depending on which of the two drivers you have chosen to deploy your SOAJS cloud with.

When the new service becomes ready, then the old one will be terminated; your Custom Service is now updated and is using the catalog recipe.