Release tracker - 2024/08

[ScottTodd]

Overview

Our previous stable release was cut on 2024-07-24: https://github.com/iree-org/iree/releases/tag/candidate-20240724.964. We aim for roughly one stable release per month. This issue tracks the release process for the next release.

Release process docs:

• https://iree.dev/developers/general/release-management/
• https://github.com/iree-org/iree/blob/main/RELEASING.md

Release checklist:

• [ ] Watch for major/breaking changes and decide to either batch them with this release or defer them until the next release
• [ ] Choose a release candidate from nightly releases to promote. The candidate should contain no major regressions and should include all packages, even those marked experimental in .github/workflows/build_package.yml like macoS and Windows packages.
• [ ] Compile release notes
• [ ] Promote to stable (on GitHub) and push packages to PyPI
• [ ] Roll forward downstream packages like iree-turbine and push similar package updates to PyPI
• [ ] Update release process docs for next time

Release notes

Commit range (update pin from main to a hash when we decide on a candidate to promote): https://github.com/iree-org/iree/compare/1b60b62ed4b3f2a3c95f42b397889444c7df318c...main.

(Contributors can edit this section as they land patches)

---

Major changes:

• Compiled artifacts (.vmfb files) from before this release are not compatible with the runtime from this release. Ensure your runtime and compiler are both up to date if you get errors loading files. Recent support for reusable/indirect command buffers made the HAL APIs simpler now, though out of tree compiler targets and HAL drivers may need to adapt to:

  • https://github.com/iree-org/iree/commit/5add66feec1ef04f8b63f5591ec386d5ceb49e58 changed the HAL version from 2 to 3.
  • https://github.com/iree-org/iree/commit/8dc68201d674088a019f133d75a9968d89dc7060 changed the HAL version from 3 to 4.
  • https://github.com/iree-org/iree/commit/c77a5f5350a1f167fb4e752c1fb31a82e11f300c changed the HAL version from 4 to 5.

• Several compiler flags were renamed in https://github.com/iree-org/iree/commit/c44d29b2c0e5b121ecd7f0c506a11a58f425d5ab:

  Before	After
  --iree-hal-cuda-llvm-target-arch	--iree-cuda-target
  --iree-hal-cuda-llvm-target-feature	--iree-cuda-target-features
  --iree-rocm-target-chip	--iree-hip-target
  --iree-rocm-target-features	--iree-hip-target-features
  --iree-vulkan-target-triple	--iree-vulkan-target
  --iree-hal-cuda-*	--iree-cuda-*
  --iree-rocm-*	--iree-hip-*

In development features:

• Support for data-tiling on GPU targets is in progress.
• The C++ attention pipeline is continuing to mature. It will replace the transform dialect attention pipeline.

Test coverage:

• There are 81 newly passing ONNX operator tests on CPU.

---