Skip to content

RELEASE.md

Latest commit

 

History

History
26 lines (20 loc) · 2.09 KB

RELEASE.md

File metadata and controls

26 lines (20 loc) · 2.09 KB

How to release new versions

Update version metadata files

  1. (Optional: Iff changes to core icechunk rust crate) Update icechunk/Cargo.toml by incrementing the version.
  2. Update icechunk-python/Cargo.toml by incrementing the version.
  3. Update the version of the dependency on the core Rust Icechunk library in icechunk-python/Cargo.toml, ensuring that it is consistent with the latest version of the core icechunk rust crate.
  4. Update the Cargo.lock file, by running cargo check from the top-level icechunk directory.
  5. Document changes in Changelog.md.
  6. Commit all changes and make a PR.
  7. Once CI passes on the PR merge it.

(Optional) Issuing a icechunk rust library release

  1. (Optional: Iff changes to core icechunk rust crate) Go to the publish rust library github action. Click Run workflow, select the branch (main for a normal release, support/v1.x for a V1 support release), and click the green Run workflow button to launch.

Issuing an icechunk python release

  1. Wait until any previous workflow completes.
  2. Go to the Python CI and library release github action.
  3. Check Make a PyPI release.
  4. Uncheck Use git-based version for nightly builds.
  5. Under Branch to build/release (for manual builds only) select the branch you want to release (main for a normal release, support/v1.x for a V1 support release).
  6. Click the green Run workflow button to launch.
  7. After the previous point completes, create a new release in GitHub. Ask it to create the tag, and generate the release notes. Once you hit release, this step will upload the new version to PyPI, and notify the community slack of the new release.
  8. After an hour or so an automated PR should appear to update the conda-forge feedstock. Merge that and the new version will appear on conda-forge.