Skip to content

Upgrade the cluster

Upgrading the cluster#

There are 3 ways to upgrade your cluster.

  • Manually via the CLI
  • Manually via the OCM UI
  • Automated upgrades

We will go through these three scenarios.

You can always use --help for more details like

rosa upgrade cluster --help

Manually via the CLI#

  1. Check if there is an upgrade available by running the following command

    rosa list upgrade -c <cluster-name>
    

    You will get a list that shows the available version and the current version of your cluster. For example:

    $ rosa list upgrade -c <cluster-name>
    VERSION  NOTES
    4.8.5   recommended
    4.8.4
    ...
    

    In our example we see that version 4.8.4 is available and so is 4.8.5.

  2. Upgrade the cluster to the latest version by running

    rosa upgrade cluster -c my-rosa-cluster --version 4.8.5
    
  3. This will schedule the cluster for upgrade within the hour. It will take some time to complete.

  4. You can also schedule the upgrade for a later date/time by using the --schedule-date and --schedule-time flags

Manually via OCM UI#

  1. To perform an upgrade via the UI, log into OCM and select the cluster you want to upgrade.
  2. Click on the “Settings” tab.
  3. You will see if an upgrade is available and if so, click on the “Update” button.

    mp

  4. This will open a window allowing you to select the version to upgrade to.

  5. You can then schedule a time for the upgrade or begin it immediately.

Set up automatic updates#

  1. To set up your cluster to be updated automatically log into OCM and select the cluster you want to upgrade.
  2. Click on the “Update Settings” tab.
  3. Under “Update Strategy” click the “Automatic” radio button.
  4. This will open up options for a day of the week and time that you can set for the update to occur.
  5. Select a “Grace period” for allowing the nodes to gracefully drain before forcing the pod eviction under “Node draining”.
  6. Click Save.