[Release]: Release checklist for v0.2.0

[Lijiachen1018]

Release Checklist

Release Version: v0.2.0
Release Branch: release
Release Date: 2025/12/12
Release Manager: @qyh111 @Lijiachen1018

Functional Test

Please test the functionality before you publish a release

• Offline inference
• Online inference
• ...

Optional: Doc Test

• User Guide is updated.

Prepare release tag

Make sure

• Create a PR that update package version in setup.py to 0.2.0, for example 👉 release v0.1.2 #491
• Merge develop branch to release branch and main branch, ask 👉 @mag1c-h for help
• Create release tag based on release branch

(On branch release)
# create a tag locally
git tag v0.2.0

# push to remote
git push origin v0.2.0

if anything goes wrong, revert by

# delete a tag locally
git tag -d v0.2.0

# delete from remote
git push origin -d v0.2.0 -f

Prepare Release Content

• Create a release draft and prepare the release note 👉 here, choose the tag you just created

Prepare Artifacts

In this step, you will create two artifacts, one is a source distribution package which will be uploaded to pypi, another is a docker image and which will be pushed to dockerhub.

Create and upload can be easily done with script 👉publish.sh, ask @Lijiachen1018 for credentials.

Put the script in root directory of unified-cache-management, and follow the guide below

# Usage: 
#       
# set environment variables: TAG_NAME, GITHUB_TOKEN, PYPI_API_TOKEN, HTTP_PROXY, HTTPS_PROXY, etc.
# export PYPI_API_TOKEN="your_pypi_token"
# export PYPI_REPO="testpypi or pypi"
# export HTTP_PROXY="http://proxy:port"
# export HTTPS_PROXY="http://proxy:port"
# export DOCKER_USERNAME="your_username, eg. unifiedcachemanagement"
# export DOCKER_PASSWORD="your_password, dockerhub token created in first step"
# export DOCKER_HUB_REPO="your_dockerhub_repo_name, eg. unifiedcachemanagement/ucm"
# export GITHUB_USERNAME="your_github_username"

# Login to dockerhub with your credentials
#       docker login
#
# Finally create a release with the tag name
#       ./publish.sh [TAG_NAME]

Check

• Docker image is ready on dockerhub
• Source distribution package is ready on Pypi

Release Step

• Release note PR is merged.
• Post the release on GitHub release page.
• Check Artifacts
• Broadcast the release news (By message, blog , etc)
• Close this issue