diff --git a/CHANGELOG.md b/CHANGELOG.md index 54f1c0b68..7f2c71e54 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,37 @@ # Change Log +## [7.0.0] - 2023-12-05 + +### Added + +- Ability to use dictionary keys with `` +- Body of responses logged on failure in `taskgraph.util.taskcluster` + +### Changed + +- BREAKING CHANGE: Root directory now considered to be `taskcluster` instead of `taskcluster/ci` +- BREAKING CHANGE: `config.yml` moved from `taskcluster/ci` to `taskcluster` +- BREAKING CHANGE: `taskcluster/ci` renamed to `taskcluster/kinds` +- BREAKING CHANGE: `taskgraph.transforms.jobs` renamed to `taskgraph.transforms.run` +- BREAKING CHANGE: Renamed `taskgraph.target_tasks._target_task` to `register_target_task` +- BREAKING CHANGE: Switched Decision docker image from Ubuntu 22.04 to Debian 12 +- `index-task` docker image upgrade to node v18 + +### Removed + +- BREAKING CHANGE: Dropped support for Python 3.7 +- BREAKING CHANGE: Removed `taskgraph.util.decision.make_decision_task` +- BREAKING CHANGE: Removed the `decision-mobile` docker image +- BREAKING CHANGE: Removed `taskgraph.transforms.release_notifications` shim + +### Fixed + +- BREAKING CHANGE: Stopped hardcoding path to `hg` on MacOS in `run-task` +- Worker caches setup by the `run` transforms now contain the docker image hash if applicable +- `--diff` flag will not fail if only one of the two graph generations failed +- Paths in `taskgraph.util.hash` are normalized for Windows support +- `taskgraph init` template now separates Decision task caches by project + ## [6.3.1] - 2023-09-28 ### Fixed diff --git a/docs/reference/migrations.rst b/docs/reference/migrations.rst index 7bfea6653..754347b58 100644 --- a/docs/reference/migrations.rst +++ b/docs/reference/migrations.rst @@ -7,15 +7,29 @@ This page can help when migrating Taskgraph across major versions. ---------- * Upgrade to Python 3.8 or higher -* Replace references to `taskgraph.transforms.job` with `taskgraph.transforms.run`. -* Rename the `run_job_using` decorator to `run_task_using`. -* Move `config.yml` from `taskcluster/ci` to `taskcluster/`. -* Rename the `taskcluster/ci` directory to `taskcluster/kinds`. +* Ensure ``root_dir`` now points to ``taskcluster`` instead of + ``taskcluster/ci``. Typically this value is not passed in explicitly by + consumers, but updates are likely required if you have custom code that + uses any of the following objects: + * ``taskgraph.config.GraphConfig`` + * ``taskgraph.config.load_graph_config`` + * ``taskgraph.generator.TaskGraphGenerator`` + * ``taskgraph.generator.load_tasks_for_kinds`` + * The ``-r/--root`` flag on the ``taskgraph`` binary +* Rename the ``run_job_using`` decorator to ``run_task_using`` +* Move ``config.yml`` from ``taskcluster/ci`` to ``taskcluster`` +* Rename the ``taskcluster/ci`` directory to ``taskcluster/kinds`` +* Replace references to ``taskgraph.transforms.job`` with ``taskgraph.transforms.run`` +* Replace references to ``taskgraph.transforms.release_notifications`` with ``taskgraph.transforms.notify`` +* Replace references to ``taskgraph.target_tasks._target_task`` with ``taskgraph.target_tasks.register_target_task`` +* Stop using or inline ``taskgraph.util.decision.make_decision_task`` +* Stop using the ``decision-mobile`` docker image +* Ensure MacOS workers that need Mercurial have ``hg`` on their ``PATH`` 5.x -> 6.x ---------- -* Replace all uses of `command-context` with the more generalized `task-context` +* Replace all uses of ``command-context` with the more generalized ``task-context`` 4.x -> 5.x ---------- @@ -25,7 +39,7 @@ 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. +* Remove all uses of the ``disable-seccomp`` key in the ``worker`` section of task definitions. 2.x -> 3.x ---------- diff --git a/src/taskgraph/__init__.py b/src/taskgraph/__init__.py index b9955d07c..1d9db8f65 100644 --- a/src/taskgraph/__init__.py +++ b/src/taskgraph/__init__.py @@ -2,7 +2,7 @@ # License, v. 2.0. If a copy of the MPL was not distributed with this # file, You can obtain one at http://mozilla.org/MPL/2.0/. -__version__ = "6.3.1" +__version__ = "7.0.0" # Maximum number of dependencies a single task can have # https://docs.taskcluster.net/reference/platform/taskcluster-queue/references/api#createTask