Ravish Mallya
08/21/2025, 11:58 AMMarvin
08/21/2025, 11:58 AMMarvin
08/21/2025, 12:04 PMjob_variables
key across all worker types. In Prefect 3.x, the supported variables depend on the work pool’s type (process, docker, kubernetes, ecs, etc.) and are defined by that worker’s base job template.
How to get the exhaustive list for your worker type:
- From the CLI (canonical):
- Default schema for a type:
prefect work-pool get-default-base-job-template --type <type>
Example:
prefect work-pool get-default-base-job-template --type kubernetes
You can write it to a file for easier browsing:
prefect work-pool get-default-base-job-template --type kubernetes --file k8s_base_job_template.json
- For an existing pool (shows the exact template in use):
prefect work-pool inspect "<pool-name>"
Helpful docs:
- Customize deployment job variables: Customize job variables
- Workers overview (how templates/variables work): Workers concept
- Building your own worker (explains base job templates): Developing a custom worker
- ECS-specific worker guidance: ECS worker guide
If you tell me which worker type you’re using (e.g., process, docker, kubernetes, ecs), I can run the command and paste the exact schema you can use in job_variables
.