releases: switch to a soft release model #6500
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,27 @@ | ||
| # Go-IPFS Changelog Template | ||
|
|
||
| ## X.Y.Z YYYY-MM-DD | ||
|
|
||
| We're happy to announce go-ipfs X.Y.Z, bla bla... | ||
|
|
||
| < release notes > | ||
|
|
||
| ### Contributors | ||
|
|
||
| < list generated by bin/mkreleaselog > | ||
|
|
||
| Would you like to contribute to the IPFS project and don't know how? Well, there are a few places you can get started: | ||
|
|
||
| - Check the issues with the `help wanted` label in the [go-ipfs repo](https://github.com/ipfs/go-ipfs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | ||
| - Join an IPFS All Hands, introduce yourself and let us know where you would like to contribute - https://github.com/ipfs/team-mgmt/#weekly-ipfs-all-hands | ||
| - Hack with IPFS and show us what you made! The All Hands call is also the perfect venue for demos, join in and show us what you built | ||
| - Join the discussion at http://discuss.ipfs.io/ and help users finding their answers. | ||
| - Join the [Go Core Dev Team Weekly Sync](https://github.com/ipfs/team-mgmt/issues/650) and be part of the Sprint action! | ||
|
|
||
| ### ⁉️ Do you have questions? | ||
|
|
||
| The best place to ask your questions about IPFS, how it works and what you can do with it is at [discuss.ipfs.io](http://discuss.ipfs.io). We are also available at the `#ipfs` channel on Freenode, which is also [accessible through our Matrix bridge](https://riot.im/app/#/room/#freenode_#ipfs:matrix.org). | ||
|
|
||
| ### Changelog | ||
|
|
||
| < changelog generated by bin/mkreleaselog > | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -9,28 +9,49 @@ | |
|
|
||
| ## Release Philosophy | ||
|
|
||
| `go-ipfs` aims to have release every six weeks, two releases per quarter. During these 6 week releases, we go through 4 different stages that gives us the opportunity to test the new version against our test environments (unit, interop, integration), QA in our current production environment, IPFS apps (e.g. Desktop and WebUI) and with our community and _early testers_<sup>[1]</sup> that have IPFS running in Production. | ||
|
|
||
| We might expand the six week release schedule in case of: | ||
| - No new updates to be added | ||
| - In case of a large community event that takes the core team availability away (e.g. IPFS Conf, Dev Meetings, IPFS Camp, etc) | ||
|
|
||
| ## Release Flow | ||
|
|
||
| `go-ipfs` releases come in 4 stages designed to gradually roll out changes and reduce the impact of any regressions that may have been introduced. If we need to merge non-trivial features/fixes during the process, we start over at stage 1. | ||
|
|
||
| ### Stage 1 - Internal Testing | ||
|
|
||
| Before this stage, we expect _all_ tests (interop, testlab, performance, etc.) to pass. | ||
|
|
||
| At this stage, we'll: | ||
|
|
||
| 1. Start a partial-rollout to our own infrastructure. | ||
| 2. Test against ipfs and ipfs-shipyard applications. | ||
|
|
||
| **Goal(s):** | ||
|
|
||
| 1. Make sure we haven't introduced any obvious regressions. | ||
| 2. Test the release in an environment we can monitor and easily roll back (i.e., our own infra). | ||
|
|
||
| ### Stage 2 - Public Beta | ||
|
|
||
| At this stage, we'll announce the impending release to the community and ask for beta testers. | ||
|
|
||
| **Goal:** Test the release in as many non-production environments as possible. This is relatively low-risk but gives us a _breadth_ of testing internal testing can't. | ||
|
|
||
| ### Stage 3 - Soft Release | ||
|
|
||
| At this stage, we consider the release to be "production ready" and ask will ask the community and our early testers to (partially) deploy the release to their production infrastructure. | ||
|
There was a problem hiding this comment. In #6496, I had a separate stages for asking early testers to test in production and asking the rest of the community. I removed that here to try to keep this from dragging on but can add it back. Thoughts @daviddias, @lanzafame? |
||
|
|
||
| **Goal(s):** | ||
|
|
||
| 1. Test the release in some production environments with heavy workloads. | ||
| 2. Partially roll-out an upgrade to see how it affects the network. | ||
| 3. Retain the ability to ship last-minute fixes before the final release. | ||
|
|
||
| ### Stage 4 - Release | ||
|
|
||
| At this stage, the release is "battle hardened" and ready for wide deployment. | ||
|
|
||
| ## Performing a Release | ||
|
|
||
|
|
@@ -54,91 +75,63 @@ The first step is for the `Lead Maintainer` for `go-ipfs` to open an issue with | |
| # ✅ Release Checklist | ||
|
|
||
| For each RC published in each stage: | ||
|
|
||
| - version string in `version.go` has been updated | ||
| - tag commit with vX.Y.Z-rcN | ||
|
|
||
| - [ ] Stage 1 - Internal Testing | ||
|
There was a problem hiding this comment. Tried to make it easier to track which stages have been completed (checking all the boxes inside the stage doesn't mean that the stage itself is done). |
||
| - [ ] Feature freeze. If any non-trivial features get added to the release, uncheck all the checkboxes and return to this stage. | ||
| - [ ] CHANGELOG.md has been updated | ||
| - use `./bin/mkreleaselog` to generate a nice starter list | ||
| - use `./doc/RELEASE_TEMPLATE.md` as a template | ||
| - [ ] Automated Testing (already tested in CI) - Ensure that all tests are passing, this includes: | ||
| - [ ] unit | ||
| - [ ] sharness | ||
| - [ ] [interop](https://github.com/ipfs/interop#test-with-a-non-yet-released-version-of-go-ipfs) | ||
| - [ ] go-ipfs-api | ||
| - [ ] go-ipfs-http-client | ||
| - [ ] Network Testing: | ||
| - [ ] test lab things | ||
| - [ ] Infrastructure Testing: | ||
| - [ ] Deploy new version to a subset of Bootstrappers | ||
| - [ ] Deploy new version to a subset of Gateways | ||
| - [ ] Deploy new version to a subset of Preload nodes | ||
| - [ ] Collect metrics every day. Work with the Infrastructure team to learn of any hiccup | ||
| - [ ] IPFS Application Testing - Run the tests of the following applications: | ||
| - [ ] WebUI | ||
| - [ ] IPFS Desktop | ||
| - [ ] IPFS Companion | ||
| - [ ] NPM on IPFS | ||
| - [ ] Stage 2 - Public Beta | ||
| - [ ] Reach out to the IPFS _early testers_ listed in `docs/EARLY_TESTERS.md` for testing this release (check when no more problems have been reported). If you'd like to be added to this list, please file a PR. | ||
| - [ ] Reach out to on IRC for beta testers. | ||
| - [ ] Run tests available in the following repos with the latest beta (check when all tests pass): | ||
| - [ ] [orbit-db](https://github.com/orbitdb/orbit-db) | ||
| - [ ] Stage 3 - Soft Release | ||
| - [ ] Documentation | ||
| - [ ] Ensure that CHANGELOG.md is up to date | ||
| - [ ] Ensure that README.md is up to date | ||
| - [ ] Ensure that all the examples we have produced for go-ipfs run without problems | ||
| - [ ] Update HTTP-API Documentation on the Website using https://github.com/ipfs/http-api-docs | ||
| - [ ] Invite the IPFS _early testers_ to deploy the release to part of their production infrastructure. | ||
| - [ ] Invite the wider community through (link to the release issue): | ||
| - [ ] [discuss.ipfs.io](https://discuss.ipfs.io/c/announcements) | ||
| - [ ] IRC | ||
| - [ ] Stage 4 - Release | ||
| - [ ] Final preparation | ||
| - [ ] Verify that version string in `repo/version.go` has been updated | ||
| - [ ] tag commit with vX.Y.Z | ||
| - [ ] update release branch to point to release commit (`git merge vX.Y.Z`). | ||
| - [ ] publish dist.ipfs.io | ||
| - [ ] publish next version to https://github.com/ipfs/npm-go-ipfs | ||
| - [ ] Publish a Release Blog post (at minimum, a c&p of this release issue with all the highlights, API changes, link to changelog and thank yous) | ||
| - [ ] Broadcasting (link to blog post) | ||
| - [ ] IRC | ||
| - [ ] [discuss.ipfs.io](https://discuss.ipfs.io/c/announcements) | ||
| - [ ] Announce it on the [IPFS Users mlist](https://groups.google.com/forum/#!forum/ipfs-users) | ||
| ``` | ||
|
|
||
| ## Release Version Numbers (aka semver) | ||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@daviddias see #6496 (comment).