You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwhisk.apache.org by ho...@apache.org on 2018/08/17 14:55:31 UTC
svn commit: r28807 - in
/release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating: ./ doc/
Author: houshengbo
Date: Fri Aug 17 14:55:31 2018
New Revision: 28807
Log:
Updating Apache OpenWhisk release 0.9.0-incubating.
Added:
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz (with props)
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.asc
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.sha512
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz (with props)
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.asc
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.sha512
Modified:
release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/doc/INSTALL.md
Modified: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/doc/INSTALL.md
==============================================================================
--- release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/doc/INSTALL.md (original)
+++ release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/doc/INSTALL.md Fri Aug 17 14:55:31 2018
@@ -19,11 +19,27 @@
# Download OpenWhisk
-The OpenWhisk source code may be downloaded from https://dist.apache.org/repos/dist/release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating. The current release is version 0.9.0, and the artifact for this OpenWhisk source code release is called `"openwhisk-0.9.0-incubating-sources.tar.gz"`.
+The current release of OpenWhisk is version 0.9.0, which consists of multiple modules.
+
+The source code of OpenWhisk main module may be downloaded at [this link](http://www.apache.org/dyn/closer.lua?filename=incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz&action=download). The artifact for this main module is called `"openwhisk-0.9.0-incubating-sources.tar.gz"`.
+
+```
+# download from your terminal with wget
+wget http://apache.mirrors.ionfish.org/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz
+```
+
+The source code of OpenWhisk Client Go may be downloaded at [this link](https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-client-go-0.9.0-incubating-sources.tar.gz). The artifact for this main module is called `"openwhisk-0.9.0-incubating-sources.tar.gz"`.
+
+```
+# download from your terminal with wget
+wget https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-client-go-0.9.0-incubating-sources.tar.gz
+```
+
+The source code of OpenWhisk CLI may be downloaded at [this link](https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-cli-0.9.0-incubating-sources.tar.gz). The artifact for this main module is called `"openwhisk-0.9.0-incubating-sources.tar.gz"`.
```
# download from your terminal with wget
-wget https://dist.apache.org/repos/dist/release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz
+wget https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-cli-0.9.0-incubating-sources.tar.gz
```
# Verify the SHA-512 checksums, and signature
@@ -42,7 +58,7 @@ You need to install `gpg` on your local
Before using `gpg` to verify the OpenWhisk release integrity, you should [verify `gpg`'s own integrity](https://gnupg.org/download/integrity_check.html).
-The public key used to verify the OpenWhisk checksums can be found [here](https://dist.apache.org/repos/dist/release/incubator/openwhisk/KEYS). Download the key and import it on your local machine.
+The public key used to verify the OpenWhisk checksums can be found [here](https://www-us.apache.org/dist/incubator/openwhisk/KEYS). Download the key and import it on your local machine.
```
gpg --import <key_file>
@@ -56,14 +72,18 @@ To generate the SHA512 checksum:
gpg --print-md SHA512 <artifact>
```
-The parameter <artifact> is the file of the artifact `"openwhisk-0.9.0-incubating-sources.tar.gz"`. Compare the content with the [SHA512 file](https://dist.apache.org/repos/dist/release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz.sha512).
+Take the OpenWhisk main module for example, the parameter <artifact> is the file of the artifact `"openwhisk-0.9.0-incubating-sources.tar.gz"`. Compare the content with the [SHA512 file](https://www-us.apache.org/dist/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz.sha512).
-Download the [signature](https://dist.apache.org/repos/dist/release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz.asc), and verify it with the command:
+Download the [signature](https://www-us.apache.org/dist/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-0.9.0-incubating-sources.tar.gz.asc), and verify it with the command:
```
gpg --verify openwhisk-0.9.0-incubating-sources.tar.gz.asc openwhisk-0.9.0-incubating-sources.tar.gz
```
+As you may notice, if each OpenWhisk module is named <artifact>, the naming convention for the SHA512 checksum is <artifact>.sha512 and for the signature is <artifact>.sha512.asc.
+The download link for its SHA512 checksum is https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/<artifact>.sha512
+and for its signature is https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/<artifact>.sha512.asc.
+
You should receive the output messages similar to the following:
```
@@ -88,6 +108,8 @@ You can use the following command to unt
tar -xvzf openwhisk-0.9.0-incubating-sources.tar.gz
```
+You may need to change the name of the artifact based on the module to be unzipped and extracted.
+
# Verify the Apache license header
OpenWhisk uses a tool called [`scanCode`](https://github.com/apache/incubator-openwhisk-utilities/tree/master/scancode) to check the license header of each source file included in the release. Please check the [`scanCode` tutorial](https://github.com/apache/incubator-openwhisk-utilities) for instructions to download and run the tool and scan all code in the release.
@@ -100,7 +122,7 @@ git clone https://github.com/apache/incu
Go to the directory of the OpenWhisk utilities and run the following command:
```
-scancode/scanCode.py --config scancode/ASF-Release.cfg <Path of incubator-openwhisk-0.9.0-incubating>
+scancode/scanCode.py --config scancode/ASF-Release.cfg <Path of incubator-openwhisk-0.9.0-incubating or any other module>
```
All the checks have passed for Apache license header, if you receive the result as below:
@@ -120,6 +142,8 @@ The following instructions walk you thro
We recommend you set the environment variable `$OPENWHISK_HOME` on your local machine to the extracted directory `incubator-openwhisk-0.9.0-incubating`.
It is an _error_ to set `$OPENWHISK_HOME` to an invalid or incorrect path (including an empty string). If you do not wish to use the environment variable, make sure it is not defined in your environment at all. The rest of the instructions assume you have defined this environment variable.
+If you would like to build the CLI locally, set the environment variable `$OPENWHISK_HOME_CLI` on your local machine to the directory `incubator-openwhisk-cli-0.9.0-incubating`.
+
### Ubuntu users
If you are a Ubuntu user, our suggested version is between 14.04 and 16.04. Open a terminal, go to the directory of `"incubator-openwhisk-0.9.0-incubating"`, and run the script `"all.sh"` under `tools/ubuntu-setup`:
@@ -184,6 +208,7 @@ We suggest you restart your local machin
## Build the source code
+### OpenWhisk
Open the terminal, and go to the directory $OPENWHISK_HOME. Install the Gradle wrapper with the command:
```
@@ -201,6 +226,19 @@ Once the build is complete, you will hav
first make sure `docker` is running correctly by verifying with the command `docker images`. If you continue
to encounter build problems, please seek help by opening [an issue](https://github.com/apache/incubator-openwhisk/issues) for the OpenWhisk community to assist you.
+### OpenWhisk Client Go
+
+Please refer to the instruction on how to use OpenWhisk Client Go at [this page](https://github.com/apache/incubator-openwhisk-client-go/blob/master/README.md).
+
+### OpenWhisk CLI
+If you have downloaded the source code of OpenWhisk CLI and decide to use it during the installation of OpenWhisk, run the following commands:
+
+```
+cd $OPENWHISK_HOME_CLI
+gradle wrapper
+./gradlew releaseBinaries
+```
+
## Deploy OpenWhisk
@@ -218,6 +256,19 @@ ansible-playbook -i environments/local p
ansible-playbook -i environments/local apigateway.yml
```
+If you would like to use the CLI from your local build, please run the following command for the playbook of openwhisk.yml:
+
+```
+ansible-playbook -i environments/local openwhisk.yml -e cli_installation_mode=local -e openwhisk_cli_home=$OPENWHISK_HOME_CLI
+```
+
+instead of
+
+```
+ansible-playbook -i environments/local openwhisk.yml
+```
+
+
### Troubleshooting
There are several know issues you may encounter:
Added: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz
==============================================================================
Binary file - no diff available.
Propchange: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.asc
==============================================================================
--- release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.asc (added)
+++ release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.asc Fri Aug 17 14:55:31 2018
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1
+
+iQIcBAABAgAGBQJbZKTFAAoJEHKvDMIsTPMgRGIP/1pu3UT5m39pFtKJKA24Q+1h
+t8iOc4pzXtST5Wrr5XiUSuCmUKUEyEacmJ1nbJUUGhlW4lQbeZ6Iqk+8tgL4m9iL
+qYdx54ESICqpTQ/88Fqdt3XWEK2g9i6mb3A8FHEweN3IXuyOMUQHM5/BjvZ9gW5e
+/Vz8lW+GFWp2NFmjMuo3mnE+ul5fUbtIt6/yjynI+oK2+o0icjEs9vXV+vtOoMWI
+tl7bwfEVZsZZ5G9qLoH4fK73WtIvW4xkEnQCjK4eDZ7eeU4zQWvkdHR/oROt5+rD
+qlYyrp3ZCNFPFCHulW6PJ+YL/qSLQhbg5ox5HQGL9r5nb/eTiTlYJ7QLBpCj2DoF
+U4KgoDNQTMvWnrENnIk2uJeTC6pKDDjRKOqbgJ9vUVNkYBrPJSqDuhRJf3zZUcex
+yJyvk5245b4YQSXEWjoif59Cy/RVguET6xUS9YFGxxLmghiKTO45y98K+mydb7Kf
+4UDljxOAuy/qEcZoxN3bm6E6uJa9WqtewidiFVWm55fecMxCFPmKyfnRHo2ytspw
+6UU/TB7NX0EIr/rFN3bHEFdDVsz8szZz34mFyFnLHD5r1iKv4GYOMUXqVrQdbI7B
+iaTncYmCPDe8x5KMob0jPC29ZcIaSSFG1KR+4SjsrOK0Daf91jVfgfkNU8KlG6hW
+Ep3Qe2DL7myYCV/ZiG3y
+=pQ5I
+-----END PGP SIGNATURE-----
Added: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.sha512
==============================================================================
--- release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.sha512 (added)
+++ release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-cli-0.9.0-incubating-sources.tar.gz.sha512 Fri Aug 17 14:55:31 2018
@@ -0,0 +1,3 @@
+openwhisk-cli-0.9.0-incubating-sources.tar.gz:
+F033568C 40286D74 CF6B6C5C 26470988 AD560DFA 39C1E521 34F96FF9 9FB86022 5CB6700B
+ 2862D2C8 35D5C407 F18F3AD0 5B0E26B8 F5178A0E 734C5EAE 763AEB18
Added: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz
==============================================================================
Binary file - no diff available.
Propchange: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.asc
==============================================================================
--- release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.asc (added)
+++ release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.asc Fri Aug 17 14:55:31 2018
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1
+
+iQIcBAABAgAGBQJbZKTFAAoJEHKvDMIsTPMg0ScP/3iCPndCYHUSuZMNj9kn1R4v
+YKYkJnIT19ML3+R11Zy5WKiy+dHqikdKrDjhsrC3RD1Fcn2FS75VS8h/scpODA4S
+5WHr+B0jLJ2hENsM8yzQ2QIOz3MFf2wZxUKrdala1AbrBEtvhP2xCUzdBJGW5Llb
+xkAvDMH5Y5tfStQHw8uaB3snEcNs2TDwCp9+KCB/czIi17vvkS0Xycy6/yOclEsM
+L6Lnh04VD2WYfufz5hyvo3Dm/wTvBbYhrE3VjqFQ6t09aDLtbSpniV5hpr89lKEu
+rO267nKkwABzCwCFpYDe/6TkI17L8JXW6PssIG63Hk69B1BFqlKL8QyGtTliJXoK
+8ztFcCGXMrgmVG5Vtgv+7IsZu9b1gD4xLuUDhdwCL+eqSKXoAbcxxAeGcX5VKaf7
+sPBGnHTofBkfybTQPk4VEUGB4ZWws7Isxf64svudojPSOkreQLMQQ7yxpQ+wNgLe
+8leh0LOWA2sfmja51i/L5VesEJYBLdwr5AvnmMSIxBoz8bd0L2BzTSkwL1UtX9kd
+TTjq5yZFfJ+/eE5voMpONb1NZwq1QJsljtJ/KozfBRS4C50qVVZh6rkX4pralw50
+Z2rNd0CjVBRpzVaKWDHKBXPu6B+diqTouKvAGR2EoqwPccPMl9R4BaHQ1ce6myuP
+zWNo3qk4jN92Apz0zQZY
+=FRJ2
+-----END PGP SIGNATURE-----
Added: release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.sha512
==============================================================================
--- release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.sha512 (added)
+++ release/incubator/openwhisk/apache-openwhisk-0.9.0-incubating/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.sha512 Fri Aug 17 14:55:31 2018
@@ -0,0 +1,3 @@
+openwhisk-client-go-0.9.0-incubating-sources.tar.gz:
+D5A69445 EF0082D7 B57FBDA4 13DCB591 0E06372F 0F308D2C 8FA49A80 F99FBF13 6E299EBC
+ CCF3722C 832492C4 215FB107 657EB521 0B72A364 9366F7CF 682DCA87