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/07/31 22:07:19 UTC
[incubator-openwhisk-release] branch master updated: Release the
modules client go and cli for 0.9.0 (#225)
This is an automated email from the ASF dual-hosted git repository.
houshengbo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-openwhisk-release.git
The following commit(s) were added to refs/heads/master by this push:
new cf61800 Release the modules client go and cli for 0.9.0 (#225)
cf61800 is described below
commit cf61800baaa1ef3587cf6d4b0ab7afcb75013180
Author: Vincent <sh...@us.ibm.com>
AuthorDate: Tue Jul 31 18:07:17 2018 -0400
Release the modules client go and cli for 0.9.0 (#225)
This PR picked up the commit IDs for client go and cli modules
and updated the installation guide.
---
releases/0.9.0-incubating/INSTALL.md | 51 +++++++++++++++++++++++++++++++++---
tools/config.json | 16 +++++++----
tools/download_source_code.sh | 1 +
3 files changed, 60 insertions(+), 8 deletions(-)
diff --git a/releases/0.9.0-incubating/INSTALL.md b/releases/0.9.0-incubating/INSTALL.md
index 3282abd..b20c1dc 100644
--- a/releases/0.9.0-incubating/INSTALL.md
+++ b/releases/0.9.0-incubating/INSTALL.md
@@ -19,13 +19,29 @@
# Download OpenWhisk
-The OpenWhisk source code may be downloaded from [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 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/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
You need to install `gpg` on your local machine.
@@ -56,7 +72,7 @@ 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://www-us.apache.org/dist/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://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:
@@ -64,6 +80,10 @@ Download the [signature](https://www-us.apache.org/dist/incubator/openwhisk/apac
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 untar the package:
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/incubator-openwhisk-utilities.git
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 through the steps to build OpenWhisk 0.9.0 f
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`:
@@ -201,6 +225,14 @@ Once the build is complete, you will have Docker images necessary to run OpenWhi
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.
+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 +250,19 @@ ansible-playbook -i environments/local postdeploy.yml
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:
diff --git a/tools/config.json b/tools/config.json
index 84c8bd6..2d6b526 100644
--- a/tools/config.json
+++ b/tools/config.json
@@ -5,14 +5,20 @@
"release_url": "https://dist.apache.org/repos/dist/release/incubator/openwhisk",
"versioning": {
"version": "0.9.0-incubating",
- "pre_release_version": "rc2"
+ "pre_release_version": "rc1"
},
"RepoList": [
- "openwhisk"
+ "openwhisk-client-go",
+ "openwhisk-cli"
],
- "openwhisk": {
- "hash": "b1476b9",
- "repository": "https://github.com/apache/incubator-openwhisk.git",
+ "openwhisk_client_go": {
+ "hash": "90976ef",
+ "repository": "https://github.com/apache/incubator-openwhisk-client-go.git",
+ "branch": "master"
+ },
+ "openwhisk_cli": {
+ "hash": "4a5a372",
+ "repository": "https://github.com/apache/incubator-openwhisk-cli.git",
"branch": "master"
}
}
diff --git a/tools/download_source_code.sh b/tools/download_source_code.sh
index 532a686..33edb28 100755
--- a/tools/download_source_code.sh
+++ b/tools/download_source_code.sh
@@ -35,6 +35,7 @@ function git_clone_repo() {
}
rm -rf $OPENWHISK_SOURCE_DIR/*
+mkdir -p $OPENWHISK_SOURCE_DIR
for repo in $(echo $repos | sed "s/,/ /g")
do