3828373e91
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> |
||
---|---|---|
.. | ||
docker | ||
installbuilder | ||
specs | ||
windows-installer | ||
.gitignore | ||
README.md | ||
build-and-deploy-docker.py | ||
build.py | ||
deploy-microsoft-store.py | ||
deploy.py | ||
github-release-notes.txt | ||
release.py | ||
selftest.py |
README.md
Release Checklist
- Make sure that
CHANGELOG.md
is up-to-date with all entries in the "Unreleased" section. - Invoke the release workflow from the GitHub UI.
- The spawned workflow runs will require manual confirmation on GitHub which you need to approve twice: https://github.com/mitmproxy/mitmproxy/actions
- Once everything has been deployed, update the website.
- Verify that the front-page download links for all platforms are working.
GitHub Releases
- CI will automatically create a GitHub release:
https://github.com/mitmproxy/mitmproxy/releases
PyPi
- CI will automatically push a wheel to GitHub:
https://pypi.python.org/pypi/mitmproxy
Docker
- CI will automatically push images to Docker Hub:
https://hub.docker.com/r/mitmproxy/mitmproxy/tags/
Docs
- CI will automatically update the stable docs and create an archive version:
https://docs.mitmproxy.org/archive/vMAJOR/
Download Server
- CI will automatically push binaries to our download S3 bucket:
https://mitmproxy.org/downloads/
Microsoft Store
- CI will automatically update the Microsoft Store version:
https://apps.microsoft.com/store/detail/mitmproxy/9NWNDLQMNZD7 - There is a review process, binaries may take a day to show up.
Homebrew
- The Homebrew maintainers are typically very fast and detect our new relese within a day.
- If you feel the need, you can run this from a macOS machine:
brew bump-cask-pr mitmproxy
Website
- The website does not need to be updated for patch releases. New versions are automatically picked up once they are on the download server.
- Update version here: https://github.com/mitmproxy/www/blob/main/src/config.toml
- Update docs menu here: https://github.com/mitmproxy/www/blob/main/src/themes/mitmproxy/layouts/partials/header.html
- Run
./build && ./upload-test
. - If everything looks alright at https://www-test.mitmproxy.org, run
./upload-prod
.
Prepare for next release
- Last but not least, bump the major version on main in
https://github.com/mitmproxy/mitmproxy/blob/main/mitmproxy/version.py and add a
.dev
suffix.