controller

type InstancePair ¶

type InstancePair struct {
	Ref  *redroidv1alpha1.InstanceRef
	Inst *redroidv1alpha1.RedroidInstance
}

InstancePair holds a reference to both the InstanceRef and the resolved RedroidInstance.

type RedroidInstanceReconciler ¶

type RedroidInstanceReconciler struct {
	client.Client
	Scheme   *runtime.Scheme
	Recorder record.EventRecorder
}

RedroidInstanceReconciler reconciles a RedroidInstance object. It ensures a Pod exists and is running when the instance should be running, and deletes the Pod when it should be stopped.

Phase decision (highest priority first):

1. status.woken non-nil and not expired → Running (on-demand wake, overrides spec.suspend)
2. spec.suspend == true → Stopped (permanent user intent)
3. status.suspended non-nil, not expired → Stopped (programmatic / maintenance override)
4. default → Running

Temporary overrides (status.suspended, status.woken) live in status so GitOps tools like Flux do not reconcile them back, avoiding config drift.

+kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidinstances,verbs=get;list;watch;create;update;patch;delete +kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidinstances/status,verbs=get;update;patch +kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidinstances/finalizers,verbs=update +kubebuilder:rbac:groups="",resources=pods,verbs=get;list;watch;create;update;patch;delete +kubebuilder:rbac:groups="",resources=pods/portforward,verbs=create +kubebuilder:rbac:groups="",resources=pods/log,verbs=get +kubebuilder:rbac:groups="",resources=services,verbs=get;list;watch;create;update;patch;delete +kubebuilder:rbac:groups="",resources=events,verbs=create;patch

func (r *RedroidInstanceReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)

func (r *RedroidInstanceReconciler) SetupWithManager(mgr ctrl.Manager) error

type RedroidTaskReconciler ¶

type RedroidTaskReconciler struct {
	client.Client
	Scheme   *runtime.Scheme
	Recorder record.EventRecorder
}

RedroidTaskReconciler reconciles a RedroidTask object.

For one-shot tasks (spec.schedule == ""), it creates one Job per InstanceRef. For scheduled tasks (spec.schedule != ""), it creates one CronJob per InstanceRef. All child resources are owned by the task and garbage-collected on deletion.

+kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidtasks,verbs=get;list;watch;create;update;patch;delete +kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidtasks/status,verbs=get;update;patch +kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidtasks/finalizers,verbs=update +kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidinstances,verbs=get;list;watch +kubebuilder:rbac:groups=redroid.isning.moe,resources=redroidinstances/status,verbs=get;update;patch +kubebuilder:rbac:groups=batch,resources=jobs;cronjobs,verbs=get;list;watch;create;update;patch;delete +kubebuilder:rbac:groups="",resources=configmaps,verbs=get;list;watch +kubebuilder:rbac:groups="",resources=events,verbs=create;patch

func (r *RedroidTaskReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)

func (r *RedroidTaskReconciler) SetupWithManager(mgr ctrl.Manager) error