Migration Guide
Contents
Migration Guide¶
This page can help when migrating Taskgraph across major versions.
3.x -> 4.x¶
Remove all uses of the disable-seccomp key in the worker section of task definitions.
2.x -> 3.x¶
Use a decision image at least as recent as this one.
Rename
config.kind_dependencies_tasks
toconfig.kind_dependencies_tasks.values()
.Rename
vcs.head_ref
tovcs.head_rev
.vcs.head_ref
still exists but points to the actual reference instead of the revision.Rename
vcs.base_ref
tovcs.base_rev
. Same rationale as above.
1.x -> 2.x¶
For all kinds using the
transform loader
, rename the following keys in both thekind.yml
file and any files referenced injobs-from
:jobs -> tasks jobs-from -> tasks-from job-defaults -> task-defaults
Rename
taskgraph.util.schema.WHITELISTED_SCHEMA_IDENTIFIERS
totaskgraph.util.schema.EXCEPTED_SCHEMA_IDENTIFIERS
.Rename any instances of
taskgraph.optimize.Either
totaskgraph.optimize.Any
.Add a
deadline
parameter as the third argument to any custom optimization strategies’should_replace_task()
function. For migration purposes it doesn’t need to be used.Replace
taskgraph.util.taskcluster.status_task
withtaskgraph.util.taskcluster.state_task
.