Controlling time windows for supd upgrades
Configure maintenance 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. Due to this fact the site provider may choose to defer the upgrade to a specific time period. This is enabled by the maintenance windows feature. Maintenance 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 maintenance window must be configured within 7-day interval. The minimal duration of the maintenance window is 2 hours.
To configure a maintenance 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.
name: sweden
maintenance-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
The next step is to apply the site-profile to the relevant sites:
site-profiles:
- sweden
cat site-profile-assignment.yaml | supctl merge system sites stockholm-sergel
cat site-profile-assignment.yaml | supctl merge system sites gothenburg-bergakungen
Multiple site-profiles may be applied to a single site, in which case the resulting maintenance window is a logical disjunction of the maintenance windows defined by different profiles.
Note that the edge sites that have no maintenance 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.