Contact Free trial Login

Application Deployment Versioning

Applications and their configurations deployed to Runtime Fabric are automatically versioned by ARM. This versioning feature enables you to:

  • View the configuration change history of the application.

  • Roll back configurations to an earlier version in case the currently applied configuration has issues or is unstable.

  • View the application status:

    • Running: At least one replica is receiving traffic (Started state).

    • Not running: None of the replicas are receiving traffic.

    • Unknown: The target is disconnected.

  • Make updates to a deployed application’s configuration, including:

    • The application package.

    • Application deployment package version.

    • Deployment target settings, such as runtime version, number of replicas, and whether the application is running in cluster mode.

    • Resource allocations such as number of cores and memory allocation.

    • Ingress and property values.

Access the Application’s Settings Page

  1. Sign into Anypoint Platform and navigate to Runtime Manager (Management Center > Runtime Manager).
    The Applications page is displayed.

  2. In the Applications page, select one of the applications running on Runtime Fabric to open the management panel on the right side.

  3. On the management panel, click the Manage Application button to open the application’s Settings page.
    The Settings page displays information about the application’s status, configuration history, and other useful information about the application.
    Each change to the application’s configuration that is successfully deployed to Runtime Fabric is displayed in the Config changes tab on the applications Settings page. The last 10 configuration deployments are displayed in order of their respective configuration date. Each configuration in the history has a unique hash to identify it.

app versioning
The configuration history displays the last 10 configuration deployments in order of creation date.

The All changes tab displays a history of versions created from the configuration deployment, and the actions (stopped, started) taken on each version.

Apply Configuration Changes

  1. On the Settings page for the application, you can make the following changes to a deployed configuration:

    • Upload a new application package.

    • Make changes to the deployment target and resource allocation.

    • Modify values for Ingress and Properties.

  2. Once your changes are made, click Apply Changes.
    At the top of the Settings page, a status bar appears.

    app versioning applying config

  3. Click View Status to view the status for each replica in the deployment.
    Replica statuses include:

    • Started (green): The replica is receiving traffic.

    • Starting: The process is starting on the replica.

    • Deleting: The deletion of the replica is in progress.

    • Deleted: The replica has been deleted.

    • Stopping: The replica is in the middle of the stopping process.

    • Stopped: The replica has stopped (is not receiving traffic).

    • Failed (red): The desired configuration failed to deploy.
      The last successfully deployed configuration is retained until the new (desired) configuration is successfully deployed.
      New configurations are applied as "rolling updates." For example, a replica is created with the desired configuration, and once that configuration is successfully applied, the replica with the old configuration is deleted, and this process is repeated with each replica in the deployment. This model means there is zero downtime while updates are applied to the application.

      Since updates are applied as rolling updates, there will be different application versions running at the same time until the update is completed, so make sure your applications are able to run multiple versions in parallel.
      app versioning replica status

      Once the configuration is successfully applied and deployed, a message appears at the top of the page.

      app versioning config applied success

      The application status, configuration identifier, date, and other information is updated in the status box. The new configuration is displayed at the top of the Config changes list, along with a Last successful label to indicate that it’s the last configuration successfully deployed.

      If the updates to the configuration fail to deploy, you get an "Desired configuration wasn’t applied" message, and the Configuration status displays an "Update failed" label. The configuration is displayed in the Config changes history without a label.

      app versioning update failed

      In cases of failure, the deployment attempts to roll back to the last successful version of the configuration, but in certain situations, the rollback may not be successful. The status of the configuration displays "Update failed."

If it’s the first deployment of the application the rollback version won’t be defined and in case of a failed deployment, it remains in the failed status.

Roll Back to a Previous Successful Configuration

If you deploy a configuration that has issues, you can roll back to a previous successful version of the configuration.

  1. In the Config changes history, select the version to which to roll back.

  2. Click Deploy.
    The configuration moves to the top of the list in the Config changes history and displays the new deployment date. It retains its original identifying hash.

We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. You can read more and make your cookie choices here. By continuing to use this site you are giving us your consent to do this.