You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@mnemonic.apache.org by Debojyoti Dutta <dd...@gmail.com> on 2017/06/01 00:36:34 UTC
Re: Apache Mnemonic Releasing
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 <qi...@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 <dd...@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/asf/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~
Re: Apache Mnemonic Releasing
Posted by Patrick Hunt <ph...@apache.org>.
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 <dd...@gmail.com> wrote:
> Overall it was a great writeup.
>
> On Wed, Jun 7, 2017 at 9:35 AM, Gary Wong <qi...@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 <dd...@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 <qi...@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 <qi...@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) <
> >>>> johnugeo@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 <qi...@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 <qi...@gmail.com>
> >>>>> wrote:
> >>>>> >
> >>>>> >> Great! Thanks Debo :)
> >>>>> >>
> >>>>> >> Very truly yours
> >>>>> >> Gary
> >>>>> >>
> >>>>> >>
> >>>>> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <
> >>>>> ddutta@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 <
> qichfan@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 <
> >>>>> phunt@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 <
> >>>>> ddutta@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 <
> >>>>> phunt@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 <
> >>>>> garyw@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~
>
Re: Apache Mnemonic Releasing
Posted by Debojyoti Dutta <dd...@gmail.com>.
Overall it was a great writeup.
On Wed, Jun 7, 2017 at 9:35 AM, Gary Wong <qi...@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 <dd...@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 <qi...@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 <qi...@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) <
>>>> johnugeo@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 <qi...@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 <qi...@gmail.com>
>>>>> wrote:
>>>>> >
>>>>> >> Great! Thanks Debo :)
>>>>> >>
>>>>> >> Very truly yours
>>>>> >> Gary
>>>>> >>
>>>>> >>
>>>>> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <
>>>>> ddutta@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 <qi...@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 <
>>>>> phunt@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 <
>>>>> ddutta@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 <
>>>>> phunt@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 <
>>>>> garyw@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~
Re: Apache Mnemonic Releasing
Posted by Gary Wong <qi...@gmail.com>.
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 <dd...@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 <qi...@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 <qi...@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) <
>>> johnugeo@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 <qi...@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 <qi...@gmail.com>
>>>> wrote:
>>>> >
>>>> >> Great! Thanks Debo :)
>>>> >>
>>>> >> Very truly yours
>>>> >> Gary
>>>> >>
>>>> >>
>>>> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <
>>>> ddutta@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 <qi...@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 <
>>>> phunt@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 <
>>>> ddutta@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 <
>>>> phunt@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 <
>>>> garyw@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~
>
Re: Apache Mnemonic Releasing
Posted by Debojyoti Dutta <dd...@gmail.com>.
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 <qi...@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 <qi...@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) <
>> johnugeo@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 <qi...@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 <qi...@gmail.com>
>>> wrote:
>>> >
>>> >> Great! Thanks Debo :)
>>> >>
>>> >> Very truly yours
>>> >> Gary
>>> >>
>>> >>
>>> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <
>>> ddutta@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 <qi...@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 <
>>> ddutta@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 <
>>> phunt@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 <
>>> garyw@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~
Re: Apache Mnemonic Releasing
Posted by Gary Wong <qi...@gmail.com>.
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 <qi...@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) <
> johnugeo@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 <qi...@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 <qi...@gmail.com>
>> wrote:
>> >
>> >> Great! Thanks Debo :)
>> >>
>> >> Very truly yours
>> >> Gary
>> >>
>> >>
>> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <ddutta@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 <qi...@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 <
>> ddutta@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 <
>> phunt@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 <
>> garyw@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~
>> >>>
>> >>
>> >>
>> >
>>
>>
>>
>
Re: Apache Mnemonic Releasing
Posted by Gary Wong <qi...@gmail.com>.
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) <johnugeo@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 <qi...@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 <qi...@gmail.com>
> wrote:
> >
> >> Great! Thanks Debo :)
> >>
> >> Very truly yours
> >> Gary
> >>
> >>
> >> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <dd...@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 <qi...@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 <
> ddutta@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 <
> phunt@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 <
> garyw@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/asf/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~
> >>>
> >>
> >>
> >
>
>
>
Re: Apache Mnemonic Releasing
Posted by "Johnu George (johnugeo)" <jo...@cisco.com>.
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 <qi...@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 <qi...@gmail.com> wrote:
>
>> Great! Thanks Debo :)
>>
>> Very truly yours
>> Gary
>>
>>
>> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <dd...@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 <qi...@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 <dd...@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/asf/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~
>>>
>>
>>
>
Re: Apache Mnemonic Releasing
Posted by Patrick Hunt <ph...@apache.org>.
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 to
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 <qi...@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 <qi...@gmail.com> wrote:
>
>> Great! Thanks Debo :)
>>
>> Very truly yours
>> Gary
>>
>>
>> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <dd...@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 <qi...@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 <dd...@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/asf/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~
>>>
>>
>>
>
Re: Apache Mnemonic Releasing
Posted by Gary Wong <qi...@gmail.com>.
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 <qi...@gmail.com> wrote:
> Great! Thanks Debo :)
>
> Very truly yours
> Gary
>
>
> On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <dd...@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 <qi...@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 <dd...@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/asf/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~
>>
>
>
Re: Apache Mnemonic Releasing
Posted by Gary Wong <qi...@gmail.com>.
Great! Thanks Debo :)
Very truly yours
Gary
On Wed, May 31, 2017 at 5:36 PM, Debojyoti Dutta <dd...@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 <qi...@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 <dd...@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/asf/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~
>