Struct TaskSpec 

pub struct TaskSpec { /* private fields */ }

Desired state for a task.

Use TaskSpec::builder to construct it. Resource constructors validate the completed spec.

Example

use solti_model::{EmbeddedSpec, RestartPolicy, TaskSpec, TaskWorkload};

let workload = TaskWorkload::Embedded(EmbeddedSpec::new("v1").unwrap());
let spec = TaskSpec::builder("daily-cleanup", workload, 5_000u64)
    .restart(RestartPolicy::periodic(60_000))
    .build()
    .unwrap();

assert_eq!(spec.slot().as_str(), "daily-cleanup");
assert_eq!(spec.timeout().as_millis(), 5_000);

Implementations

impl TaskSpec

pub fn slot(&self) -> &Slot

Logical slot name for concurrency control.

pub fn workload(&self) -> &TaskWorkload

Workload desired state.

pub fn timeout(&self) -> Timeout

Per-attempt timeout.

pub fn restart(&self) -> RestartPolicy

Restart policy applied after completion or failure.

pub fn backoff(&self) -> &BackoffPolicy

Backoff configuration between restart attempts.

pub fn admission(&self) -> AdmissionPolicy

Admission policy for handling slot conflicts.

pub fn max_retries(&self) -> Option<NonZeroU32>

Maximum consecutive failure retries.

None means unlimited. Zero is not representable.

pub fn runner_selector(&self) -> Option<&LabelSelector>

Label selector for runner routing, if present.

impl TaskSpec

pub fn builder( slot: impl AsRef<str>, workload: TaskWorkload, timeout: impl Into<u64>, ) -> TaskSpecBuilder

Creates a builder with the required fields.

use solti_model::{TaskSpec, TaskWorkload, SubprocessSpec, SubprocessMode, RestartPolicy};

let spec = TaskSpec::builder(
    "my-slot",
    TaskWorkload::Subprocess(SubprocessSpec::new(
        SubprocessMode::Command {
            command: "echo".into(),
            args: vec!["hello".into()],
        },
        Default::default(),
        None,
        Default::default(),
    )),
    5_000u64,
)
.restart(RestartPolicy::OnFailure)
.build()
.expect("valid spec");

impl TaskSpec

pub fn with_runner_selector(self, sel: LabelSelector) -> Self

Sets a runner selector on an existing spec.

This method does not validate sel. Call Self::validate before using the result outside a validated resource.

Example

use solti_model::{EmbeddedSpec, Labels, LabelSelector, TaskSpec, TaskWorkload};

let mut labels = Labels::new();
labels.insert("zone", "eu");

let workload = TaskWorkload::Embedded(EmbeddedSpec::new("v1").unwrap());
let spec = TaskSpec::builder("build", workload, 1_000u64)
    .build()
    .unwrap()
    .with_runner_selector(LabelSelector::from_labels(labels));

assert!(spec.runner_selector().is_some());

pub fn with_admission(self, admission: AdmissionPolicy) -> Self

Sets the admission policy on an existing spec.

Example

use solti_model::{AdmissionPolicy, EmbeddedSpec, TaskSpec, TaskWorkload};

let workload = TaskWorkload::Embedded(EmbeddedSpec::new("v1").unwrap());
let spec = TaskSpec::builder("agent", workload, 1_000u64)
    .build()
    .unwrap()
    .with_admission(AdmissionPolicy::Replace);

assert_eq!(spec.admission(), AdmissionPolicy::Replace);

impl TaskSpec

pub fn validate(&self) -> ModelResult<()>

Validates the complete spec.

Errors

Returns ModelError::Invalid when the slot, workload, backoff, or runner selector is invalid.

Example

use solti_model::{
    Flag, SubprocessMode, SubprocessSpec, TaskEnv, TaskSpec, TaskWorkload,
};

let spec = TaskSpec::builder(
    "hello",
    TaskWorkload::Subprocess(SubprocessSpec::new(
        SubprocessMode::Command {
            command: "echo".into(),
            args: vec!["hello".into()],
        },
        TaskEnv::default(),
        None,
        Flag::enabled(),
    )),
    1_000u64,
)
.build()
.unwrap();

spec.validate().unwrap();

Trait Implementations

impl Clone for TaskSpec

fn clone(&self) -> TaskSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TaskSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TaskSpec

impl JsonSchema for TaskSpec

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for TaskSpec

fn eq(&self, other: &TaskSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TaskSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TaskSpec