Very thorough. You might want to include some notes about what to do if the RC is voted against, or if a new rc is needed for any reason (i.e. the process for cancelling the current vote thread and starting a new one)
Patrick On Wed, Jun 7, 2017 at 9:43 AM, Debojyoti Dutta <ddu...@gmail.com> wrote: > Overall it was a great writeup. > > On Wed, Jun 7, 2017 at 9:35 AM, Gary Wong <qich...@gmail.com> wrote: > > > Hi Debo, > > > > Thank you for the review and sorry for some missing steps, I will add > them > > up soon, Thanks! > > > > Very truly yours > > Gary > > > > > > On Tue, Jun 6, 2017 at 5:13 PM, Debojyoti Dutta <ddu...@gmail.com> > wrote: > > > >> Thanks ... I am following the process (pretty well written) and have an > >> issue with GPG versions ... hoping to solve it soon and send out email > >> > >> Will add some more details after I am done > >> > >> debo > >> > >> On Tue, Jun 6, 2017 at 4:54 PM, Gary Wong <qich...@gmail.com> wrote: > >> > >>> Hi Patrick, Debo and folks > >>> > >>> We have updated the "How to release" page according to your feedback, > >>> Please review it again, Thanks! > >>> https://cwiki.apache.org/confluence/display/MNEMONIC/How+to+release > >>> > >>> Very truly yours > >>> Gary > >>> > >>> > >>> On Mon, Jun 5, 2017 at 11:58 AM, Gary Wong <qich...@gmail.com> wrote: > >>> > >>>> Thanks Patrick and Johnu for the review and guiding, as Johnu > >>>> mentioned, we will update the wiki and website according to your > feedback, > >>>> also add Johnu's slides to web page. Thanks! > >>>> > >>>> Very truly yours. > >>>> Gary > >>>> > >>>> On Mon, Jun 5, 2017 at 11:51 AM, Johnu George (johnugeo) < > >>>> johnu...@cisco.com> wrote: > >>>> > >>>>> Thanks Patrick for the suggestions. We had a talk recently in Apache > >>>>> BigData Conference 2017 held at FL. (Slides in > >>>>> http://events.linuxfoundation.org/sites/events/files/slides/ > >>>>> Mnemonic.pdf ) We will soon update the website. > >>>>> > >>>>> On 6/5/17, 11:12 AM, "Patrick Hunt" <ph...@apache.org> wrote: > >>>>> > >>>>> You might add the "how to contrib" to your web site. > >>>>> http://mnemonic.incubator.apache.org/develop/ Any other updates > >>>>> that are > >>>>> pending for the web site? (docs seem empty? perhaps just update > to > >>>>> point t > >>>>> content available elsewhere) > >>>>> > >>>>> Are any new http://mnemonic.incubator.apache.org/talks/ > available? > >>>>> > >>>>> This would also be a good time to review the incubator status > >>>>> page, I > >>>>> notice you've probably completed a number of the "work items" > >>>>> (mark the > >>>>> ones that are not applicable as "NA"?) > >>>>> http://incubator.apache.org/projects/mnemonic.html > >>>>> > >>>>> feedback on how to release: > >>>>> * very impressive :-) > >>>>> * link the "dockerfile" to the actual dockerfile? > >>>>> * for things like 1.1.3.1 (checkout) I'd recommend listing the > >>>>> actual > >>>>> command. It makes it foolproof for anyone trying to cut a release > >>>>> to > >>>>> copy/paste. In my experience the more you can cut out potential > >>>>> for error > >>>>> the better off you'll be long term. > >>>>> * for things like "send XXX email" i've found it helpful to > >>>>> include the > >>>>> template in the instructions. It's pretty boilerplate with a > >>>>> number of > >>>>> required bits of data, easier to just include this than expect > the > >>>>> RM to > >>>>> figure it out. Again, smooths the release mechanics and ensures > >>>>> anyone can > >>>>> pick it up at any time. > >>>>> > >>>>> Patrick > >>>>> > >>>>> On Fri, Jun 2, 2017 at 5:04 PM, Gary Wong <qich...@gmail.com> > >>>>> wrote: > >>>>> > >>>>> > Hi Patrick, Debo, Uma and Folks. > >>>>> > > >>>>> > I have written the initial version of "How to release" page for > >>>>> your > >>>>> > review. > >>>>> > https://cwiki.apache.org/confluence/display/MNEMONIC/How+to+ > >>>>> release > >>>>> > > >>>>> > @Uma, Thank you very much for constructing our project Wiki > >>>>> portal and > >>>>> > already added "How to Contribute to Mnemonic" page for us. > >>>>> > https://cwiki.apache.org/confluence/display/MNEMONIC/ > >>>>> > How+to+Contribute+to+Mnemonic > >>>>> > > >>>>> > Very truly yours. > >>>>> > Gary > >>>>> > > >>>>> > > >>>>> > On Wed, May 31, 2017 at 9:52 PM, Gary Wong <qich...@gmail.com> > >>>>> wrote: > >>>>> > > >>>>> >> Great! Thanks Debo :) > >>>>> >> > >>>>> >> Very truly yours > >>>>> >> Gary > >>>>> >> > >>>>> >> > >>>>> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta < > >>>>> ddu...@gmail.com> > >>>>> >> wrote: > >>>>> >> > >>>>> >>> Hi Gary > >>>>> >>> > >>>>> >>> Thx for the 1st version .... happy to help and will add to > the > >>>>> notes as > >>>>> >>> I do the release :) > >>>>> >>> > >>>>> >>> debo > >>>>> >>> > >>>>> >>> On Wed, May 31, 2017 at 4:17 PM, Gary Wong < > qich...@gmail.com> > >>>>> wrote: > >>>>> >>> > >>>>> >>>> Got it, Thanks, Let me submit initial version of "how to > >>>>> release" to > >>>>> >>>> wiki page. > >>>>> >>>> > >>>>> >>>> Very truly yours. > >>>>> >>>> Gary > >>>>> >>>> > >>>>> >>>> On Wed, May 31, 2017 at 3:18 PM, Patrick Hunt < > >>>>> ph...@apache.org> wrote: > >>>>> >>>> > >>>>> >>>>> Having a "how to release" wiki page (or any kind of living > >>>>> document) > >>>>> >>>>> for > >>>>> >>>>> the project ensures that anyone in the community can > release > >>>>> the > >>>>> >>>>> product. > >>>>> >>>>> This is great for onboarding new RMs, etc... > >>>>> >>>>> > >>>>> >>>>> Patrick > >>>>> >>>>> > >>>>> >>>>> On Wed, May 24, 2017 at 9:27 AM, Debojyoti Dutta < > >>>>> ddu...@gmail.com> > >>>>> >>>>> wrote: > >>>>> >>>>> > >>>>> >>>>> > Thx a lot Gary and Patrick for the tips on release > >>>>> management. It > >>>>> >>>>> would be > >>>>> >>>>> > my 1st so I am going to seamlessly ask for forgiveness :) > >>>>> >>>>> > > >>>>> >>>>> > debo > >>>>> >>>>> > > >>>>> >>>>> > On Tue, May 23, 2017 at 7:43 PM, Patrick Hunt < > >>>>> ph...@apache.org> > >>>>> >>>>> wrote: > >>>>> >>>>> > > >>>>> >>>>> >> fyi many projects capture this, some even capture the > >>>>> exact email > >>>>> >>>>> formats > >>>>> >>>>> >> etc..., on their wiki. Typically as a "how to release" > >>>>> page, e.g. > >>>>> >>>>> >> > >>>>> >>>>> >> https://wiki.apache.org/hadoop/HowToRelease > >>>>> >>>>> >> http://htrace.incubator.apache.org/building.html > >>>>> >>>>> >> > >>>>> >>>>> >> You might compare to what you've created, however each > >>>>> project > >>>>> >>>>> typically > >>>>> >>>>> >> has it's own special cases. > >>>>> >>>>> >> > >>>>> >>>>> >> For things like "Commit the whole new release candidate > >>>>> folder in > >>>>> >>>>> the > >>>>> >>>>> >> staged trunk > >>>>> >>>>> >> using the SVN client to commit it all" (and similar) you > >>>>> probably > >>>>> >>>>> should > >>>>> >>>>> >> just give the command to run to simplify things and > >>>>> reduce the > >>>>> >>>>> chances for > >>>>> >>>>> >> error. The more you can make each operation "copy/paste" > >>>>> the more > >>>>> >>>>> likely > >>>>> >>>>> >> you'll have a successful release and easier for the RM. > >>>>> That said > >>>>> >>>>> the more > >>>>> >>>>> >> you can automate the better (typically by adding it to > >>>>> mvn). > >>>>> >>>>> >> > >>>>> >>>>> >> Patrick > >>>>> >>>>> >> > >>>>> >>>>> >> On Tue, May 23, 2017 at 5:50 PM, Gang(Gary) Wang < > >>>>> ga...@apache.org> > >>>>> >>>>> >> wrote: > >>>>> >>>>> >> > >>>>> >>>>> >>> Hi Debo > >>>>> >>>>> >>> > >>>>> >>>>> >>> Thanks you Debo for becoming our new releasing manager, > >>>>> I'm trying > >>>>> >>>>> to > >>>>> >>>>> >>> detail the steps below from my previous releases, hope > >>>>> it can help. > >>>>> >>>>> >>> > >>>>> >>>>> >>> Hi PPMCs > >>>>> >>>>> >>> > >>>>> >>>>> >>> Please correct me if any missing or incorrect items > >>>>> below and > >>>>> >>>>> welcome to > >>>>> >>>>> >>> optimize & improve the following steps, Thanks! > >>>>> >>>>> >>> > >>>>> >>>>> >>> 1) Prepare a Linux box (one time setup) > >>>>> >>>>> >>> The commands are running on Linux OS, so please have a > >>>>> Linux box > >>>>> >>>>> or a > >>>>> >>>>> >>> Virtual Machine for releasing > >>>>> >>>>> >>> > >>>>> >>>>> >>> 2) Prepare your release key if not yet or expired (one > >>>>> time setup) > >>>>> >>>>> >>> https://www.apache.org/dev/openpgp.html#generate-key > >>>>> >>>>> >>> Please also put your key fingerprint into your account, > >>>>> >>>>> >>> https://id.apache.org > >>>>> >>>>> >>> > >>>>> >>>>> >>> 3) Start a GPG agent on your Linux box using the > >>>>> following command > >>>>> >>>>> >>> (before > >>>>> >>>>> >>> releasing) > >>>>> >>>>> >>> $eval 'gpg-agent --daemon --use-standard-socket' > >>>>> >>>>> >>> > >>>>> >>>>> >>> 4) Install SVN client on your laptop to upload > >>>>> staged/released > >>>>> >>>>> artifacts > >>>>> >>>>> >>> > >>>>> >>>>> >>> 5) Using SVN client to check out the staged trunk (One > >>>>> time and > >>>>> >>>>> Update > >>>>> >>>>> >>> before voting) > >>>>> >>>>> >>> https://dist.apache.org/repos/ > >>>>> dist/dev/incubator/mnemonic > >>>>> >>>>> >>> This trunk is used to upload the release candidates > >>>>> before voting > >>>>> >>>>> on > >>>>> >>>>> >>> dev@list > >>>>> >>>>> >>> > >>>>> >>>>> >>> 6) Using SVN client to check out the release trunk (One > >>>>> time and > >>>>> >>>>> Update > >>>>> >>>>> >>> after voting) > >>>>> >>>>> >>> https://dist.apache.org/repos/ > >>>>> dist/release/incubator/mnemonic > >>>>> >>>>> >>> This trunk is used to upload the releases after voting > on > >>>>> >>>>> general@list > >>>>> >>>>> >>> > >>>>> >>>>> >>> 7) Using SVN client to checkout the project status file > >>>>> (One time > >>>>> >>>>> and > >>>>> >>>>> >>> Update after releasing) > >>>>> >>>>> >>> https://svn.apache.org/repos/a > >>>>> sf/incubator/public/trunk/cont > >>>>> >>>>> >>> ent/projects/mnemonic.xml > >>>>> >>>>> >>> > >>>>> >>>>> >>> 8) Replace the KEYS file contents with yours in both > >>>>> trunk of > >>>>> >>>>> stage and > >>>>> >>>>> >>> release and then commit the changes using SVN client > >>>>> >>>>> >>> > >>>>> >>>>> >>> 9) run the following command for auto release packaging > >>>>> on project > >>>>> >>>>> >>> directory > >>>>> >>>>> >>> $./build-tools/release.sh <current release version> > >>>>> <next release > >>>>> >>>>> >>> version> > >>>>> >>>>> >>> <candidate Id> > >>>>> >>>>> >>> for example > >>>>> >>>>> >>> $./build-tools/release.sh 0.8.0 0.8.0 rc1 > >>>>> >>>>> >>> Note that usually we use the same current version in > >>>>> above command > >>>>> >>>>> as we > >>>>> >>>>> >>> cannot predict whether or not have a new candidate for > >>>>> this release > >>>>> >>>>> >>> before > >>>>> >>>>> >>> voting > >>>>> >>>>> >>> In this step, you may have to input your GPG password > to > >>>>> allow gpg > >>>>> >>>>> to > >>>>> >>>>> >>> sign > >>>>> >>>>> >>> off artifacts using your private key > >>>>> >>>>> >>> > >>>>> >>>>> >>> 10) Prepare the new release candidate folder on stage > >>>>> trunk > >>>>> >>>>> >>> please duplicate a folder from latest release candidate > >>>>> on stage > >>>>> >>>>> trunk > >>>>> >>>>> >>> and > >>>>> >>>>> >>> rename it as current release candidate. > >>>>> >>>>> >>> for example: 0.8.0-incubating-rc1 > >>>>> >>>>> >>> and then empty the src folder > >>>>> >>>>> >>> > >>>>> >>>>> >>> 11) Update the CHANGES.txt for current release > candidate > >>>>> on stage > >>>>> >>>>> trunk > >>>>> >>>>> >>> a) open the JIRA for Mnemonic project > >>>>> >>>>> >>> b) in the overview, click the "Versions" > >>>>> >>>>> >>> c) click the latest version that needs to be release, > >>>>> for example > >>>>> >>>>> >>> "0.8.0-incubating" > >>>>> >>>>> >>> d) click the button "Release Notes" on top-right > >>>>> >>>>> >>> e) copy the Text between "Configure Release Notes" and > >>>>> "Edit/Copy > >>>>> >>>>> Release > >>>>> >>>>> >>> Notes" > >>>>> >>>>> >>> f) open CHANGES.txt and replace all contents with the > >>>>> one just > >>>>> >>>>> copied > >>>>> >>>>> >>> > >>>>> >>>>> >>> 12) Upload packaged artifacts from Linux box > >>>>> >>>>> >>> Please use tools e.g. SCP to download all artifacts > >>>>> suffixed with > >>>>> >>>>> >>> *.tar.gz > >>>>> >>>>> >>> under target/ folder into the src folder of staged > trunk > >>>>> >>>>> >>> > >>>>> >>>>> >>> 13) Commit the whole new release candidate folder in > the > >>>>> staged > >>>>> >>>>> trunk > >>>>> >>>>> >>> using the SVN client to commit it all > >>>>> >>>>> >>> > >>>>> >>>>> >>> 14) Prepare a voting mail for dev@list voting > >>>>> >>>>> >>> Please refer to the latest vote mail in dev@list > >>>>> >>>>> >>> > >>>>> >>>>> >>> 15) Report the voting results on dev@list > >>>>> >>>>> >>> if not pass, please prepare next release candidate > after > >>>>> issues > >>>>> >>>>> fixed > >>>>> >>>>> >>> > >>>>> >>>>> >>> 16) Prepare a voting mail for general@list voting > >>>>> >>>>> >>> Please refer to the latest vote mail in general@list > >>>>> >>>>> >>> > >>>>> >>>>> >>> 17) Report the voting results on general@list > >>>>> >>>>> >>> if not pass, please prepare next release candidate > after > >>>>> issues > >>>>> >>>>> fixed > >>>>> >>>>> >>> > >>>>> >>>>> >>> 18) Submit the voted release candidate to release trunk > >>>>> >>>>> >>> a) Please copy the release candidate from staged trunk > >>>>> to release > >>>>> >>>>> trunk > >>>>> >>>>> >>> b) and then remove the rc[x] suffix of the folder, for > >>>>> example, > >>>>> >>>>> >>> 0.8.0-incubating-rc1 to 0.8.0-incubating > >>>>> >>>>> >>> c) commit your new folder into SVN repos using SVN > client > >>>>> >>>>> >>> > >>>>> >>>>> >>> 19) Update the project status file for the new > releasing > >>>>> >>>>> >>> Insert a new xml element to mnemonic.xml for new > release > >>>>> >>>>> >>> for example: "<li>2017-xx-xx the eighth official > >>>>> release.</li>" > >>>>> >>>>> >>> and then commit it using SVN client > >>>>> >>>>> >>> > >>>>> >>>>> >>> Please also improve it or correct it if any issue, > >>>>> Thanks! > >>>>> >>>>> >>> > >>>>> >>>>> >>> Very truly yours > >>>>> >>>>> >>> +Gary > >>>>> >>>>> >>> > >>>>> >>>>> >> > >>>>> >>>>> >> > >>>>> >>>>> > > >>>>> >>>>> > > >>>>> >>>>> > -- > >>>>> >>>>> > -Debo~ > >>>>> >>>>> > > >>>>> >>>>> > >>>>> >>>> > >>>>> >>>> > >>>>> >>> > >>>>> >>> > >>>>> >>> -- > >>>>> >>> -Debo~ > >>>>> >>> > >>>>> >> > >>>>> >> > >>>>> > > >>>>> > >>>>> > >>>>> > >>>> > >>> > >> > >> > >> -- > >> -Debo~ > >> > > > > > > > -- > -Debo~ >