...
| Info |
|---|
| title | You are performing an Apache StreamPipes release for the first time? |
|---|
|
Read the Onboarding Guide for Release Managers! |
Update release notes
IMPORTANT: This process did not work for the last release (0.92.0). I created an issue to fix it, see #1667).
To provide a proper overview of what has changed within the current release, we need to update file RELEASE_NOTES.md in our release branch (rel/VERSION ).
Therefore it is required to perform the following steps.
- Go to the following repository and follow the instructions (https://github.com/dominikriemer/jira-to-issues)
- Copy the release notes printed to the console and insert it into the release notes
| Code Block |
|---|
| language | xml |
|---|
| theme | Confluence |
|---|
| title | Release Notes Example |
|---|
| linenumbers | true |
|---|
|
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
# [x.yy.z]
<GENERATED RELEASE NOTES> |
Update issue template
Update the current version in the issue template for bug reports here.
| Code Block |
|---|
| language | yml |
|---|
| title | Bug Issue Teamplate |
|---|
| linenumbers | true |
|---|
|
- type: dropdown
attributes:
label: Apache StreamPipes version
description: What Apache StreamPipes version are you using?
multiple: false
options:
- "0.70.0" # change to new release version
- "dev (current development state)"
- "Other StreamPipes version (please specify below)"
|
Prepare release candidates
...
| Code Block |
|---|
| language | bash |
|---|
| title | Update UI version |
|---|
|
# Update the version in ui/package.json
# Update the version in ui/package-lock.json (Be careful, this file contains two places with SNAPSHOT). |
Use the update version script to change version of the installer (directory: installer)
...
| Code Block |
|---|
| language | bash |
|---|
| title | Upload files to SVN |
|---|
|
# Create a new rc folder in the SVN (https://dist.apache.org/repos/dist/dev/incubator/streampipes)
# Create a new directory for the version (e.g., 0.69.0) and add release candidate (which is increased for every failed release), e.g., rc1.
# The folder structure should look like this:
- 0.69.0
- rc1
# Copy the following files into this folder (they can be found in incubator-streampipes/target/checkout/target:
- RELEASE_NOTES.md
- RELEASE_VALIDATION.md
- README.md
- The zip file (apache-streampipes-VERSION-incubating-source-release.zip)
- The asc file (apache-streampipes-VERSION-source-release.zip.asc)
- The sha512 file (apache-streampipes-VERSION-source-release.zip.sha512)
# # Commit these changes to SVN. |
...
Now comes the best part: You're ready to send the VOTE mail to the developer list!Remember: As an incubating project, two votes are required: First, the Apache StreamPipes community triggers a vote - once this vote is successful, a second vote will happen on the incubator list. But one step after the other - now let's write the mail targeted at our developer list at dev@streampipes.apache.org:
| Panel |
|---|
|
TO:
dev@streampipes.apache.org
SUBJECT:
[VOTE] Apache StreamPipes 0.6990.0 (incubating) RC1 release
TEXT:
Apache StreamPipes (Incubating) 0.6990.0 has been staged and it’s time to vote on accepting it for release.
If approved, we will seek final release approval from the IPMC. Voting will be open for at least 72 hours.
A minimum of 3 binding +1 votes and more binding +1 than binding -1 are required to pass, but everyone is welcome to vote!
One artifactsartifact is relevant for this vote:
incubator-
streampipes, staged at [1], available in Nexus at [2], release tag: release/0.6990.0, hash for the release tag: 6893604222cb9c3efc4bf66dc0c21e3223c2c84e
Per [3] "Before voting +1, [P]PMC members are required to download the signed source code package,
compile it as provided, and test the resulting executable on their own platform,
along with also verifying that the package meets the requirements of the ASF policy on releases."
A release validation guide is available at [4]. The KEYS file is available at [5]
[ ] +1 accept (indicate what you validated - e.g. performed the checklist at the end of [4])
[ ] -1 reject (explanation required)
Thanks for taking your time for validating this release!
[1] https://dist.apache.org/repos/dist/dev/incubator/streampipes/0.6990.0/rc1 /
[2] https://repository.apache.org/content/repositories/orgapachestreampipes-1016
[3] https://www.apache.org/dev/release.html#approving-a-release
[4] https://cwiki.apache.org/confluence/display/STREAMPIPES/Validating+a+release
[5] https://distdownloads.apache.org/repos/dist/dev/incubator/streampipes/KEYS |
Cancel a vote
- If problems occur during the VOTE cancel the VOTE and prepare a new release candidate
| Panel |
|---|
|
TO:
dev@streampipes.apache.org
SUBJECT:
[CANCEL][VOTE] Apache StreamPipes 0.6990.0 (incubating) RC1 release
TEXT:
Add description of the problem and how to resolve it. |
...
After 72 hours, the vote can be closed. Sometimes it might be worth to wait a little longer to allow all IPMC PMC members to vote accordingly. If votes are missing, you can also directly approach people from the PPMC PMC and ask for their vote.
Send the following mail to the dev list to announce the results:
| Panel |
|---|
|
TO:
dev@streampipes.apache.org
SUBJECT:
[RESULT][VOTE] Apache StreamPipes 0.69.0 (incubating) RC1 release
TEXT:
Hi all,
the vote is now closed after the 72h period has passed.
Result (as per [1], only votes from IPMC members are binding): The vote PASSES with X votes +1 (X binding/Y non-binding) and no -1.
+1 (binding)
List
+1 (non-binding)
List
I will now bring the vote to the IPMC to get final approval for release.
NAME
[1] https://incubator.apache.org/guides/ppmc.html#ppmc_and_binding_votes
|
Vote on Incubator list
|
| Code Block |
|---|
|
TO:
general@incubator.apache.org
SUBJECT:
[VOTE] Apache StreamPipes 0.69.0 (incubating) RC1 release
TEXT:
Hi all,
this is a call for a vote to release Apache StreamPipes (incubating) 0.69.0.
Apache StreamPipes (incubating) is self-service Industrial IoT toolbox to enable non-technical users to connect, analyze and explore IIoT data streams.
The Apache StreamPipes community has voted on and approved a proposal to release Apache StreamPipes (incubating) 0.69.0
We now kindly request the Incubator PMC members to review and vote on this release.
Vote and result threads from the StreamPipes community:
Result: https://lists.apache.org/thread/hmx9wtyjw6tqbx70gpvnr8tqcg0xxlcc
Vote: https://lists.apache.org/thread/b58pym522yqn4qbdym549xh440boy52p
From the PPMC vote, we carry over 1 binding IPMC votes:
Christofer Dutz
The vote will be open for at least 72 hours.
Please vote accordingly:
[] +1 approve (indicate what you validated - e.g., performed the checklist at [6])
[] +0 no opinion
[] -1 reject (explanation required) One artifacts is relevant for this vote:
incubator-streampipes, staged at [1], available in Nexus at [2], release tag: release/0.69.0, hash for the release tag: 6893604222cb9c3efc4bf66dc0c21e3223c2c84e
Per [3] "Before voting +1, [P]PMC members are required to download the signed source code package,
compile it as provided, and test the resulting executable on their own platform,
along with also verifying that the package meets the requirements of the ASF policy on releases."
A release validation guide is available at [4]. The KEYS file is available at [5]
Thanks for taking your time for validating this release!
[1] https://dist.apache.org/repos/dist/dev/incubator/streampipes/0.69.0/rc1/
[2] https://repository.apache.org/content/repositories/orgapachestreampipes-1016
[3] https://www.apache.org/dev/release.html#approving-a-release
[4] https://cwiki.apache.org/confluence/display/STREAMPIPES/Validating+a+release
[5] https://dist.apache.org/repos/dist/dev/incubator/streampipes/KEYS |
Publish vote result to Incubator list
| Code Block |
|---|
| title | IPMC Vote Result Mail |
|---|
|
TO:
general@incubator.apache.org
SUBJECT:
[RESULT][VOTE] Release Apache StreamPipes 0.69.0 (incubating)
TEXT:
Hi all,
The vote to release Apache StreamPipes (incubating) 0.69.0 has passed with three +1 binding votes.
Binding votes:
Christofer Dutz
Julian Feinauer
Justin Mclean
Vote thread:
https://lists.apache.org/thread.html/r451a554230a558e3035c4d1c870591d50c2cadf00c36b0f9ba4a4616%40%3Cgeneral.incubator.apache.org%3E
: LINK_TO_VOTE_THREAD
Thanks a lot to everyone for taking your time to review our release candidate!
We will proceed with publishing the approved artifacts and sending out the announcements in the coming days.
On behalf of the Apache StreamPipes Community,
NAME
NAME
|