SchedulePolicy


You can use a schedule policy to specify when Portworx should trigger a specific operation. Schedule policies do not contain any actions themselves. Also, they are not namespaced. Storage policies are similar to storage classes where an admin creates a schedule policy, and then the users consume it.

SchedulePolicy schema

This section explains the fields you can use to configure a SchedulePolicy object.

A SchedulePolicy object has the following sections:

  • Interval: For interval operations, how frequently Portworx will trigger the operation
  • Daily: For daily operations, Portworx will trigger the operation at the specified time every day
  • Weekly: For weekly operations, Portworx will trigger the operation at the specified day and time every week
  • Monthly: For monthly operations, Portworx will trigger the operation at the specified day and time every month
Field Description Type Default
apiVersion Specifies which version of the Stork API you’re using to create this object string stork.
libopenstorage.org/
v1alpha1
kind Specifies the type of the CRD as SchedulePolicy string
metadata.
name
Specifies a name for the SchedulePolicy object string
policy.
interval.
intervalMinutes
Specifies the interval, in minutes, after which Portworx triggers the operation number
policy.
interval.
retain
For backup operations, specifies how many backups Portworx will retain number 10
policy.
daily.
time
Specifies the time of the day when Portworx will trigger the operation, in the 12 hour AM/PM format string
policy.
daily.
retain
For backup operations, specifies how many backups Portworx will retain number 30
policy.
daily.
forceFullSnapshotDay
For backup operations, specifies on which day to trigger a full backup. By default, Portworx will perform 6 incremental and 1 full backup. This field allows you to enforce a full backup in the daily policy on a specific day. string Monday
policy.
weekly.
day
Specifies the day of the week when Portworx will trigger the operation. You can use both the abbreviated or the full name of the day of the week string
policy.
weekly.
time
Specifies the time of the day when Portworx will trigger the operation, in the 12 hour AM/PM format string
policy.
weekly.
retain
For backup operations, specifies how many backups Portworx will retain string 7
policy.
monthly.
day
Specifies the day of the month when Portworx will trigger the operation 1 number
policy.
monthly.
time
Specifies the time of the day when Portworx will trigger the operation, in the 12 hour AM/PM format string
policy.
monthly.
retain
For backup operations, specifies how many backups Portworx will retain number 12

SchedulePolicy examples

Interval SchedulePolicy

An interval SchedulePolicy includes the following fields and values:

  • apiVersion: the version of the Stork scheduler (this example uses stork.libopenstorage.org/v1alpha1)
  • kind: as SchedulePolicy
  • metadata.name: the name of the SchedulePolicy object (this example uses testpolicy)
  • policy.interval.intervalInMinutes: the interval, in minutes, after which Portworx triggers the operation (this example triggers the operation every minute)

    apiVersion: stork.libopenstorage.org/v1alpha1
    kind: SchedulePolicy
    metadata:
      name: testpolicy
    policy:
      interval:
        intervalMinutes: 1

Daily SchedulePolicy

A daily SchedulePolicy includes the following fields and values:

  • apiVersion: the version of the Stork scheduler (this example uses stork.libopenstorage.org/v1alpha1)
  • kind: as SchedulePolicy
  • metadata.name: the name of the SchedulePolicy object (this example uses testpolicy)
  • policy.daily.time: the time of the day when Portworx will trigger the operation (this example triggers the operation every day at 10:14 PM)

    apiVersion: stork.libopenstorage.org/v1alpha1
    kind: SchedulePolicy
    metadata:
      name: testpolicy
    policy:
      daily:
        time: "10:14PM"

Weekly SchedulePolicy

A weekly SchedulePolicy includes the following fields and values:

  • apiVersion: the version of the Stork scheduler (this example uses stork.libopenstorage.org/v1alpha1)
  • kind: as SchedulePolicy
  • metadata.name: the name of the SchedulePolicy object (this example uses testpolicy)
  • policy.weekly.day: the day of the week when Portworx will trigger the operation (this example triggers the operation every Thursday)
  • policy.weekly.time: the time of the day when Portworx will trigger the operation (this example triggers the operation at 10:13 PM)

    apiVersion: stork.libopenstorage.org/v1alpha1
    kind: SchedulePolicy
    metadata:
      name: testpolicy
    policy:
      weekly:
        day: "Thursday"
        time: "10:13PM"

Monthly SchedulePolicy

A monthly SchedulePolicy includes the following fields and values:

  • apiVersion: the version of the Stork scheduler (this example uses stork.libopenstorage.org/v1alpha1)
  • kind: as SchedulePolicy
  • metadata.name: the name of the SchedulePolicy object (this example uses testpolicy)
  • policy.monthly.day: the day of the month when Portworx will trigger the operation (this example triggers the operation on the 14th of every month)
  • policy.monthly.time: the time of the day when Portworx will trigger the operation (this example triggers the operation at 8:05 PM)

    apiVersion: stork.libopenstorage.org/v1alpha1
    kind: SchedulePolicy
    metadata:
      name: testpolicy
    policy:
      monthly:
        date: 14
        time: "8:05PM"

  1. The date of the month should be greater than 0 and less than 31. If the specified date is invalid, it will roll over to the next month. For example, if you specify the date as Feb 31, Portworx will trigger the operation either on the 2nd or 3rd March, depending on whether a year is a leap year or not. [return]


Last edited: Tuesday, May 9, 2023