Updating Apps Deployed to CloudHub 2.0
When deploying an application to CloudHub 2.0, Runtime Manager automatically versions and creates a new configuration.
Application configurations enable you to:
-
View the configuration change history of the application.
-
Roll back the configurations to an earlier version if the currently applied configuration has issues or is unstable.
-
View the application status.
Possible values are:
- Running
-
At least one replica is receiving traffic (Started state).
- Not running
-
None of the replicas are receiving traffic.
- Unknown
-
The target is disconnected.
When this value appears, there is a MuleSoft-related outage or incident.
-
Make updates to a deployed application’s configuration, including:
-
Application file
-
Application deployment package version
-
Deployment target settings, such as runtime version, number of replicas, and whether the application is running in cluster mode
-
Endpoint and TLS settings
-
Resource allocations, including CPU and memory
-
App property values
-
-
View logs and diagnostics associated with a configuration.
Update App Settings
-
From Anypoint Platform, select Runtime Manager > Applications.
-
Click the app name.
-
In the navigation menu, click Settings.
-
Click Configuration to display the app configuration history:
- Config changes tab
-
Displays the changes to the successfully deployed application configuration and includes the last ten configuration deployments in order by configuration date. A unique hash identifies each configuration in the history.
- All changes tab
-
Displays a history of versions created from the configuration deployment and the actions performed on each version.
-
Depending on the deployment target (shared or private space), change the deployed configuration:
-
Specify runtime options, such as uploading a new application file or changing the deployment target and resource allocation.
-
View the app’s current version.
-
Change the endpoint for the app.
-
Change app behavior with properties.
-
Disable or enable app logs and specify log levels.
-
-
Click Apply Changes.
A message appears at the top of the page indicating the configuration is in progress.
-
Click View status to view the status for each replica in the deployment.
When the configuration is successfully applied and deployed, a message appears at the top of the page, with application status, configuration identifier, date, and replica status. The new configuration appears in the Config changes list.
If the configuration updates fail to deploy, the message indicates that CloudHub 2.0 didn’t apply the configuration, the configuration status is Update failed, and the configuration appears in the Config changes history without a label.
In failure cases, the deployment attempts to roll back to the last successful version of the configuration.
In some situations, the rollback might not succeed, and the configuration status is Update failed.
Replica Statuses
- Started
-
The replica is receiving traffic.
- Pending
-
The replica is waiting to start.
- Starting
-
The replica is starting.
- Deleting
-
The deletion of the replica is in progress.
- Deleted
-
The replica was deleted.
- Stopping
-
The replica is stopping.
- Stopped
-
The replica has stopped (it is not receiving traffic).
- Failed
-
The configuration failed to deploy. Recovering: The replica is attempting to restart after terminating. The last successfully deployed configuration is retained until the new (desired) configuration is successfully deployed.
- Applying
-
The previous configuration of the replica is running, and new configuration settings are in the process of being implemented.
You can configure a desired state that indicates your ideal state of the replica. For example, if you expect the replica to be running, you can set the desired state to running.
Rolling Update vs. Recreate Deployment Model
Depending on the deployment model, CloudHub 2.0 applies new configurations as either:
-
Rolling updates
Maintain availability by incrementally updating replicas.
This model means zero downtime while CloudHub 2.0 applies updates to the application.
Because CloudHub 2.0 applies updates as rolling updates, different application versions run simultaneously until the update completes. For this reason, ensure that your applications can run multiple versions in parallel.
-
Recreate
Terminate replicas before redeployment. Redeployment is quicker and doesn’t require additional resources.
Roll Back to a Previous Successful Configuration
If a deployed configuration has issues, you can roll back to a previous successful version of the configuration.
| If this is the first deployment of the application, the rollback version isn’t defined. In case of a failed deployment, the application remains in the failed status. |
-
From Anypoint Platform, select Runtime Manager > Applications.
-
Click the app name.
-
In the navigation menu, click Settings.
-
Click Configuration to display the app configuration history.
-
Select the version to which to roll back from the Config changes history.
To change the runtime version of a previously used configuration, select the desired version from the Runtime Version dropdown list. You can change any other configuration before deploying.
-
Click Deploy.
The configuration moves to the top of the Config changes history list and displays the new deployment date, and it retains its original identifying hash.