wasi-sdk/RELEASING.md

Release Process

To publish a new version of wasi-sdk as a GitHub release:

1. Tag a commit with an annotated tag. Note that this must be an annotated tag, not a lightweight tag, so that version.py can use it for calculating the package version (use git show wasi-sdk-... to show other tag messages). Note that you may need to clear the repository cache to avoid problems with cached artifacts ¹.

   TAG=wasi-sdk-1
   git tag -a $TAG
   git push origin $TAG
   

2. Wait for the CI build of the tag to finish. This will automatically publish a draft pre-release to GitHub Releases. Release notes are auto-generated and should be reviewed for accuracy. Once everything looks good manually publish the release through the GitHub UI.

3. Remember to tag the wasi-libc repository with the new $TAG version.

   git submodule status -- src/wasi-libc  # grab $WASI_LIBC_COMMIT from the output
   cd $WASI_LIBC_REPO_DIR
   git tag $TAG $WASI_LIBC_COMMIT
   git push origin $TAG
   

---

1. Here is an example of how to clear a cache with the GitHub CLI:

   URL=/repos/WebAssembly/wasi-sdk/actions/caches
   gh api $URL -q '.actions_caches[].id' \
      | xargs -I {} gh api --method DELETE $URL/{}
   

   ↩︎