Skip to main content
Version: Next

ScheduledTaskClass

A ScheduledTaskClass is a platform-level template that provides governance and standardization for ScheduledTask resources in OpenChoreo. It follows the Claim/Class pattern where platform teams define Classes to enforce organizational policies, resource limits, and scheduling configurations while application teams create ScheduledTasks (claims) that reference these classes.

API Version​

openchoreo.dev/v1alpha1

Resource Definition​

Metadata​

ScheduledTaskClasses are namespace-scoped resources that must be created within an Organization's namespace.

apiVersion: openchoreo.dev/v1alpha1
kind: ScheduledTaskClass
metadata:
  name: <scheduledtaskclass-name>
  namespace: <org-namespace>  # Organization namespace

Spec Fields​

FieldTypeRequiredDefaultDescription
cronJobTemplateCronJobSpecNo-Kubernetes CronJob specification template for scheduled task workloads

Examples​

Basic ScheduledTaskClass​

apiVersion: openchoreo.dev/v1alpha1
kind: ScheduledTaskClass
metadata:
  name: standard-cronjob
  namespace: default
spec:
  cronJobTemplate:
    schedule: "*/30 * * * *"  # Every 30 minutes
    concurrencyPolicy: Forbid
    successfulJobsHistoryLimit: 3
    failedJobsHistoryLimit: 1
    jobTemplate:
      spec:
        backoffLimit: 3
        template:
          spec:
            restartPolicy: OnFailure
            containers:
              - name: main
                resources:
                  requests:
                    memory: "64Mi"
                    cpu: "50m"
                  limits:
                    memory: "256Mi"
                    cpu: "200m"

Annotations​

ScheduledTaskClasses support the following annotations:

AnnotationDescription
openchoreo.dev/display-nameHuman-readable name for UI display
openchoreo.dev/descriptionDetailed description of the ScheduledTaskClass