Repository navigation
Closed
Description
Part of ongoing maintenance of key libraries and services ipshipyard/roadmaps#1
Meta
- Release owner: @lidel
- Release reviewer: @gammazero
- Expected RC1 date: Tue 17th or Fri 20th
- Expected RC2 date: Wed 22nd
- Expected RC3 date: Thu 23rc
- 🚢 Expected final release date: Wed 22nd or 29th
- Release PR: Release 0.33.0 #10636
- Accompanying PR for improving the release process: docs: RELEASE_CHECKLIST.md update for 0.33 #10674
- Internal Staging tests by Shipyard: Kubo 0.32.1 vs 0.33.x @ Notion
- Changelog: https://github.com/ipfs/kubo/blob/master/docs/changelogs/v0.33.md
Items In Scope
Required
- feat(libp2p): shared TCP listeners and AutoTLS.AutoWSS #10565
- for RC1, have this in go-libp2p@main: fix(sampledconn): Correctly handle slow bytes and closed conns libp2p/go-libp2p#3080
- fix: increase provider sample size #10589
- chore: update to boxo without goprocess #10567
- Update to boxo with refactored providerQueryManager. #10595
- fix: go-libp2p v0.37.2 #10603
- docs(changelog/v0.33): bitswap reprovide changes #10604
- chore: p2p-forge/client v0.1.0 #10605
- refactor(rcmgr): use default libp2p rcmgr metrics #9947
- fix: ipfs-webui v4.4.1 #10608
- refactor(cmds): do not return errors embedded in result type #10527
- chore: boxo v0.25.0 #10619
- Upgrade to Boxo v0.26.0 #10631
- new go-libp2p release with fixes
- go-libp2p-kad-dht with accelerated client fix
- datastore perf fixes / saner defaults
- fix: ipfs-webui v4.4.2 #10635 with fix from fix: ipld-explorer-components@8.1.3 ipfs-webui#2310
- [skip changelog] pinmfs: mitigate slow mfs writes when it triggers #10623
Found during RC1:
- TCP connection multiplexing (tcpreuse package) doesn't work with pnet libp2p/go-libp2p#3119
- added explicit check to daemon.go, no need to bump go-libp2p
- goroutine leak on kubo staging 02 and potential side effects
- gc not engaging on kubo staging 02 (tbd if same or separate issue)
- fix(dns): update default DNSLink resolvers #10655
- https://github.com/libp2p/go-libp2p-kad-dht/releases/tag/v0.28.2
- quicreuse: make it possible to use an application-constructed quic.Transport libp2p/go-libp2p#3122 (fine to just bump quic-go, and not go-libp2p)
- chore: p2p-forge v0.2.2 + go-libp2p-kad-dht v0.28.2 #10663
- do not send cancel message to peer that sent block boxo#784
- fix(client): race in cert renewal ipshipyard/p2p-forge#42
- fix(bitswap): negative wantlist metrics #10670
Nice To Have (Optional)
- Agree if we use
/ipXor/dnsX- For now we keep using
/ipX - Will revisit once this is done: feat: opt-in WithShortForgeAddrs(true|false) to produce /dnsX addrs ipshipyard/p2p-forge#40
- For now we keep using
- fix(cli): support HTTPS in ipfs --api #10659
- accelerated-dht: cleanup peer from message sender on disconnection libp2p/go-libp2p-kad-dht#1009
- mfs: clean cache on sync boxo#751
- fix(cmds/add): disallow --wrap with --to-files #10612
- Broken CID info for identity multihashes ipld-explorer-components#464
- feat(bootstrap): add JS-based va1.bootstrap.libp2p.io #10575
- Boxo
- AutoTLS
- acme_client "got renewal info" (logger does not respect go-log config) ipshipyard/p2p-forge#8 (comment)
- AutoTLS: attempts to get cert when not publicly diallable #10570
- add flag for adding catch-all listener without touching swarm listeners in config
- Denylist support fixes and improvements
- Support legacy double-hash entries for IPNS CIDs and DNSLink ipfs-shipyard/nopfs#40
- ipfs blockservice is incompatible with sessions ipfs-shipyard/nopfs#34 (NOfs content filtering is not applied to bitswap)
- Support consuming https://badbits.dwebops.pub/badbits.deny rainbow#126 (same applies to Kubo)
- Update pubsub and add default validator #9684 + update to v0.12.0 with GossipSub v1.2
- Add basic UnixFS sanity check to 'ipfs files cp' #10331
- feat(filestore): add mmap reader option boxo#665 disabled by default, with opt-in variable similar to this or this
- Prevent multiple instances of "ipfs bitswap reprovide" running at the same time #10513
- gateway/blocks-backend: GetBlock should not perform IPLD decoding boxo#673
Metadata
Metadata
Assignees
Labels
No labels
Activity
lidel commentedon Dec 12, 2024
Team is working on multiple high impact perf. fixes, making a slight delay worth it.
We are pushing RC1 to the next week, and final release to January (after holiday break).
lidel commentedon Dec 20, 2024
✅ Release Checklist (v0.33.0-rc1)
This is a rare case where we make RC on Friday, but we want to ship RC1 before holidays, so folks can test improved AutoTLS, MFS and other features (changelog) over holidays :)
using
./kuboreleaser --skip-check-before release --version vX.Y.Z(-rcN) prepare-branchor ...release-vX.Y.Zmasteras base ifZ == 0releaseas base ifZ > 0CurrentVersionNumberin version.go in themasterbranch tovX.Y+1.0-devCurrentVersionNumberin version.go in therelease-vX.Ybranch tovX.Y.Z(-rcN)release-vX.Ytoreleasemasterto therelease-vX.Y.Zusinggit cherry-pick -x <commit>ChangelogandContributorssections of the changelog with the stdout of./bin/mkreleaselog. Note that the command expects your$GOPATH/src/github.com/ipfs/kuboto include latest commits fromrelease-vX.Yrelease-vX.Ytoreleaseare passingrelease-vX.Ytoreleaseusing theCreate a merge commitSquash and mergenorRebase and mergebecause we need to be able to sign the merge commitrelease-vX.Ybranchusing
./kuboreleaser release --version vX.Y.Z(-rcN) tagor ...git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'releasebranch usinggit tag -s vX.Y.Z -m 'Release X.Y.Z'git show vX.Y.Z(-rcN)git push origin vX.Y.Z(-rcN)git push --tagsbecause it pushes all your local tags.tool-versions'sgolangentry is set to the latest go release on the major go branch Kubo is being tested on (seego-version:)../kuboreleaser --skip-check-before --skip-run release --version vX.Y.Z(-rcN) publish-to-allor follow each step below:using
./kuboreleaser --skip-check-before --skip-run release --version vX.Y.Z(-rcN) publish-to-dockerhubor ...using
./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-distributionsor ...git checkout -b release-kubo-X.Y.Z(-rcN)./dist.sh add-version kubo vX.Y.Z(-rcN)to add the new version to theversionsfiledists/kubo/versionsanddists/go-ipfs/versions(dists/kubo/currentanddists/go-ipfs/current)using⚠️ you might need to run the command a couple of times because GHA might not be able to see the new distribution straight away due to caching) or ...
./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-npm(using
./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-githubor ...vX.Y.Z(-rcN)tagThis is a pre-releasecheckboxThis is a pre-releasecheckboxusing
./kuboreleaser release --version vX.Y.Z(-rcN) promoteor ...Kubo vX.Y.Z(-rcN) is out!as the titlekuboandgo-ipfsas topics##) in the descriptionTest the new version with(currently skipped)ipfs-companionusing
./kuboreleaser release --version vX.Y.Z(-rcN) test-ipfs-companionor ...vX.Y.Z(-rcN)as the Kubo image versionusing
./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-desktopor ...npm installpackage.jsonandpackage-lock.jsonusing
./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-docsor ...using
./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-blog --date YYYY-MM-DDor ...-dev) version,using
./kuboreleaser release --version vX.Y.Z(-rcN) merge-branchor ...merge-release-vX.Y.Zfromreleasemerge-release-vX.Y.Ztomasterusing
./kuboreleaser release --version vX.Y.Z(-rcN) prepare-nextor ...go.modin the root directory (NOTE: do not rungo get -uas it will upgrade indirect dependencies which may cause problems)make mod_tidygo.modandgo.sumlidel commentedon Dec 20, 2024
Kubo v0.33.0-rc1 is out! ✨
Early testers ping for RC1 testing:
lidel commentedon Jan 22, 2025
✅ Release Checklist (v0.33.0-rc2)
using
./kuboreleaser --skip-check-before release --version vX.Y.Z(-rcN) prepare-branchor ...release-vX.Y.Zmasteras base ifZ == 0releaseas base ifZ > 0CurrentVersionNumberin version.go in themasterbranch tovX.Y+1.0-devCurrentVersionNumberin version.go in therelease-vX.Ybranch tovX.Y.Z(-rcN)release-vX.Ytoreleasemasterto therelease-vX.Y.Zusinggit cherry-pick -x <commit>ChangelogandContributorssections of the changelog with the stdout of./bin/mkreleaselog. Note that the command expects your$GOPATH/src/github.com/ipfs/kuboto include latest commits fromrelease-vX.Yrelease-vX.Ytoreleaseare passingrelease-vX.Ytoreleaseusing theCreate a merge commitSquash and mergenorRebase and mergebecause we need to be able to sign the merge commitrelease-vX.Ybranchusing
./kuboreleaser release --version vX.Y.Z(-rcN) tagor ...git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'releasebranch usinggit tag -s vX.Y.Z -m 'Release X.Y.Z'git show vX.Y.Z(-rcN)git push origin vX.Y.Z(-rcN)git push --tagsbecause it pushes all your local tags.tool-versions'sgolangentry is set to the latest go release on the major go branch Kubo is being tested on (seego-version:)../kuboreleaser --skip-check-before --skip-run release --version vX.Y.Z(-rcN) publish-to-allor follow each step below:using
./kuboreleaser --skip-check-before --skip-run release --version vX.Y.Z(-rcN) publish-to-dockerhubor ...using
./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-distributionsor ...git checkout -b release-kubo-X.Y.Z(-rcN)./dist.sh add-version kubo vX.Y.Z(-rcN)to add the new version to theversionsfiledists/kubo/versionsanddists/go-ipfs/versions(dists/kubo/currentanddists/go-ipfs/current)using⚠️ you might need to run the command a couple of times because GHA might not be able to see the new distribution straight away due to caching) or ...
./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-npm(using
./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-githubor ...vX.Y.Z(-rcN)tagThis is a pre-releasecheckboxThis is a pre-releasecheckboxusing
./kuboreleaser release --version vX.Y.Z(-rcN) promoteor ...Kubo vX.Y.Z(-rcN) is out!as the titlekuboandgo-ipfsas topics##) in the descriptionTest the new version with(currently skipped)ipfs-companionusing
./kuboreleaser release --version vX.Y.Z(-rcN) test-ipfs-companionor ...vX.Y.Z(-rcN)as the Kubo image versionusing
./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-desktopor ...npm installpackage.jsonandpackage-lock.jsonusing
./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-docsor ...using
./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-blog --date YYYY-MM-DDor ...-dev) version,using
./kuboreleaser release --version vX.Y.Z(-rcN) merge-branchor ...merge-release-vX.Y.Zfromreleasemerge-release-vX.Y.Ztomasterusing
./kuboreleaser release --version vX.Y.Z(-rcN) prepare-nextor ...go.modin the root directory (NOTE: do not rungo get -uas it will upgrade indirect dependencies which may cause problems)make mod_tidygo.modandgo.sumlidel commentedon Jan 23, 2025
v0.33.0-rc2 is out, but we will have RC3 due to discovered regressions. stay tuned :)
lidel commentedon Jan 23, 2025
✅ Release Checklist (v0.33.0-rc3)
1. Prepare release branch
release-vX.Y.Zmasteras base ifZ == 0releaseas base ifZ > 0CurrentVersionNumberin version.go in themasterbranch tovX.Y+1.0-dev(example)CurrentVersionNumberin version.go in therelease-vX.Ybranch tovX.Y.Z(-rcN)(example)release-vX.Y.Ztorelease(example)masterto therelease-vX.Y.Zusinggit cherry-pick -x <commit>(example)-xis importantChangelogandContributorssections of the changelog with the stdout of./bin/mkreleaselog.$GOPATH/src/github.com/ipfs/kuboto include latest commits fromrelease-vX.Y.Zrelease-vX.Y.Ztoreleaseare passingrelease-vX.Y.Ztoreleaseusing theCreate a merge commitSquash and mergenorRebase and mergebecause we need to be able to sign the merge commitrelease-vX.Y.Zbranch2. Tag release
git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'releasebranch usinggit tag -s vX.Y.Z -m 'Release X.Y.Z'git show vX.Y.Z(-rcN)git push origin vX.Y.Z(-rcN)git push --tagsbecause it pushes all your local tags3. Publish
git checkout -b release-kubo-X.Y.Z(-rcN)./dist.sh add-version kubo vX.Y.Z(-rcN)to add the new version to theversionsfile (usage).tool-versions'sgolangentry is set to the latest go release on the major go branch Kubo is being tested on (seego-version:). If not, update.tool-versionsto match the latest golang.dists/kubo/versionsanddists/go-ipfs/versions(dists/kubo/currentanddists/go-ipfs/current)vX.Y.Z(-rcN)tagThis is a pre-releasecheckboxThis is a pre-releasecheckbox4. After Publishing
Kubo vX.Y.Z(-rcN) is out!as the title andkuboandgo-ipfsas tags##) in the descriptionnpm installpackage.jsonandpackage-lock.jsonmerge-release-vX.Y.Zfromreleasemerge-release-vX.Y.Ztomaster-devinmaster)go.modin the root directory (NOTE: do not rungo get -uas it will upgrade indirect dependencies which may cause problems)make mod_tidygo.modandgo.sumlidel commentedon Jan 23, 2025
Kubo v0.33.0-rc1 is out! ✨ Early testers ping for testing:
lidel commentedon Jan 29, 2025
✅ Release Checklist (v0.33.0 FINAL)
1. Prepare release branch
release-vX.Y.Zmasteras base ifZ == 0releaseas base ifZ > 0CurrentVersionNumberin version.go in themasterbranch tovX.Y+1.0-dev(example)CurrentVersionNumberin version.go in therelease-vX.Ybranch tovX.Y.Z(-rcN)(example)release-vX.Y.Ztorelease(example)masterto therelease-vX.Y.Zusinggit cherry-pick -x <commit>(example)-xis importantChangelogandContributorssections of the changelog with the stdout (do NOT copy the stderr) of./bin/mkreleaselog.mkreleaselogexpects your$GOPATH/src/github.com/ipfs/kuboto include latest commits fromrelease-vX.Y.Zrelease-vX.Y.Ztoreleaseare passingrelease-vX.Y.Ztoreleaseusing theCreate a merge commitSquash and mergenorRebase and mergebecause we need to be able to sign the merge commitrelease-vX.Y.Zbranch2. Tag release
git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'releasebranch usinggit tag -s vX.Y.Z -m 'Release X.Y.Z'git show vX.Y.Z(-rcN)git push origin vX.Y.Z(-rcN)git push --tagsbecause it pushes all your local tags3. Publish
git checkout -b release-kubo-X.Y.Z(-rcN)./dist.sh add-version kubo vX.Y.Z(-rcN)to add the new version to theversionsfile (usage).tool-versions'sgolangentry is set to the latest go release on the major go branch Kubo is being tested on (seego-version:). If not, update.tool-versionsto match the latest golang.dists/kubo/versionsanddists/go-ipfs/versions(NOTE:dists/kubo/currentanddists/go-ipfs/current– example)vX.Y.Z(-rcN)tagThis is a pre-releasecheckboxThis is a pre-releasecheckbox4. After Publishing
merge-release-vX.Y.Zfromrelease./docs/changelogs/vA.B.mdand link to the new changelog from the./CHANGELOG.mdfilemerge-release-vX.Y.ZtomasterSquash and mergenorRebase and mergebecause we need to be able to sign the merge commit-devinmaster)Kubo vX.Y.Z(-rcN) is out!as the title andkuboandgo-ipfsas tags##) in the descriptionnpm installpackage.jsonandpackage-lock.jsongo.modin the root directory (NOTE: do not rungo get -uas it will upgrade indirect dependencies which may cause problems)make mod_tidygo.modandgo.sumlidel commentedon Jan 30, 2025
Kubo 0.33.0 is out! ✨
We will publish forum topic and blog post tomorrow, once discourse maintenance is done (currently is read-only)
lidel commentedon Jan 31, 2025
Shipped. If you want to promote release, use:
lidel commentedon Feb 3, 2025
Boxo release v0.27.3 has an extremely impactful bitswap fix. The difference in Kubo under load (tested with small slice of gateway traffic from ipfs.io, at ~80rps) is so big we will likely tag a patch release 0.33.1 this week so it can reach users without waiting for 0.34.
RubenKelevra commentedon Feb 3, 2025
@lidel now I know what my server hit a couple of weeks ago when it saw a load of >850. I wasn't able to SSH onto it, but still could shut it down but the log showed nothing of noteworthy.
lidel commentedon Feb 4, 2025
lidel commentedon Feb 4, 2025
✅ Release Checklist (v0.33.1)
This section covers tasks to be done during each release.
1. Prepare release branch
release-vX.Y.Zmasteras base ifZ == 0releaseas base ifZ > 0CurrentVersionNumberin version.go in themasterbranch tovX.Y+1.0-dev(example)CurrentVersionNumberin version.go in therelease-vX.Ybranch tovX.Y.Z(-rcN)(example)release-vX.Y.Ztorelease(example)masterto therelease-vX.Y.Zusinggit cherry-pick -x <commit>(example)-xis importantChangelogandContributorssections of the changelog with the stdout (do NOT copy the stderr) of./bin/mkreleaselog.mkreleaselogexpects your$GOPATH/src/github.com/ipfs/kuboto include latest commits fromrelease-vX.Y.Zrelease-vX.Y.Ztoreleaseare passingrelease-vX.Y.Ztoreleaseusing theCreate a merge commitSquash and mergenorRebase and mergebecause we need to be able to sign the merge commitrelease-vX.Y.Zbranch2. Tag release
git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'releasebranch usinggit tag -s vX.Y.Z -m 'Release X.Y.Z'git show vX.Y.Z(-rcN)git push origin vX.Y.Z(-rcN)git push --tagsbecause it pushes all your local tags3. Publish
git checkout -b release-kubo-X.Y.Z(-rcN)./dist.sh add-version kubo vX.Y.Z(-rcN)to add the new version to theversionsfile (usage).tool-versions'sgolangentry is set to the latest go release on the major go branch Kubo is being tested on (seego-version:). If not, update.tool-versionsto match the latest golang.dists/kubo/versionsanddists/go-ipfs/versions(NOTE:dists/kubo/currentanddists/go-ipfs/current– example)vX.Y.Z(-rcN)tagThis is a pre-releasecheckboxThis is a pre-releasecheckbox4. After Publishing
merge-release-vX.Y.Zfromrelease./docs/changelogs/vA.B.mdand link to the new changelog from the./CHANGELOG.mdfilemerge-release-vX.Y.ZtomasterSquash and mergenorRebase and mergebecause we need to be able to sign the merge commit-devinmaster)Kubo vX.Y.Z(-rcN) is out!as the title andkuboandgo-ipfsas tags##) in the descriptionnpm installpackage.jsonandpackage-lock.jsongo.modin the root directory (NOTE: do not rungo get -uas it will upgrade indirect dependencies which may cause problems)make mod_tidygo.modandgo.sumlidel commentedon Feb 4, 2025
0.33.1 is out!
lidel commentedon Feb 13, 2025
We've identified go-libp2p issue on Kubo bootstrappers, and there is a backported fix:
I'll be looking into feasibility of 0.33.2 later today.
lidel commentedon Feb 13, 2025
✅ Release Checklist (v0.33.2)
1. Prepare release branch
release-vX.Y.Zmasteras base ifZ == 0releaseas base ifZ > 0CurrentVersionNumberin version.go in themasterbranch tovX.Y+1.0-dev(example)CurrentVersionNumberin version.go in therelease-vX.Y.Zbranch tovX.Y.Z(-rcN)(example)release-vX.Y.Ztorelease(example)masterto therelease-vX.Y.Zusinggit cherry-pick -x <commit>(example)-xis importantChangelogandContributorssections of the changelog with the stdout (do NOT copy the stderr) of./bin/mkreleaselog.mkreleaselogexpects your$GOPATH/src/github.com/ipfs/kuboto include latest commits fromrelease-vX.Y.Zrelease-vX.Y.Ztoreleaseare passingrelease-vX.Y.Ztoreleaseusing theCreate a merge commitSquash and mergenorRebase and mergebecause we need to be able to sign the merge commitrelease-vX.Y.Zbranch2. Tag release
git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'releasebranch usinggit tag -s vX.Y.Z -m 'Release X.Y.Z'git show vX.Y.Z(-rcN)git push origin vX.Y.Z(-rcN)git push --tagsbecause it pushes all your local tags3. Publish
git checkout -b release-kubo-X.Y.Z(-rcN)./dist.sh add-version kubo vX.Y.Z(-rcN)to add the new version to theversionsfile (usage).tool-versions'sgolangentry is set to the latest go release on the major go branch Kubo is being tested on (seego-version:). If not, update.tool-versionsto match the latest golang.dists/kubo/versionsanddists/go-ipfs/versions(NOTE:dists/kubo/currentanddists/go-ipfs/current– example)vX.Y.Z(-rcN)tagThis is a pre-releasecheckboxThis is a pre-releasecheckbox4. After Publishing
merge-release-vX.Y.Zfromrelease./docs/changelogs/vA.B.mdand link to the new changelog from the./CHANGELOG.mdfilemerge-release-vX.Y.ZtomasterSquash and mergenorRebase and mergebecause we need to be able to sign the merge commit-devinmaster)Kubo vX.Y.Z(-rcN) is out!as the title andkuboandgo-ipfsas tags##) in the descriptionnpm installpackage.jsonandpackage-lock.jsongo.modin the root directory (NOTE: do not rungo get -uas it will upgrade indirect dependencies which may cause problems)make mod_tidygo.modandgo.sumchore: kubo v0.33.2
chore: kubo v0.33.2 (#1127)
fix: kubo 0.33.2
lidel commentedon Feb 14, 2025
v0.33.2 is out!