MCCUpgrade resource¶
This section describes the MCCUpgrade
resource used in Mirantis
Container Cloud API to configure a schedule for the Container Cloud upgrade.
The Container Cloud MCCUpgrade
CR contains the following fields:
apiVersion
API version of the object that is
kaas.mirantis.com/v1alpha1
.
kind
Object type that is
MCCUpgrade
.
metadata
The
metadata
object field of theMCCUpgrade
resource contains the following fields:name
The name of
MCCUpgrade
object, must bemcc-upgrade
.
spec
The
spec
object field of theMCCUpgrade
resource contains the schedule when Container Cloud upgrade is allowed or blocked. This field contains the following fields:blockUntil
Time stamp in the ISO 8601 format, for example,
2021-12-31T12:30:00-05:00
. Upgrades will be disabled until this time. You cannot set this field to more than 7 days in the future and more than 30 days after the latest Container Cloud release.
timeZone
Name of a time zone in the IANA Time Zone Database. This time zone will be used for all schedule calculations. For example:
Europe/Samara
,CET
,America/Los_Angeles
.
schedule
List of schedule items that allow an upgrade at specific hours or weekdays. The upgrade process can proceed if at least one of these items allows it. Schedule items allow upgrade when both
hours
andweekdays
conditions are met. When this list is empty or absent, upgrade is allowed at any hour of any day. Every schedule item contains the following fields:hours
Object with 2 fields:
from
andto
. Both must be non-negative integers not greater than 24. Theto
field must be greater than thefrom
one. Upgrade is allowed if the current hour in the time zone specified bytimeZone
is greater or equals tofrom
and is less thanto
. Ifhours
is absent, upgrade is allowed at any hour.
weekdays
Object with boolean fields with these names:
monday
tuesday
wednesday
thursday
friday
saturday
sunday
Upgrade is allowed only on weekdays that have the corresponding field set to
true
. If all fields arefalse
or absent, orweekdays
is empty or absent, upgrade is allowed on all weekdays.
Full
spec
example:spec: blockUntil: 2021-12-31T00:00:00 timeZone: CET schedule: - hours: from: 10 to: 17 weekdays: monday: true tuesday: true - hours: from: 7 to: 10 weekdays: monday: true friday: true
In this example:
Upgrades are blocked until December 31, 2021
All schedule calculations are done in the CET timezone
Upgrades are allowed only:
From 7:00 to 17:00 on Mondays
From 10:00 to 17:00 on Tuesdays
From 7:00 to 10:00 on Fridays
status
The
status
object field of theMCCUpgrade
resource contains information about the next planned Container Cloud upgrade, if available. This field contains the following fields:nextAttempt
Time stamp in the ISO 8601 format indicating the time when the Release Controller will attempt to discover and install a new Container Cloud release. Set to the next allowed time according to the schedule configured in
spec
or one minute in the future if the schedule currently allows upgrade.
message
Message from the last upgrade step or attempt.
nextRelease
Object describing the next release that Container Cloud will be upgraded to. Absent if no new releases have been discovered. Contains the following fields:
version
Semver-compatible version of the next Container Cloud release, for example,
2.22.0
.
date
Time stamp in the ISO 8601 format indicating the time when the Container Cloud release defined in
version
has been first discovered.
lastUpgrade
Time stamps of the latest Container Cloud upgrade:
startedAt
Time stamp in the ISO 8601 format indicating the time when the last Container Cloud upgrade started.
finishedAt
Time stamp in the ISO 8601 format indicating the time when the last Container Cloud upgrade finished.