Task

The task resource is the new form of the lifecycle scripts, that can now be embedded anywhere on a page within the instructions.

Each task resource can have multiple condition blocks that need to be met before the task is completed, which in turn can have multiple of each type of lifecycle block and each of the blocks are executed in sequence in the order they appear in code.

Attributes

Attributes are the properties of a resource that can be used to configure it.

Attribute	Description
Prerequisites prerequisites []Reference	The activities that need to be completed in order to unlock the task.
SuccessMessage success_message string	The message to display when the task is successfully completed.
Config config Config	Configuration for the task. This configuration will be used for all scripts within the task.
Conditions condition required []block Condition	The conditions that have to be met in order for the task to successfully be validated.

Computed Attributes

These attributes are computed when the config is parsed and applied, and are therefor only known at parsetime or runtime.

Attribute	Description
Meta ID meta.id string	The full ID of the resource e.g. `resource.type.name`. This is computed from the full resource path: resource "type" "name" { ... }
Meta Type meta.type string	The type of the resource. This taken from the type label of the resource definition. resource "type" "name" { ... }
Meta Name meta.name string	The name of the resource. This taken from the name label of the resource definition. resource "type" "name" { ... }

Examples

"Full Example"

resource "task" "first_task" {
  config {
    target = resource.container.ubuntu
    
    parallel_exec {
      condition = true
    }
  }

  condition "file_exists" {
    description = "The file exists"

    config {
      target = resource.container.ubuntu
    }

    check {
      script          = "scripts/first_task/file_exists.sh"
      failure_message = "The file could not be found at /tmp/hello"
    }

    solve {
      script  = "scripts/first_task/solve.sh"
    }
  }

  condition "contents_match" {
    description = "The contents of the file contains the word 'world'"

    check {
      script          = "scripts/first_task/contents_match.sh"
      failure_message = "The file does not contain the word 'world'"
    }
  }
}