[incubator-openwhisk] branch master updated: Move version information to pureconfig and remove `whisk_version_name`. (#3617)

2018-06-25 Thread markusthoemmes 
This is an automated email from the ASF dual-hosted git repository.

markusthoemmes pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-openwhisk.git


The following commit(s) were added to refs/heads/master by this push:
 new 7897a3c  Move version information to pureconfig and remove 
`whisk_version_name`. (#3617)
7897a3c is described below

commit 7897a3cfb70e76509b61543fb13d8c81490ff113
Author: Christian Bickel 
AuthorDate: Mon Jun 25 13:44:04 2018 +0200

Move version information to pureconfig and remove `whisk_version_name`. 
(#3617)
---
 ansible/environments/distributed/group_vars/all|  4 ++-
 ansible/environments/docker-machine/group_vars/all |  3 +-
 ansible/environments/local/group_vars/all  |  1 -
 ansible/environments/vagrant/group_vars/all|  1 -
 ansible/group_vars/all |  9 -
 ansible/logs.yml   |  2 +-
 ansible/roles/controller/tasks/deploy.yml  |  5 ++-
 ansible/roles/invoker/tasks/deploy.yml | 16 -
 ansible/templates/whisk.properties.j2  |  4 +--
 .../src/main/scala/whisk/core/WhiskConfig.scala|  5 +--
 .../scala/whisk/core/controller/RestAPIs.scala | 41 +-
 .../scala/actionContainers/ActionContainer.scala   |  2 +-
 12 files changed, 44 insertions(+), 49 deletions(-)

diff --git a/ansible/environments/distributed/group_vars/all 
b/ansible/environments/distributed/group_vars/all
index 99e4441..2056dec 100755
--- a/ansible/environments/distributed/group_vars/all
+++ b/ansible/environments/distributed/group_vars/all
@@ -2,6 +2,9 @@
 # license agreements; and to You under the Apache License, Version 2.0.
 
 ---
+
+environment_type: "distributed"
+
 db_provider: CouchDB
 db_port: 5984
 db_protocol: http
@@ -10,7 +13,6 @@ db_password: couch_password
 db_host: "{{ groups['db'] | first }}"
 db_prefix: whisk_distributed_
 
-whisk_version_name: distributed
 config_root_dir: /tmp/wskconf
 whisk_logs_dir: /tmp/wsklogs
 registry_storage_dir: "/"
diff --git a/ansible/environments/docker-machine/group_vars/all 
b/ansible/environments/docker-machine/group_vars/all
index e3193ad..91471c8 100644
--- a/ansible/environments/docker-machine/group_vars/all
+++ b/ansible/environments/docker-machine/group_vars/all
@@ -1,13 +1,14 @@
 # Licensed to the Apache Software Foundation (ASF) under one or more 
contributor
 # license agreements; and to You under the Apache License, Version 2.0.
 
-whisk_version_name: mac
 config_root_dir: /Users/Shared/wskconf
 whisk_logs_dir: /Users/Shared/wsklogs
 docker_registry: ""
 docker_dns: ""
 runtimes_bypass_pull_for_local_images: true
 
+environment_type: "docker-machine"
+
 env_hosts_dir: "{{ playbook_dir }}/environments/docker-machine"
 
 # The whisk_api_localhost_name is used to configure nginx to permit vanity 
URLs for web actions.
diff --git a/ansible/environments/local/group_vars/all 
b/ansible/environments/local/group_vars/all
index d1bad6b..338e10a 100755
--- a/ansible/environments/local/group_vars/all
+++ b/ansible/environments/local/group_vars/all
@@ -1,7 +1,6 @@
 # Licensed to the Apache Software Foundation (ASF) under one or more 
contributor
 # license agreements; and to You under the Apache License, Version 2.0.
 
-whisk_version_name: local
 openwhisk_tmp_dir: "{{ lookup('env', 'OPENWHISK_TMP_DIR')|default('/tmp', 
true) }}"
 config_root_dir: "{{ openwhisk_tmp_dir }}/wskconf"
 whisk_logs_dir: "{{ openwhisk_tmp_dir }}/wsklogs"
diff --git a/ansible/environments/vagrant/group_vars/all 
b/ansible/environments/vagrant/group_vars/all
index a5da10d..614e0e2 100755
--- a/ansible/environments/vagrant/group_vars/all
+++ b/ansible/environments/vagrant/group_vars/all
@@ -1,7 +1,6 @@
 # Licensed to the Apache Software Foundation (ASF) under one or more 
