Home Roles: Suite Mgmt suite_app_upgrade Role Variables Example Playbook

suite_app_upgrade¤

This role will upgrade the subscription channel for an an installed MAS application after validating:

• That the application is installed and in a healthy state
• That the new version of the application can be upgraded to from the existing version
• That the new version of the application is compatible with the running MAS core platform

Role Variables¤

mas_instance_id¤

Set the instance ID for the MAS installation where you wish to upgrade the application.

• Required
• Environment Variable: MAS_INSTANCE_ID
• Default Value: None

mas_app_channel¤

Select the subscription channel you wish to upgrade to. Built-in validation will ensure that the upgrade will only proceed if a supportable upgrade path is chosen.

• Required
• Environment Variable: MAS_APP_CHANNEL
• Default Value: None

mas_upgrade_dryrun¤

When set to true will ensure that the role only preforms upgrade validation checks and does not make any changes to the target installation.

• Optional
• Environment Variable: MAS_UPGRADE_DRYRUN
• Default: False

skip_compatibility_check¤

When set to true will skip compatibility check before the upgrade install. By default, compatibility check will be performed to validate the specific target mas_app_channel is valid or not based on the existing mas and apps version.

• Optional
• Environment Variable: SKIP_COMPATIBILITY_CHECK
• Default: False

Example Playbook¤

- hosts: localhost
  any_errors_fatal: true
  vars:
    mas_instance_id: instance1
    mas_app_id: iot
    mas_app_channel: 8.5.x
  roles:
    - ibm.mas_devops.suite_app_upgrade