Merge pull request #572 from jonee/master

Rust examples for OpenWhisk and AWS

Author: eahefnawy

README.md

@@ -114,6 +114,7 @@ serverless install -u https://github.com/serverless/examples/tree/master/folder-
 | [Serverless Telegram Bot](https://github.com/serverless/examples/tree/master/aws-python-telegram-bot) <br/> This example demonstrates how to setup an echo Telegram Bot using the Serverless Framework ⚡🤖  | python |
 | [Aws Ruby Line Bot](https://github.com/serverless/examples/tree/master/aws-ruby-line-bot) <br/> Example demonstrates how to setup a simple Line echo bot on AWS | ruby |
 | [Aws Ruby Simple Http Endpoint](https://github.com/serverless/examples/tree/master/aws-ruby-simple-http-endpoint) <br/> Example demonstrates how to setup a simple HTTP GET endpoint | ruby |
+| [Aws Rust Simple Http Endpoint](https://github.com/serverless/examples/tree/master/aws-rust-simple-http-endpoint) <br/> Example demonstrates how to setup a simple HTTP GET endpoint with rust | nodeJS |
 | [Azure Nodejs](https://github.com/serverless/examples/tree/master/azure-node-line-bot) <br/> Azure Functions sample for the Serverless framework | nodeJS |
 | [Azure Node Simple Http Endpoint](https://github.com/serverless/examples/tree/master/azure-node-simple-http-endpoint) <br/> An example of making http endpoints with the Azure Functions Serverless Framework plugin | nodeJS |
 | [Azure Nodejs](https://github.com/serverless/examples/tree/master/azure-node-telegram-bot) <br/> Azure Functions sample for the Serverless framework | nodeJS |
@@ -135,6 +136,7 @@ serverless install -u https://github.com/serverless/examples/tree/master/folder-
 | [Openwhisk Python Simple Http Endpoint](https://github.com/serverless/examples/tree/master/openwhisk-python-simple-http-endpoint) <br/> Example demonstrates how to setup a simple HTTP GET endpoint with OpenWhisk. | python |
 | [Openwhisk Python Simple](https://github.com/serverless/examples/tree/master/openwhisk-python-simple) <br/> Example demonstrates how to setup a simple Python function with OpenWhisk. | python |
 | [Openwhisk Ruby Simple](https://github.com/serverless/examples/tree/master/openwhisk-ruby-simple) <br/> Example demonstrates how to setup a simple Ruby function with OpenWhisk. | ruby |
+| [Openwhisk Rust Simple Http Endpoint](https://github.com/serverless/examples/tree/master/openwhisk-rust-simple-http-endpoint) <br/> Example demonstrates how to setup a simple Rust function with OpenWhisk. | nodeJS |
 | [Openwhisk Swift Package With Precompiled Binaries](https://github.com/serverless/examples/tree/master/openwhisk-swift-precompiled-binaries) <br/> Swift packages and pre-compiled binaries on OpenWhisk. | swift |
 | [Openwhisk Swift Scheduled Cron](https://github.com/serverless/examples/tree/master/openwhisk-swift-scheduled-cron) <br/> Example of creating a Swift function that runs as a cron job using the serverless schedule event. | swift |
 | [Openwhisk Swift Simple Http Endpoint](https://github.com/serverless/examples/tree/master/openwhisk-swift-simple-http-endpoint) <br/> Example demonstrates how to setup a simple HTTP endpoint using Swift function with OpenWhisk. | swift |

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

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

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

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

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

@@ -0,0 +1,53 @@
+<!--
+title: 'AWS Serverless Boilerplate example in Rust'
+description: 'This example shows a Serverless boilerplate in Rust.'
+layout: Doc
+framework: v1+
+platform: AWS
+language: Rust
+authorLink: 'https://github.com/jonee'
+authorName: 'Jonee Ryan Ty'
+authorAvatar:
+-->
+
+# Serverless Boilerplate - AWS - Rust
+
+Make sure `serverless` is installed. [See installation guide](https://serverless.com/framework/docs/providers/AWS/guide/installation/).
+
+You will also need to set up your AWS account credentials using environment variables or a configuration file. Please see the [this guide for more information](https://serverless.com/framework/docs/providers/AWS/guide/credentials/).
+
+## 1. Install Project Dependencies
+`npm install` in this directory to download the modules from `package.json`.
+
+## 2. Compile Rust Binary
+
+```
+$ cargo build --release
+```
+
+## 3. Deploy
+
+Hackish way to deploy
+
+1. Run `sls deploy` which would give an error about missing file path in the package path. 
+2. If you look at .serverless it should have 3 files- 
+
+cloudformation-template-create-stack.json
+cloudformation-template-update-stack.json
+serverless-state.json
+
+3. rename .serverless folder to p
+4. cargo build --release then add aws-rust-simple-http-endpoint.zip which consists of target/release/test only to the p folder
+5. sls deploy --package p
+
+
+
+
+## 4. Invoke deployed function
+
+```bash
+$ curl https://***.execute-api.us-east-1.amazonaws.com/dev/test/test
+{"message":"Serverless Rust Hello"}
+```
+
+**For more information on the Serverless AWS plugin, please see the project repository: [https://serverless.com/framework/docs/providers/AWS/guide/credentials/](https://serverless.com/framework/docs/providers/AWS/guide/credentials/).**

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

@@ -0,0 +1,9 @@
+{
+  "name": "aws-rust-simple-http-endpoint",
+  "version": "0.0.1",
+  "description": "Example demonstrates how to setup a simple HTTP GET endpoint with rust",
+  "author": "Jonee Ryan Ty",
+  "devDependencies": {
+    "serverless-rust": "^0.3.8"
+  }
+}

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

@@ -0,0 +1,38 @@
+service: aws-rust-simple-http-endpoint
+
+#frameworkVersion: ">=1.28.0 <2.0.0"
+
+provider:
+  name: aws
+  runtime: rust
+  # memorySize: 128
+  # stage: api # we attach the stage ie dev or prod in the path
+  region: us-east-1 # make sure your region is correct
+
+package:
+#  individually: true # creates one artifact for each function
+  exclude:
+    - ./**
+  include:
+    - ./target/release/test
+
+plugins:
+  - serverless-rust
+
+functions:
+  test_test:
+    handler: test
+    events:
+      - http:
+          path: test/test
+          method: get
+
+custom:
+  # this section allows for customization of the default
+  # serverless-rust plugin settings
+  rust:
+    # flags passed to cargo
+#    cargoFlags: '--features enable-awesome'
+    # experimental! when set to true, artifacts are built locally outside of docker
+    dockerless: true
+

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

@@ -0,0 +1,10 @@
+[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"

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

@@ -0,0 +1,43 @@
+
+use lambda_http::{handler, lambda, IntoResponse, Request, Context};
+use serde_json::json;
+
+type Error = Box<dyn std::error::Error + Sync + Send + 'static>;
+
+#[tokio::main]
+async fn main() -> Result<(), Error> {
+    lambda::run(handler(test)).await?;
+    Ok(())
+}
+
+
+async fn test(_: Request, _: Context) -> Result<impl IntoResponse, Error> {
+	
+	
+    // `serde_json::Values` impl `IntoResponse` by default
+    // creating an application/json response
+    Ok(json!({
+        "message": "Serverless Rust Hello"
+    }))
+}
+
+/*
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[tokio::test]
+    async fn test_handles() {
+        let request = Request::default();
+        let expected = json!({
+        "message": "Serverless Rust Hello"
+        })
+        .into_response();
+        let response = test(request, Context::default())
+            .await
+            .expect("expected Ok(_) value")
+            .into_response();
+        assert_eq!(response.body(), expected.body())
+    }
+}
+*/

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"]