contributor
 # license agreements; and to You under the Apache License, Version 2.0.
 
-whisk_version_name: local
 openwhisk_tmp_dir: "{{ lookup('env', 'OPENWHISK_TMP_DIR')|default('/tmp', 
true) }}"
 config_root_dir: "{{ openwhisk_tmp_dir }}/wskconf"
 whisk_logs_dir: "{{ openwhisk_tmp_dir }}/wsklogs"
diff --git a/ansible/group_vars/all b/ansible/group_vars/all
index f4ceacb..b59aa3b 100644
--- a/ansible/group_vars/all
+++ b/ansible/group_vars/all
@@ -22,7 +22,14 @@ exclude_logs_from: []
 #   whisk_api_localhost_name_default (last)
 whisk_api_localhost_name_default: "localhost"
 
-hosts_dir: "{{ inventory_dir | default(env_hosts_dir) }}"
+# Type of your environment.
+# If you want to deploy everything on your local machine use 'local'.
+# If you use a docker-machine on a mac use 'docker-machine'
+# If you want to deploy Openwhisk to other machines use 'distributed'
+environmentInformation:
+  type: "{{ environment_type | default('local') }}"
+
+hosts_dir: "{{ inventory_dir | default(env_hosts_dir) }}"
 
 whisk:
   version:
diff --git a/ansible/logs.yml b/ansible/logs.yml
index 3858438..73a84fa 100644
--- a/ansible/logs.yml
+++ b/ansi

