You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

Every release will be posted onto dist.apache.org, like following as an example:

https://dist.apache.org/repos/dist/dev/incubator/griffin/0.2.0-incubating/

We need to do some verification in our own environment before voting.

Check the filelist

  • incubating in name if an incubating project
  • CHANGES.txt
  • [project]-source-release.zip
  • [project].pom
  • Signature file.
  • Hash files.

DO NOT provide md5 files.

Download source package and unpack

Download griffin-0.2.0-incubating-source-release.zip from the dist page.

Unpack the zip.

Verify signature files

Install gpg (GnuPG).

(I suggest you use C3 machine with ubuntu, which has installed gpg already)

Download KEYS from dist page, and import to your gpg env.

or use the KEYS from zip file.

gpg --import KEYS

trust the KEY "lionel". (If it is signed by another key, you need to trust that key as well)

gpg --edit-key lionel
trust
5
y
quit

Download griffin-0.2.0-incubating-source-release.zip.asc from the dist page.

Verify the signature.

gpg --verify griffin-0.2.0-incubating-source-release.zip.asc griffin-0.2.0-incubating-source-release.zip
 
// do the same thing to download and verify griffin-0.2.0-incubating.pom with griffin-0.2.0-incubating.pom.asc
gpg --verify griffin-0.2.0-incubating.pom.asc griffin-0.2.0-incubating.pom

Verify hash files

Download griffin-0.2.0-incubating-source-release.zip.sha1 from the dist page.

on linux:

for f in *.sha1; do echo "$(cat $f) ${f/.sha1/}"; done | sha1sum -c

on mac:

for f in *.sha1; do echo "$(cat $f)  ${f/.sha1/}"; done | shasum -c

Check the filelist inside

Unzip and change Into the directory, check the files exists:

  • LICENSE
  • NOTICE
  • DISCLAIMER

Check the licenses

mvn apache-rat:check

It should be success.

Source compile

mvn clean install

It should be success. (For npm install, it runs for about 30 minutes on my machine, you can wait or skip it)

Check the third party licenses

Check the licenses of bundled resources.

  • For source release, "bundled" means include the source code of third-party software.
  • For binary release, "bundled" means include source code or depend on third-party software.

Licenses in different categories have different restrictions.

  • Category A: can bundle and can depend on.
  • Category B: can depend on, the package can be bunded in binary release, but can NOT be bundled the source code in source release.
  • Category X: can NOT bundle source code or package, can NOT depend on.
Category A
• Can bundle and can depend on
• Don’t add any restrictions above and beyond what the Apache License 2.0 does
• Common licenses include:
Apache License 2.0, Apache License 1.1, 2 or 3 clause BSD (without advertising clause), MIT/X11, W3C, Unicode, CC copyright only, WTF public license
 
Category B
• Can’t include in source release
• Contain some restriction of use
• By using binary form limits chance of corruption
• Common license include:
Common Development and Distribution License (CDDL), Eclipse Public License (EPL), Mozilla Public License (MPL), Creative Common Attribution (CC-A)
 
Category X
• Can’t depend on
• Can’t bundle
• A few exceptions for build tools
• Or optional dependancies
• Common Category X include:
 GPL, LGPL, CC non commercial, JSON, BSD 4 clause, Apache 1.0?

For service and measure module, you can also get the third party licenses conveniently by running this:

mvn license:add-third-party

It will generate two files showing third party licenses (Might miss some information):

  • service/target/generated-sources/license/THIRD-PARTY.txt
  • measure/target/generated-sources/license/THIRD-PARTY.txt

For ui module, you have to check them manually.


After all the steps above pass, you can be confident to vote +1.

If any problem, you can vote -1 with the reasons.


Some more references: https://events.static.linuxfound.org/sites/events/files/slides/Incubator_ApacheConUS2017.pdf

https://www.apache.org/dev/release-distribution#sigs-and-sums

http://www.apache.org/dev/licensing-howto.html#permissive-deps

http://www.apache.org/dev/licensing-howto.html#guiding-principle

  • No labels