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~ >