[incubator-openwhisk] branch master updated: Bump gradle and scoverage version (#3802)

2018-06-25 Thread chetanm 
This is an automated email from the ASF dual-hosted git repository.

chetanm pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-openwhisk.git


The following commit(s) were added to refs/heads/master by this push:
 new 76dadd2  Bump gradle and scoverage version (#3802)
76dadd2 is described below

commit 76dadd247812af45e636a67ba96df5fc5f25890e
Author: Markus Thömmes 
AuthorDate: Mon Jun 25 14:00:43 2018 +0200

Bump gradle and scoverage version (#3802)

Switch to Gradle version 4.8.1 and adapt build scripts to use 
`gradle.projectsEvaluated`  instead of `afterEvaluate`.

Also bump the following plugin versions

- gradle-scoverage - 2.1.0 -> 2.3.0
- com.gradle.build-scan - 1.12.1 -> 1.14
---
 build.gradle |   4 ++--
 gradle/wrapper/gradle-wrapper.jar| Bin 54708 -> 54417 bytes
 gradle/wrapper/gradle-wrapper.properties |   2 +-
 tests/build.gradle   |  16 +---
 4 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build.gradle b/build.gradle
index ee49762..47069ef 100644
--- a/build.gradle
+++ b/build.gradle
@@ -21,12 +21,12 @@ buildscript {
 }
 dependencies {
 classpath "cz.alenkacz:gradle-scalafmt:${gradle.scalafmt.version}"
-classpath 'org.scoverage:gradle-scoverage:2.1.0'
+classpath 'org.scoverage:gradle-scoverage:2.3.0'
 }
 }
 
 plugins {
-id "com.gradle.build-scan" version "1.12.1"
+id "com.gradle.build-scan" version "1.14"
 }
 
 buildScan {
diff --git a/gradle/wrapper/gradle-wrapper.jar 
b/gradle/wrapper/gradle-wrapper.jar
index 7a3265e..758de96 100644
Binary files a/gradle/wrapper/gradle-wrapper.jar and 
b/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/gradle/wrapper/gradle-wrapper.properties 
b/gradle/wrapper/gradle-wrapper.properties
index d7cc33f..0178d89 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,6 +3,6 @@
 
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-4.8.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-bin.zip
diff --git a/tests/build.gradle b/tests/build.gradle
index 266dc31..50847fc 100644
--- a/tests/build.gradle
+++ b/tests/build.gradle
@@ -169,8 +169,13 @@ task createKeystore(dependsOn: deleteKeystore) {
 }
 }
 
-afterEvaluate {
-task testCoverageLean(type:Test) {
+tasks.withType(Test) {
+dependsOn createKeystore
+}
+createKeystore.mustRunAfter(testClasses)
+
+gradle.projectsEvaluated {
+task testCoverageLean(type: Test) {
 doFirst {
 logTestSetInfo()
 }
@@ -179,12 +184,9 @@ afterEvaluate {
 include getPattern(testSetName, "includes")
 }
 
-task testCoverage(type:Test) {
+task testCoverage(type: Test) {
 classpath = getScoverageClasspath(project)
 }
-tasks.withType(Test) {
-dependsOn createKeystore
-}
 }
 
 /**
@@ -228,7 +230,7 @@ def getScoverageClasspath(Project project) {
 ':core:controller',
 ':core:invoker'
 ]
-def combinedClasspath = projectNames.inject(project.files([])){result, 
name ->
+def combinedClasspath = projectNames.inject(project.files([])) { result, 
name ->
 result + project.project(name).sourceSets.scoverage.runtimeClasspath
 }

[incubator-openwhisk-release] branch master updated: Add the installation instruction to 0.9.0 release (#205)

2018-06-25 Thread houshengbo 
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 087870e  Add the installation instruction to 0.9.0 release (#205)
087870e is described below

commit 087870e31179527a3c3e6267a304b4e7612e414d
Author: Vincent 
AuthorDate: Mon Jun 25 17:08:30 2018 -0400

Add the installation instruction to 0.9.0 release (#205)

* Add the installation instruction to 0.9.0 release

This PR adds the instruction of installtion for release 0.9.0,
adds the bin directory back to the released package, and picks up
new commit for release 0.9.0.

* Add the example to configure the CLI and add -i to run the CLI
---
 releases/0.9.0-incubating/INSTALL.md | 195 +++
 tools/config.json|   2 +-
 tools/package_source_code.sh |   7 +-
 3 files changed, 202 insertions(+), 2 deletions(-)

diff --git a/releases/0.9.0-incubating/INSTALL.md 
b/releases/0.9.0-incubating/INSTALL.md
new file mode 100644
index 000..540d48e
--- /dev/null
+++ b/releases/0.9.0-incubating/INSTALL.md
@@ -0,0 +1,195 @@
+
+
+# Download OpenWhisk
+
+The source code of OpenWhisk can be accessed by [this 
link](https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/).
+You are currently releasing the version 0.9.0, and the artifact of OpenWhisk 
source code is called "openwhisk-0.9.0-incubating-sources.tar.gz".
+
+
+# Verify the Apache license header of OpenWhisk
+
+OpenWhisk uses a tool called openwhisk-utilities to check the license header 
of each source code file. Please check the
+tutorial [here](https://github.com/apache/incubator-openwhisk-utilities) about 
how to run it on the directory level.
+
+
+# Verify the MD5 & SHA-512 checksums, and signature
+
+You need to install gpg on your local machine.
+
+For Ubuntu user, run the following command:
+
+```
+$ sudo apt-get install gnupg
+```
+
+For Mac user, run the following command:
+
+```
+$ brew install gpg
+```
+
+The public key used to verify the checksums can be found 
[here](https://dist.apache.org/repos/dist/dev/incubator/openwhisk/KEYS). After
+download it, you need to import it on your local machine. 
+
+```
+$ gpg --import 
+```
+
+The parameter  is the file, where the public key is saved.
+
+
+To generate the MD5 checksum:
+
+```
+$ gpg --print-md MD5 
+```
+
+The parameter  is the file of the artifact 
"openwhisk-0.9.0-incubating-sources.tar.gz". Compare the content with the [MD5 
file](https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-0.9.0-incubating-sources.tar.gz.md5).
+
+
+To generate the SHA512 checksum:
+
+```
+$ gpg --print-md SHA512 
+```
+
+The parameter  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/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-0.9.0-incubating-sources.tar.gz.sha512).
+
+Download the 
[signature](https://dist.apache.org/repos/dist/dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/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
+```
+
+
+# Installation of OpenWhisk 0.9.0
+
+This instruction walks you through the steps to install OpenWhisk 0.9.0. We 
support both Ubuntu and Mac operating systems.
+Please download the source code package of OpenWhisk 
"openwhisk-0.9.0-incubating-sources.tar.gz" and unzip it, then you
+get a directory called "incubator-openwhisk" on your local machine.
+
+
+## Prerequisites
+
+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",
+and run the script "all.sh" under tools//ubuntu-setup:
+
+```
+$ cd incubator-openwhisk
+$ ./tools/ubuntu-setup/all.sh
+```
+
+Then, you need to add the permission for the current Ubuntu user in Docker:
+
+```
+$ sudo usermod -a -G docker $USER
+```
+
+If you are a Mac user, please run the following script:
+
+```
+echo '
+# install homebrew
+/usr/bin/ruby -e "$(curl -fsSL 
https://raw.githubusercontent.com/Homebrew/install/master/install)"
+# install cask
+brew tap caskroom/cask
+# install for finding alternative versions (java8)
+brew tap caskroom/versions
+# install java 8
+brew cask install java8
+# install scala
+brew install scala
+# install pip
+sudo easy_install pip
+# install script prerequisites
+sudo -H pip install docker==2.2.1 ansible==2.5.2 jinja2==2.9.6 couchdb==1.1 
httplib2==0.9.2 requests==2.10.0' | bash
+```
+
+Then, activate docker0 network with the following command:
+
+```
+$ sudo ifconfig lo0 alias 172.17.0.1/24
+```
+

svn commit: r27724 - in /dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1: ./ doc/

2018-06-25 Thread houshengbo 
Author: houshengbo
Date: Mon Jun 25 21:11:29 2018
New Revision: 27724

Log:
Staging Apache OpenWhisk release 0.9.0-incubating-rc1.

Added:
dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/doc/
dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/doc/INSTALL.md
Modified:

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-apigateway-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-apigateway-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-apigateway-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-apigateway-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-catalog-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-catalog-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-catalog-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-catalog-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-cli-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-cli-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-cli-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-cli-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-client-go-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-client-go-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-deploy-kube-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-deploy-kube-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-deploy-kube-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-deploy-kube-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-docker-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-docker-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-docker-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-docker-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-java-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-java-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-java-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-java-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-nodejs-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-nodejs-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-nodejs-0.9.0-incubating-sources.tar.gz.md5

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-nodejs-0.9.0-incubating-sources.tar.gz.sha512

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-php-0.9.0-incubating-sources.tar.gz

dev/incubator/openwhisk/apache-openwhisk-0.9.0-incubating-rc1/openwhisk-runtime-php-0.9.0-incubating-sources.tar.gz.asc

dev/incubator/openwhisk/apache-openw

[incubator-openwhisk] branch master updated: add a doc for securing actions (#3801)

2018-06-25 Thread csantanapr 
This is an automated email from the ASF dual-hosted git repository.

csantanapr pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-openwhisk.git


The following commit(s) were added to refs/heads/master by this push:
 new adf3ba1  add a doc for securing actions  (#3801)
adf3ba1 is described below

commit adf3ba1b2cb76d2b4eb09eff3f360bf14bd65623
Author: rodric rabbah 
AuthorDate: Mon Jun 25 19:02:55 2018 -0400

add a doc for securing actions  (#3801)

* Updates to actions doc to remove redundant list of action runtimes, other 
cleanup. Add link to securing actions.

* Fix typo.
---
 docs/actions.md  | 34 +++---
 docs/security.md | 37 +
 2 files changed, 56 insertions(+), 15 deletions(-)

diff --git a/docs/actions.md b/docs/actions.md
index c7fbd99..3a9867f 100644
--- a/docs/actions.md
+++ b/docs/actions.md
@@ -19,23 +19,22 @@
 
 # Creating and invoking OpenWhisk actions
 
+Actions are stateless functions that run on the OpenWhisk platform. For 
example, an action can
+be used to detect the faces in an image, respond to a database change, respond 
to an API call,
+or post a Tweet. In general, an action is invoked in response to an event and 
produces some
+observable output.
 
-Actions are stateless code snippets that run on the OpenWhisk platform.
-For example, an action can be used to detect the faces in an image, respond to 
a database change,
-aggregate a set of API calls, or post a Tweet.
-An action can be written as a JavaScript, Swift, Python or PHP function, a 
Java method,
-any binary-compatible executable including Go programs and custom executables 
packaged as Docker containers.
+An action may be created from a function programmed using a number of 
supported languages, or
+from a binary-compatible executable, or even executables packaged as Docker 
containers.
 
-Actions can be explicitly invoked, or run in response to an event.
-In either case, each run of an action results in an activation record that is 
identified by a unique activation ID.
-The input to an action and the result of an action are a dictionary of 
key-value pairs, where the key is a string and the value a valid JSON value.
-Actions can also be composed of calls to other actions or a defined sequence 
of actions.
+_Prerequisite:_ The OpenWhisk CLI 
[`wsk`](https://github.com/apache/incubator-openwhisk-cli/releases)
+makes it easy to create and invoke actions. Instructions for configuring the 
CLI are available [here](???).
 
-## Prerequisites
-
-You will need to use OpenWhisk CLI. Read how to use it when running OpenWhisk 
from a VM 
[here](https://github.com/apache/incubator-openwhisk/blob/master/tools/vagrant/README.md#using-cli-from-outside-the-vm).
 Or download binaries for your platform 
[here](https://github.com/apache/incubator-openwhisk-cli/releases). You can 
also download the CLI directly from your local installation at the 
_https:///cli/go/download/_ path.
-
-Learn how to create, invoke, and debug actions in your preferred development 
environment:
+Click on the language of your choice below to learn how to create and invoke 
an action using OpenWhisk for
+that language. If your preferred language isn't supported directly, you may 
find the
+[native binary](#creating-native-actions) or 
[Docker](#creating-docker-actions) action path more suitable.
+Multiple actions may be composed together to create a longer processing 
pipeline called a
+[sequence](#creating-action-sequences).
 
 * [JavaScript](#creating-and-invoking-javascript-actions)
 * [Swift](#creating-swift-actions)
@@ -46,13 +45,18 @@ Learn how to create, invoke, and debug actions in your 
preferred development env
 * [Go](#creating-go-actions)
 * [Native binaries](#creating-native-actions)
 
-In addition, learn about:
+Each invocation of an action results in an activation record that is 
identified by a unique
+activation ID. The input to an action and the result of an action are a 
dictionary of key-value
+pairs, where the key is a string and the value a valid JSON value.
+
+In addition, we recommend that you review the following topics:
 
 * [Watching action output](#watching-action-output)
 * [Getting actions](#getting-actions)
 * [Listing actions](#listing-actions)
 * [Deleting actions](#deleting-actions)
 * [Accessing action metadata within the action 
body](#accessing-action-metadata-within-the-action-body)
+* [Securing your action](./security.md)
 
 ## Creating and invoking JavaScript actions
 
diff --git a/docs/security.md b/docs/security.md
new file mode 100644
index 000..b8a87df
--- /dev/null
+++ b/docs/security.md
@@ -0,0 +1,37 @@
+
+
+# Securing your actions
+
+The actions that you create will run in a sandboxed environment, namely a 
container. The code that you
+write nonetheless should follow best practices to ensure that the code is 
reasonably secure against remote
+code exploits and malicious inputs. You sho

[incubator-openwhisk-devtools] branch master updated: docker-compose.yml requires docker engine 1.13+ (#135)

2018-06-25 Thread dragos 
This is an automated email from the ASF dual-hosted git repository.

dragos pushed a commit to branch master
in repository 
https://gitbox.apache.org/repos/asf/incubator-openwhisk-devtools.git


The following commit(s) were added to refs/heads/master by this push:
 new 309ab2a  docker-compose.yml requires docker engine 1.13+ (#135)
309ab2a is described below

commit 309ab2af2cb93e169cafc06452d9a4e796047455
Author: Pavel Kravchenko 
AuthorDate: Tue Jun 26 02:49:11 2018 +0300

docker-compose.yml requires docker engine 1.13+ (#135)

yml version '3' requires docker engine 1.13+
---
 docker-compose/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker-compose/README.md b/docker-compose/README.md
index 6b7a179..7b4481e 100644
--- a/docker-compose/README.md
+++ b/docker-compose/README.md
@@ -12,7 +12,7 @@ The following are required to build and deploy OpenWhisk with 
Docker Compose:
 - [Docker for Mac](https://www.docker.com/docker-mac) - only this 
currently works on Mac OSX
   + Install via homebrew: `brew cask install docker`
 - Other Systems:
-- [Docker 1.12+](https://www.docker.com/products/docker)
+- [Docker 1.13+](https://www.docker.com/products/docker)
 - [Docker Compose 1.6+](https://docs.docker.com/compose/install/)
 - [Java 8](http://www.oracle.com/technetwork/java/javase/downloads/index.html)