openwhisk-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From houshen...@apache.org
Subject [incubator-openwhisk-release] branch master updated: Release the modules client go and cli for 0.9.0 (#225)
Date Tue, 31 Jul 2018 22:07:19 GMT
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 <shou@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


Mime
View raw message