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~
