example openwhisk-rust-simple-http-endpoint

Author: jonee

openwhisk-rust-simple-http-endpoint/.gitignore

@@ -0,0 +1,3 @@
+.serverless
+*.pyc
+*.pyo

openwhisk-rust-simple-http-endpoint/Cargo.toml

@@ -0,0 +1,2 @@
+[workspace]
+members = ["test"]

openwhisk-rust-simple-http-endpoint/README.md

@@ -0,0 +1,68 @@
+<!--
+title: 'OpenWhisk Serverless Boilerplate example in Rust'
+description: 'This example shows a Serverless boilerplate in Rust.'
+layout: Doc
+platform: OpenWhisk
+language: Rust
+authorLink: 'https://github.com/jonee'
+authorName: 'Jonee Ryan Ty'
+-->
+# Serverless Boilerplate - OpenWhisk - Rust
+
+(This example is largely based on the openwhisk-go-simple by James Thomas but adapted for Rust)
+
+Make sure `serverless` is installed. [See installation guide](https://serverless.com/framework/docs/providers/openwhisk/guide/installation/).
+
+You will also need to set up your OpenWhisk account credentials using environment variables or a configuration file. Please see the [this guide for more information](https://serverless.com/framework/docs/providers/openwhisk/guide/credentials/).
+
+## 1. Install Project Dependencies
+`npm install` in this directory to download the modules from `package.json`.
+
+## 2. Compile Rust Binary (Statically)
+
+```
+$ cargo build --release --target x86_64-unknown-linux-musl
+```
+
+## 3. Deploy
+`serverless deploy` or `sls deploy`. `sls` is shorthand for the Serverless CLI command
+
+```
+Serverless: Packaging service...
+Serverless: Excluding development dependencies...
+Serverless: Compiling Functions...
+Serverless: Compiling Packages...
+Serverless: Compiling API Gateway definitions...
+Serverless: Compiling Rules...
+Serverless: Compiling Triggers & Feeds...
+Serverless: Compiling Service Bindings...
+Serverless: Deploying Functions...
+Serverless: Deploying API Gateway definitions...
+Serverless: Deployment successful!
+
+
+Service Information
+platform:	us-south.functions.cloud.ibm.com
+namespace:	_
+service:	rust-service
+
+actions:
+rust-service-dev-test_test
+```
+
+## 4. Invoke deployed function
+`serverless invoke --function test_test` or `serverless invoke -f test_test`
+
+`-f` is shorthand for `--function`
+
+In your terminal window you should see the response from Apache OpenWhisk
+
+```bash
+$ serverless invoke -f test_test
+{
+    "message": "Serverless Rust Hello"
+}
+
+```
+
+**For more information on the Serverless OpenWhisk plugin, please see the project repository: [https://serverless.com/framework/docs/providers/openwhisk/guide/credentials/](https://serverless.com/framework/docs/providers/openwhisk/guide/credentials/).**

openwhisk-rust-simple-http-endpoint/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "openwhisk-rust-simple-http-endpoint",
+  "version": "0.1.0",
+  "description": "Example demonstrates how to setup a simple Rust function with OpenWhisk.",
+  "dependencies": {
+    "serverless-openwhisk": ">=0.13.0"
+  }
+}

openwhisk-rust-simple-http-endpoint/serverless.yml

@@ -0,0 +1,27 @@
+service: rust-service
+
+provider:
+  name: openwhisk
+  runtime: binary
+  # memorySize: 128
+  # stage: api # we attach the stage ie dev or prod in the path
+
+package: 
+#  individually: true # creates one artifact for each function
+  exclude:
+    - ./**
+  include:
+    - ./target/x86_64-unknown-linux-musl/release/test
+
+# remember to run npm install to download the provider plugin.
+plugins:
+  - serverless-openwhisk
+
+
+functions:
+  test_test:
+    handler: target/x86_64-unknown-linux-musl/release/test
+    events:
+      - http:
+          path: test/test
+          method: get

openwhisk-rust-simple-http-endpoint/test/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "test"
+version = "0.1.0"
+edition = "2018"
+authors = ["jonee"]
+
+[dependencies]
+tokio = { version = "0.2", features = ["macros"] }
+#lambda_http = { git = "https://github.com/awslabs/aws-lambda-rust-runtime/", branch = "master"}
+serde_json = "1.0"
+rustc-serialize = "0.3"

openwhisk-rust-simple-http-endpoint/test/src/main.rs

@@ -0,0 +1,13 @@
+
+use serde_json::json;
+
+fn main() {
+
+    // creating an application/json response
+    println!("{}", json!({
+        "message": "Serverless Rust Hello"
+    }))
+}
+
+
+