Updating the SOAJS Controller

Owned by Michel El Hajj (Unlicensed)
Last updated: Dec 06, 2017
2 min read



Objective

SOAJS Controller is a ready made service by SOAJS, it is the main gateway to its cloud of micro-services and is deployed in the Dashboard environment from branch master.

When there is a new update for the Controller, the Dashboard will notify you ( click here to see how ) so you can pull it and apply it.

Steps

  1. Locate the update notification
  2. Learn what the update is about
  3. Apply the update



Step 1

The Dashboard contains a notification system that informs you whenever new code updates are published by the SOAJS team for the SOAJS Controller that is deployed in the Dashboard Environment.

These notifications appear in 2 places:

  1. Under Deploy pillar → Continuous Delivery → Ledger tab.
  2. Under Deploy pillar → Clouds & Deployments → notification icon next to each service deployed.

In Clouds & Deployments you only see a notification icon that there is a new update, whereas the Ledger provides you with a link so you can learn more about the update.



Step 2

Before you pull a any Controller Update in the Dashboard Environment, it is crucial you learn what the update is about as it might not be backward compatible or it might depend on an image upgrade.

In this case you need to handle these prerequisites before applying the code update otherwise the service might crash after you apply the update.

You can learn more about how to tackle a SOAJS service update and understand what that update is about by clicking on this link.


SOAJS Controller:


If the Package File depicts that the SOAJS framework version is not backward compatible, then there is a new SOAJS image update and you need to pull this new image BEFORE you pull the updates of this service. You can learn more about how to pull SOAJS image updates/upgrades in this link.

Assuming you pulled the new image updates/upgrades or assuming that there aren't any new image updates, head to the next step and see how to apply the service updates.



Step 3

The SOAJS Controller is a Ready Made Service by SOAJS, you can update it by following the guidelines of Step 3 on this page: How to Update a SOAJS service/daemon code ?