Controlling time windows for supd upgrades

Configure supd upgrade windows

Even though supd upgrade is designed to be as seamless as possible and does not interfere with the applications, the upgrade procedure does mean a temporary interrupt in the services provided by the system, such as Volga streams, Strongbox secrets, and API calls. Because of this the site provider may choose to defer the upgrade to a specific time period. This is enabled by the supd upgrade windows feature. Supd upgrade windows are configurable by the site provider and indicate the period of time within which the supd upgrade is allowed.

Note that at least one supd upgrade window must be configured within 7-day interval. The minimal duration of the supd upgrade window is 2 hours.

To configure a supd upgrade window, first create a site-profile. The following site-profile, called sweden, allows the upgrade to be performed between 02:00-05:00 during the weekdays and any time on weekends.

site-profile.yaml

name: sweden
supd-upgrade-windows:
  - days-of-week: Monday, Tuesday, Wednesday, Thursday, Friday
    start-time: 02:00
    timezone: site-local
    duration: 3h
  - days-of-week: Saturday, Sunday
    start-time: 00:00
    timezone: site-local
    duration: 24h

cat site-profile.yaml | supctl create system site-profiles

note

Only one site profile can be assigned to a site. So if a site already has a site profile assigned, then the existing profile may need to be updated.

The next step is to apply the site-profile to the relevant sites:

echo 'site-profile: sweden' | supctl merge system sites stockholm-sergel
echo 'site-profile: sweden' | supctl merge system sites gothenburg-bergakungen

Note that the edge sites that have no supd upgrade windows assigned will be upgraded immediately as soon as the Control Tower is upgraded. Note also that the Control Tower is upgraded immediately after the new upgrade is available. It is not possible to restrict the time window for Control Tower upgrade.