openwhisk-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rab...@apache.org
Subject [incubator-openwhisk] branch master updated: Add Ruby 2.5 actions (#3725)
Date Mon, 30 Jul 2018 19:26:49 GMT
This is an automated email from the ASF dual-hosted git repository.

rabbah 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 35cf728  Add Ruby 2.5 actions (#3725)
35cf728 is described below

commit 35cf728ca125ea8c6183de43e3ee078b157ea2a5
Author: Kei Sawada <rimuru@lunanet.gr.jp>
AuthorDate: Tue Jul 31 04:26:46 2018 +0900

    Add Ruby 2.5 actions (#3725)
---
 ansible/files/runtimes.json                        | 12 +++
 .../src/main/resources/apiv1swagger.json           | 10 ++-
 docs/actions-ruby.md                               | 87 ++++++++++++++++++++++
 docs/actions.md                                    |  1 +
 docs/parameters.md                                 |  3 +-
 tests/dat/actions/unicode.tests/ruby-2.5.txt       |  8 ++
 6 files changed, 116 insertions(+), 5 deletions(-)

diff --git a/ansible/files/runtimes.json b/ansible/files/runtimes.json
index 03f8096..4efd814 100644
--- a/ansible/files/runtimes.json
+++ b/ansible/files/runtimes.json
@@ -142,6 +142,18 @@
                     "tag": "latest"
                 }
             }
+        ],
+        "ruby": [
+            {
+                "kind": "ruby:2.5",
+                "default": true,
+                "deprecated": false,
+                "image": {
+                    "prefix": "openwhisk",
+                    "name": "action-ruby-v2.5",
+                    "tag": "latest"
+                }
+            }
         ]
     },
     "blackboxes": [
diff --git a/core/controller/src/main/resources/apiv1swagger.json b/core/controller/src/main/resources/apiv1swagger.json
index bc07b96..80eefbb 100644
--- a/core/controller/src/main/resources/apiv1swagger.json
+++ b/core/controller/src/main/resources/apiv1swagger.json
@@ -1495,15 +1495,17 @@
                 "kind": {
                     "type": "string",
                     "enum": [
+                        "blackbox",
+                        "java",
                         "nodejs:6",
                         "nodejs:8",
-                        "python:2",
-                        "python:3",
                         "php:7.1",
                         "php:7.2",
+                        "python:2",
+                        "python:3",
+                        "ruby:2.5",
                         "swift:3.1.1",
-                        "java",
-                        "blackbox"
+                        "swift:4.1"
                     ],
                     "description": "the type of action"
                 },
diff --git a/docs/actions-ruby.md b/docs/actions-ruby.md
new file mode 100644
index 0000000..540592a
--- /dev/null
+++ b/docs/actions-ruby.md
@@ -0,0 +1,87 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Creating and invoking Ruby actions
+
+The process of creating Ruby actions is similar to that of [other actions](actions.md#the-basics).
+The following sections guide you through creating and invoking a single Ruby action,
+and demonstrate how to bundle multiple Ruby files and third party dependencies.
+
+Ruby actions are executed using Ruby 2.5. To use this runtime, specify the `wsk` CLI parameter
+`--kind ruby:2.5` when creating or updating an action. This is the default when creating
an action
+with file that has a `.rb` extension.
+
+An action is simply a top-level Ruby method. For example, create a file called `hello.rb`
+with the following source code:
+
+```ruby
+def main(args)
+  name = args["name"] || "stranger"
+  greeting = "Hello #{name}!"
+  print greeting
+  { "greeting" => greeting }
+end
+```
+
+Ruby actions always consume a Hash and return a Hash.
+The entry method for the action is `main` by default but may be specified explicitly
+when creating the action with the `wsk` CLI using `--main`, as with any other action type.
+
+You can create an OpenWhisk action called `hello_ruby` from this function as follows:
+
+```
+wsk action create hello_ruby hello.rb
+```
+
+The CLI automatically infers the type of the action from the source file extension.
+For `.rb` source files, the action runs using a Ruby 2.5 runtime.
+
+Action invocation is the same for Ruby actions as it is for [any other action](actions.md#the-basics).
+
+```
+wsk action invoke --result hello_ruby --param name World
+```
+
+```json
+{
+  "greeting": "Hello World!"
+}
+```
+
+Find out more about parameters in the [Working with parameters](./parameters.md) section.
+
+## Packaging Ruby actions in zip files
+
+You can package a Ruby action along with other files and dependent packages in a zip file.
+The filename of the source file containing the entry point (e.g., `main`) must be `main.rb`.
+For example, to create an action that includes a second file called `helper.rb`,
+first create an archive containing your source files:
+
+```bash
+zip -r hello_ruby.zip main.rb helper.rb
+```
+
+and then create the action:
+
+```bash
+wsk action create hello_ruby --kind ruby:2.5 hello_ruby.zip
+```
+
+A few Ruby gems such as `mechanize` and `jwt` are available in addition to the default and
bundled gems.
+You can use arbitrary gems so long as you use zipped actions to package all the dependencies.
diff --git a/docs/actions.md b/docs/actions.md
index 8f69813..9954911 100644
--- a/docs/actions.md
+++ b/docs/actions.md
@@ -58,6 +58,7 @@ paths more suitable. Or, you can [create a new runtime](actions-new.md).
 * [JavaScript](actions-node.md)
 * [PHP](actions-php.md)
 * [Python](actions-python.md)
+* [Ruby](actions-ruby.md)
 * [Swift](actions-swift.md)
 * [Docker and native binaries](actions-docker.md)
 
diff --git a/docs/parameters.md b/docs/parameters.md
index 03d3a3f..19945b4 100644
--- a/docs/parameters.md
+++ b/docs/parameters.md
@@ -25,7 +25,8 @@ This page outlines how to configure parameters when deploying packages and
actio
 
 ### Passing parameters to an action at invoke time
 
-Parameters can be passed to the action when it is invoked. These examples use JavaScript
but all the other languages work the same way (see documentation on [Swift actions](./actions.md#creating-swift-actions),
[Python actions](./actions.mdcreating-python-actions), [Java actions](./actions.mdcreating-java-actions),
[PHP actions](./actions.mdcreating-php-actions), [Docker actions](./actions.mdcreating-docker-actions)
or [Go actions](./actions.mdcreating-go-actions) as appropriate for more [...]
+Parameters can be passed to the action when it is invoked. These examples use JavaScript
but all [the other
+languages](actions.md#languages-and-runtimes) work the same way.
 
 1. Use parameters in the action. For example, create 'hello.js' file with the following content:
 
diff --git a/tests/dat/actions/unicode.tests/ruby-2.5.txt b/tests/dat/actions/unicode.tests/ruby-2.5.txt
new file mode 100644
index 0000000..0326ab0
--- /dev/null
+++ b/tests/dat/actions/unicode.tests/ruby-2.5.txt
@@ -0,0 +1,8 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more contributor
+# license agreements; and to You under the Apache License, Version 2.0.
+
+def main(args)
+  str = args["delimiter"] + " ☃ " + args["delimiter"]
+  puts str
+  { "winter" => str }
+end


Mime
View raw message