From 305c2bb1af5e69757b6560264061f2750e594c0b Mon Sep 17 00:00:00 2001 From: Andrew Halberstadt Date: Fri, 26 Sep 2025 13:28:19 -0400 Subject: [PATCH] chore: version bump Taskgraph 16.0.0 --- CHANGELOG.md | 26 ++++++++++++++++++++++++++ docs/reference/migrations.rst | 27 +++++++++++++++++++++------ pyproject.toml | 2 +- uv.lock | 4 ++-- 4 files changed, 50 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index df7d7f489..78be761cc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,31 @@ # Change Log +## [16.0.0] - 2025-09-26 + +### Changed + +- BREAKING CHANGE: Must use `-i/--interactive` to pause task execution in `load-task` +- Upgraded docker-image tasks to use image_builder v6.0.0 +- Functions in `util/taskcluster.py` now use the official Taskcluster Python client + +### Added + +- Ability to run any task with a docker-worker payload to `taskgraph load-task` +- Ability to pipe a task definition into `taskgraph load-task` +- Ability to specify a custom image to `taskgraph load-task`, including building them locally +- `load_tasks_for_kind` utility function can now generate any graph stage + +### Fixed + +- `load_tasks_for_kind` utility function now forwards kwargs to `TaskGraphGenerator` +- `taskgraph build-image` now supports images using `$DOCKER_IMAGE_PARENT` +- `taskgraph build-image` now obtains necessary context automatically + +### Removed + +- BREAKING CHANGE: `taskgraph build-image` no longer accepts a `--tag` flag +- BREAKING CHANGE: Functions in `util/taskcluster.py` no longer accept the `use_proxy` argument + ## [15.4.0] - 2025-09-22 ### Added diff --git a/docs/reference/migrations.rst b/docs/reference/migrations.rst index d5bf01e1b..ba31a38bf 100644 --- a/docs/reference/migrations.rst +++ b/docs/reference/migrations.rst @@ -3,20 +3,35 @@ Migration Guide This page can help when migrating Taskgraph across major versions. +15.x -> 16.x +------------ + +* Stop using the ``--tag`` flag with ``taskgraph build-image``. Images must now + be tagged manually via Docker post build. +* Running ``taskgraph load-task`` will no longer pause task execution and + instead immediately execute the task's command after loading. Now you must + use the ``-i/--interactive`` flag to pause execution. +* Utility functions in ``taskgraph.util.taskcluster`` no longer accept the + ``use_proxy`` argument. Instead the presence of ``TASKCLUSTER_PROXY_URL`` in + the environment will be used to determine whether or not to use the + Taskcluster proxy. Remove ``use_proxy`` from all function calls, and then + either set ``TASKCLUSTER_PROXY_URL`` or unset it depending on whether using + the proxy is desired or not. + 14.x -> 15.x ------------ -* `get_primary_dependency` now requires a `primary-dependency-label` to be set - on the task it is passed instead of `primary-kind-dependency`. Update any tasks +* ``get_primary_dependency`` now requires a ``primary-dependency-label`` to be set + on the task it is passed instead of ``primary-kind-dependency``. Update any tasks you were calling this for to set this attribute. (If your only usage of this - is indirectly through `from_deps`, no change is needed: `from-deps` generated - tasks will set this for you.) + is indirectly through ``from_deps``, no change is needed: ``from-deps`` generated + tasks will set this for you). 13.x -> 14.x ------------ -* The `{task_workdir}` string in environment variables no longer gets - interpolated by `run-task`. This is backing out a feature introduced in +* The ``{task_workdir}`` string in environment variables no longer gets + interpolated by ``run-task``. This is backing out a feature introduced in version 13.x, so this release introduces no new backwards incompatibilities with version 12.x or earlier. diff --git a/pyproject.toml b/pyproject.toml index 7bf367453..bf2ddc66c 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,7 +1,7 @@ ### Project [project] name = "taskcluster-taskgraph" -version = "15.4.0" +version = "16.0.0" description = "Build taskcluster taskgraphs" readme = "README.rst" authors = [ diff --git a/uv.lock b/uv.lock index 8db855034..82f8656d2 100644 --- a/uv.lock +++ b/uv.lock @@ -1,5 +1,5 @@ version = 1 -revision = 2 +revision = 3 requires-python = ">=3.8" resolution-markers = [ "python_full_version >= '3.11'", @@ -3002,7 +3002,7 @@ wheels = [ [[package]] name = "taskcluster-taskgraph" -version = "15.4.0" +version = "16.0.0" source = { editable = "." } dependencies = [ { name = "appdirs" },