You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by Justin Mclean <ju...@classsoftware.com> on 2018/09/10 00:31:37 UTC
Incubator release checklist
HI,
As part of the workshop I ran recently I had people look at a real release and go though a checklist before voting on it, it my be of some help other people checking releases. I’ve just added a version of it to the incubator wiki. [1] Feedback welcome.
Thanks,
Justin
1. https://wiki.apache.org/incubator/IncubatorReleaseChecklist#preview
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Incubator release checklist
Posted by Julian Hyde <jh...@apache.org>.
Releases are invariably created from a particular commit from the source control system (usually a git commit these days). I think it’s important to check that the contents of the source tarball match the contents of the source control system at that commit. (To do this, I unpack the tar file in one directory, checkout the source tree in another directory, and do a “diff -r” command.) We rely on the source control system for the provenance of the release, but this process is broken if we don’t check that two are in sync.
This process also catches cases where the release manager has accidentally included generated files not under source control.
So, I think this should be added to the check list.
Julian
> On Sep 10, 2018, at 1:31 AM, Pierre Smits <pi...@apache.org> wrote:
>
> Hi,
>
> I regard a wiki as good as an svn or git repo as it also has
> version-control.
>
>
> Best regards,
>
> Pierre Smits
>
> *Apache Trafodion <https://trafodion.apache.org>, Vice President*
> *Apache Directory <https://directory.apache.org>, PMC Member*
> Apache Incubator <https://incubator.apache.org>, committer
> *Apache OFBiz <https://ofbiz.apache.org>, contributor (without privileges)
> since 2008*
> Apache Steve <https://steve.apache.org>, committer
>
> On Mon, Sep 10, 2018 at 10:10 AM, Justin Mclean <ju...@classsoftware.com>
> wrote:
>
>> Hi,
>>
>>> So there are not somewhere in an incubator repo? Only here in the ml?
>>
>> I’m not sure where they would live, if you can find a place please suggest
>> it.
>>
>> Perhaps the wiki would be a better place?
>>
>> Thanks,
>> Justin
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Incubator release checklist
Posted by Dave Fisher <da...@comcast.net>.
Hi -
I like the wiki idea. Under each checkpoint we can offer shell commands that have been useful for various mentors.
As Mentors we should be referring prolongs to this process as well and if they wish to create unique scripts for their products then so much the better.
Here is a checker.sh I use for signatures and hashes:
#!/bin/bash
mv ${1}.asc.txt ${1}.asc
gpg --verify ${1}.asc
shasum -a 256 ${1} ; cat ${1}.sha256.txt
shasum -a 512 ${1} ; cat ${1}.sha512.txt
I download manually, but one could see how to curl too.
Regards,
Dave
> On Sep 10, 2018, at 1:31 AM, Pierre Smits <pi...@apache.org> wrote:
>
> Hi,
>
> I regard a wiki as good as an svn or git repo as it also has
> version-control.
>
>
> Best regards,
>
> Pierre Smits
>
> *Apache Trafodion <https://trafodion.apache.org>, Vice President*
> *Apache Directory <https://directory.apache.org>, PMC Member*
> Apache Incubator <https://incubator.apache.org>, committer
> *Apache OFBiz <https://ofbiz.apache.org>, contributor (without privileges)
> since 2008*
> Apache Steve <https://steve.apache.org>, committer
>
> On Mon, Sep 10, 2018 at 10:10 AM, Justin Mclean <ju...@classsoftware.com>
> wrote:
>
>> Hi,
>>
>>> So there are not somewhere in an incubator repo? Only here in the ml?
>>
>> I’m not sure where they would live, if you can find a place please suggest
>> it.
>>
>> Perhaps the wiki would be a better place?
>>
>> Thanks,
>> Justin
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
Re: Incubator release checklist
Posted by Pierre Smits <pi...@apache.org>.
Hi,
I regard a wiki as good as an svn or git repo as it also has
version-control.
Best regards,
Pierre Smits
*Apache Trafodion <https://trafodion.apache.org>, Vice President*
*Apache Directory <https://directory.apache.org>, PMC Member*
Apache Incubator <https://incubator.apache.org>, committer
*Apache OFBiz <https://ofbiz.apache.org>, contributor (without privileges)
since 2008*
Apache Steve <https://steve.apache.org>, committer
On Mon, Sep 10, 2018 at 10:10 AM, Justin Mclean <ju...@classsoftware.com>
wrote:
> Hi,
>
> > So there are not somewhere in an incubator repo? Only here in the ml?
>
> I’m not sure where they would live, if you can find a place please suggest
> it.
>
> Perhaps the wiki would be a better place?
>
> Thanks,
> Justin
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>
Re: Incubator release checklist
Posted by Justin Mclean <ju...@classsoftware.com>.
Hi,
> So there are not somewhere in an incubator repo? Only here in the ml?
I’m not sure where they would live, if you can find a place please suggest it.
Perhaps the wiki would be a better place?
Thanks,
Justin
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Incubator release checklist
Posted by Pierre Smits <pi...@apache.org>.
So there are not somewhere in an incubator repo? Only here in the ml?
Best regards,
Pierre Smits
*Apache Trafodion <https://trafodion.apache.org>, Vice President*
*Apache Directory <https://directory.apache.org>, PMC Member*
Apache Incubator <https://incubator.apache.org>, committer
*Apache OFBiz <https://ofbiz.apache.org>, contributor (without privileges)
since 2008*
Apache Steve <https://steve.apache.org>, committer
On Mon, Sep 10, 2018 at 9:53 AM, Justin Mclean <ju...@classsoftware.com>
wrote:
> HI,
>
> > Are these kind of check scripts somewhere available to all? It seems to
> me
> > that such a set would benefit many (as in: many hands make light work).
>
> They are now I just posted them here. :-) Feel free to use them if they
> help you.
>
> But I have also shown them in previous incubator talks I’ve given.
>
> They are not that complex and are mostly simple time savers when reviewing
> 100’s of releases like I do, they still require you to recognise and
> interpret the results.
>
> Thanks,
> Justin
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>
Re: Incubator release checklist
Posted by Justin Mclean <ju...@classsoftware.com>.
HI,
> Are these kind of check scripts somewhere available to all? It seems to me
> that such a set would benefit many (as in: many hands make light work).
They are now I just posted them here. :-) Feel free to use them if they help you.
But I have also shown them in previous incubator talks I’ve given.
They are not that complex and are mostly simple time savers when reviewing 100’s of releases like I do, they still require you to recognise and interpret the results.
Thanks,
Justin
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Incubator release checklist
Posted by Pierre Smits <pi...@apache.org>.
Are these kind of check scripts somewhere available to all? It seems to me
that such a set would benefit many (as in: many hands make light work).
Best regards,
Pierre Smits
*Apache Trafodion <https://trafodion.apache.org>, Vice President*
*Apache Directory <https://directory.apache.org>, PMC Member*
Apache Incubator <https://incubator.apache.org>, committer
*Apache OFBiz <https://ofbiz.apache.org>, contributor (without privileges)
since 2008*
Apache Steve <https://steve.apache.org>, committer
On Mon, Sep 10, 2018 at 3:46 AM, Justin Mclean <ju...@classsoftware.com>
wrote:
> Hi,
>
> > Great, some of these are accomplished by one line commands, maybe would
> be
> > good to add those into the checklist as well.
>
> Mostly, but It's going to vary from project to project depending on on the
> build process and technology and a lot of it is manual observation. We
> could possibly come up with a list for Java projects which may be helpful.
>
> I do use some tools / simple scripts to help me and speed up the process
> but they only mostly save me a little typing.
>
> For instance:
>
> function rat() {
> java -Xms1024m -Xmx1024m -jar ~/Downloads/apache-rat-0.11/apache-rat-0.11.jar
> $1
> }
>
> function search() {
> find . -type f -exec grep -i "$1" {} \; -print
> }
>
> function verify() {
> for file in *.asc; do gpg --verify $file; done
> }
>
> function sha512() {
> for arg in $*; do shasum -a 512 $arg; done
> }
>
> function untxt() {
> find . -name '*.txt' | while read f; do mv "$f" "${f/\.txt/}"; done
> }
>
> And I usually do stuff like this on a release:
> grep “ B “ rat.txt | grep -v “\.png” | grep -v ...
> search copyright | sort -u > copy.txt
> search GPL
> search BSD
>
> Thanks,
> Justin
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>
Re: Incubator release checklist
Posted by Justin Mclean <ju...@classsoftware.com>.
Hi,
> Great, some of these are accomplished by one line commands, maybe would be
> good to add those into the checklist as well.
Mostly, but It's going to vary from project to project depending on on the build process and technology and a lot of it is manual observation. We could possibly come up with a list for Java projects which may be helpful.
I do use some tools / simple scripts to help me and speed up the process but they only mostly save me a little typing.
For instance:
function rat() {
java -Xms1024m -Xmx1024m -jar ~/Downloads/apache-rat-0.11/apache-rat-0.11.jar $1
}
function search() {
find . -type f -exec grep -i "$1" {} \; -print
}
function verify() {
for file in *.asc; do gpg --verify $file; done
}
function sha512() {
for arg in $*; do shasum -a 512 $arg; done
}
function untxt() {
find . -name '*.txt' | while read f; do mv "$f" "${f/\.txt/}"; done
}
And I usually do stuff like this on a release:
grep “ B “ rat.txt | grep -v “\.png” | grep -v ...
search copyright | sort -u > copy.txt
search GPL
search BSD
Thanks,
Justin
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Incubator release checklist
Posted by Luciano Resende <lu...@gmail.com>.
On Sun, Sep 9, 2018 at 5:31 PM Justin Mclean <ju...@classsoftware.com>
wrote:
> HI,
>
> As part of the workshop I ran recently I had people look at a real release
> and go though a checklist before voting on it, it my be of some help other
> people checking releases. I’ve just added a version of it to the incubator
> wiki. [1] Feedback welcome.
>
> Thanks,
> Justin
>
> 1. https://wiki.apache.org/incubator/IncubatorReleaseChecklist#preview
> ---------------------------------------------------------------------
>
Great, some of these are accomplished by one line commands, maybe would be
good to add those into the checklist as well.
--
Luciano Resende
http://twitter.com/lresende1975
http://lresende.blogspot.com/
Fwd: Incubator release checklist
Posted by Byung-Gon Chun <bg...@gmail.com>.
A good reference for the release!
-Gon
---------- Forwarded message ----------
From: Justin Mclean <ju...@classsoftware.com>
Date: Mon, Sep 10, 2018 at 9:31 AM
Subject: Incubator release checklist
To: general@incubator.apache.org
HI,
As part of the workshop I ran recently I had people look at a real release
and go though a checklist before voting on it, it my be of some help other
people checking releases. I’ve just added a version of it to the incubator
wiki. [1] Feedback welcome.
Thanks,
Justin
1. https://wiki.apache.org/incubator/IncubatorReleaseChecklist#preview
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
--
Byung-Gon Chun
Re: Incubator release checklist
Posted by 吴晟 Sheng Wu <wu...@foxmail.com>.
Hi Justin
Good checklist, like it.
------------------
Sheng Wu
Apache SkyWalking
------------------ Original ------------------
From: "justin"<ju...@classsoftware.com>;
Date: Mon, Sep 10, 2018 08:31 AM
To: "general"<ge...@incubator.apache.org>;
Subject: Incubator release checklist
HI,
As part of the workshop I ran recently I had people look at a real release and go though a checklist before voting on it, it my be of some help other people checking releases. I’ve just added a version of it to the incubator wiki. [1] Feedback welcome.
Thanks,
Justin
1. https://wiki.apache.org/incubator/IncubatorReleaseChecklist#preview
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org