Tasks¶
This section focuses on building tasks for Digital Rebar Provision. Tasks are the fundamental unit of work in DRP — each task contains one or more script templates that execute on target machines. Tasks can be injected through flexiflow tasks within pipeline elements as specified in a pipeline.
Getting Started¶
- Task Best Practices — General conventions for task YAML structure, template rendering, idempotency, error handling, logging, and parameter access.
Language-Specific Guides¶
- Bash Task Authoring — The most common task type. Covers
prelude.tmpl, environment variables, error patterns, and drpcli integration. - PowerShell Task Authoring — Windows task authoring with
prelude.ps1.tmpl, registry operations, and service management. - Python Task Authoring — Python tasks using bash wrappers, direct API integration, and vSphere API patterns.
- ESXi Shell Task Authoring — Native ESXi shell tasks using BusyBox
sh, esxcli/localcli commands, and context-based remote execution.
Reference¶
- Task Templates — Specific helper templates available for reuse in tasks.
- Data Rendering — How the two-phase template rendering process works.