Revamp Function as a Service BBEs

examples/aws-lambda-dynamodb-trigger/aws-lambda-dynamodb-trigger.bal

@@ -0,0 +1,8 @@
+import ballerina/io;
+import ballerinax/awslambda;
+
+@awslambda:Function
+public function dynamoDBTrigger(awslambda:Context ctx,
+        awslambda:DynamoDBEvent event) {
+    io:println(event.Records[0].dynamodb.Keys.toString());
+}

examples/aws-lambda-dynamodb-trigger/aws-lambda-dynamodb-trigger.md

@@ -0,0 +1,46 @@
+# AWS Lambda DynamoDB trigger
+
+This example creates a function, which will be executed for each entry added to a database in the DynamoDB.
+
+For more information, see the [AWS Lambda learn guide](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/).
+
+## Set up the prerequisites
+
+For instructions, see [Set up the prerequisites](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/#set-up-the-prerequisites).
+
+## Write the function
+
+Follow the steps below to write the function.
+
+1. Execute the command below to create a new Ballerina package.
+
+::: out bal_new.out :::
+
+2. Replace the content of the generated Ballerina file with the content below.
+
+::: code aws-lambda-dynamodb-trigger.bal :::
+
+## Build the function 
+
+Execute the command below to generate the AWS Lambda artifacts.
+
+::: out bal_build.out :::
+
+## Deploy the function
+
+Execute the AWS CLI command given by the compiler to create and publish the functions by replacing the respective AWS `$LAMBDA_ROLE_ARN`, `$REGION_ID`, and `$FUNCTION_NAME` values given in the command with your values.
+
+::: out aws_deploy.out :::
+
+## Invoke the function
+
+Follow the instructions below to create a DynamoDB table for invoking this function.
+
+1. Navigate to [**roles**](https://console.aws.amazon.com/iamv2/home#/roles), and add `AWSLambdaDynamoDBExecutionRole` to the role you created in [Set up the prerequisites](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/#set-up-the-prerequisites).
+2. Go to [DynamoDB](https://us-west-1.console.aws.amazon.com/dynamodbv2).
+3. Click **Create Table**, enter the table name and partition key, and create the table (if you already have a table created, you can skip this step).
+4. Click on the DynamoDB table you created, and then click the **Exports and streams** tab.
+5. Click **enable DynamoDB stream details**, and select the key attributes only for the event type.
+6. Once it is enabled, click **Create a trigger**, select the `dynamoDBTrigger` from the dropdown, and create a trigger.
+7. Go to [**Items**](https://us-west-1.console.aws.amazon.com/dynamodbv2) in the DynamoDB, select the table, and click **Create item** to add an entry to the DynamoDB table to invoke the Lambda function.
+8. Go to the AWS Lambda function and check the logs via CloudWatch to see the object identifier in the logs.

examples/aws-lambda-dynamodb-trigger/aws-lambda-dynamodb-trigger.metatags

@@ -0,0 +1,2 @@
+description: This example creates a function, which will be executed for each entry added to a database in the DynamoDB.
+keywords:  ballerina, ballerina by example, aws lambda, dynamodb, serverless, cloud, function as a service

examples/aws-lambda-dynamodb-trigger/aws_deploy.out

@@ -0,0 +1 @@
+$ aws lambda create-function --function-name dynamoDBTrigger --zip-file fileb://aws-ballerina-lambda-functions.zip --handler aws-lambda-dynamodb-trigger.dynamoDBTrigger --runtime provided --role arn:aws:iam::908363916111:role/lambda-role--layers arn:aws:lambda:us-west-1:134633749276:layer:ballerina-jre11:6 --memory-size 512 --timeout 10

examples/aws-lambda-dynamodb-trigger/bal_build.out

@@ -0,0 +1,12 @@
+$ bal build
+Compiling source
+        wso2/aws-lambda-dynamodb-trigger:0.1.0
+
+Generating executable
+        @awslambda:Function: dynamoDBTrigger
+
+        Run the following command to deploy each Ballerina AWS Lambda function:
+        aws lambda create-function --function-name $FUNCTION_NAME --zip-file fileb://<project-dir>/aws-lambda-s3-trigger/target/bin/aws-ballerina-lambda-functions.zip --handler aws-lambda-dynamodb-trigger.$FUNCTION_NAME --runtime provided --role $LAMBDA_ROLE_ARN --layers arn:aws:lambda:$REGION_ID:134633749276:layer:ballerina-jre11:6 --memory-size 512 --timeout 10
+
+        Run the following command to re-deploy an updated Ballerina AWS Lambda function:
+        aws lambda update-function-code --function-name $FUNCTION_NAME --zip-file fileb://aws-ballerina-lambda-functions.zip

examples/aws-lambda-dynamodb-trigger/bal_new.out

@@ -0,0 +1 @@
+$ bal new aws-lambda-dynamodb-trigger

examples/aws-lambda-execution-context/aws-lambda-execution-context.bal

@@ -0,0 +1,12 @@
+import ballerinax/awslambda;
+
+@awslambda:Function
+public function ctxinfo(awslambda:Context ctx, json input) returns json|error {
+    return {
+        RequestID: ctx.getRequestId(),
+        DeadlineMS: ctx.getDeadlineMs(),
+        InvokedFunctionArn: ctx.getInvokedFunctionArn(),
+        TraceID: ctx.getTraceId(),
+        RemainingExecTime: ctx.getRemainingExecutionTime()
+    };
+}

examples/aws-lambda-execution-context/aws-lambda-execution-context.md

@@ -0,0 +1,39 @@
+# AWS Lambda execution context
+
+The example below demonstrates how the execution context information of an AWS function can be retrieved.
+
+For more information, see the [AWS Lambda learn guide](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/).
+
+## Set up the prerequisites
+
+For instructions, see [Set up the prerequisites](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/#set-up-the-prerequisites).
+
+## Write the function
+
+Follow the steps below to write the function.
+
+1. Execute the command below to create a new Ballerina package.
+
+::: out bal_new.out :::
+
+2. Replace the content of the generated Ballerina file with the content below.
+
+::: code aws-lambda-execution-context.bal :::
+
+## Build the function
+
+Execute the command below to generate the AWS Lambda artifacts.
+
+::: out bal_build.out :::
+
+## Deploy the function
+
+Execute the AWS CLI command given by the compiler to create and publish the functions by replacing the respective AWS `$LAMBDA_ROLE_ARN`, `$REGION_ID`, and `$FUNCTION_NAME` values given in the command with your values. 
+
+::: out aws_deploy.out :::
+
+## Invoke the function
+
+Execute the commands below to invoke the function.
+
+::: out invoke_functions.out :::

examples/aws-lambda-execution-context/aws-lambda-execution-context.metatags

@@ -0,0 +1,2 @@
+description: The example below demonstrates how the execution context information of an AWS function can be retrieved.
+keywords:  ballerina, ballerina by example, aws lambda, execution context, serverless, cloud, function as a service

examples/aws-lambda-execution-context/aws_deploy.out

@@ -0,0 +1 @@
+$ aws lambda create-function --function-name ctxinfo --zip-file fileb://aws-ballerina-lambda-functions.zip --handler aws-lambda-execution-context.ctxinfo --runtime provided --role arn:aws:iam::908363916111:role/lambda-role --layers arn:aws:lambda:us-west-1:134633749276:layer:ballerina-jre11:6 --memory-size 512 --timeout 10

examples/aws-lambda-execution-context/bal_build.out

@@ -0,0 +1,12 @@
+$ bal build
+Compiling source
+        wso2/aws-lambda-execution-context:0.1.0
+
+Generating executable
+        @awslambda:Function: ctxinfo
+
+        Run the following command to deploy each Ballerina AWS Lambda function:
+        aws lambda create-function --function-name $FUNCTION_NAME --zip-file fileb://<project-dir>/aws-lambda-execution-context/target/bin/aws-ballerina-lambda-functions.zip --handler aws_lambda_deployment.$FUNCTION_NAME --runtime provided --role $LAMBDA_ROLE_ARN --layers arn:aws:lambda:$REGION_ID:134633749276:layer:ballerina-jre11:6 --memory-size 512 --timeout 10
+
+        Run the following command to re-deploy an updated Ballerina AWS Lambda function:
+        aws lambda update-function-code --function-name $FUNCTION_NAME --zip-file fileb://aws-ballerina-lambda-functions.zip

examples/aws-lambda-execution-context/bal_new.out

@@ -0,0 +1 @@
+$ bal new aws-lambda-execution-context

examples/aws-lambda-deployment/invoke_functions.out → examples/aws-lambda-execution-context/invoke_functions.out

@@ -1,12 +1,4 @@
 $ echo '{"MESSAGE":"HELLO"}' > input.json
-$ aws lambda invoke --function-name echo --payload fileb://input.json echo-response.txt
-{
-"ExecutedVersion": "$LATEST",
-"StatusCode": 200
-}
-$ cat echo-response.txt
-{"MESSAGE":"HELLO"}
-
 $ aws lambda invoke --function-name ctxinfo ctxinfo-response.txt
 {
 "ExecutedVersion": "$LATEST",

examples/aws-lambda-hello-world/aws-lambda-hello-world.bal

@@ -0,0 +1,9 @@
+import ballerina/io;
+import ballerinax/awslambda;
+
+// The `@awslambda:Function` annotation marks a function to generate an AWS Lambda function.
+@awslambda:Function
+public function echo(awslambda:Context ctx, json input) returns json {
+    io:println(input.toJsonString());
+    return input;
+}

examples/aws-lambda-hello-world/aws-lambda-hello-world.md

@@ -0,0 +1,39 @@
+# AWS Lambda - Hello world
+
+This example demonstrates how to write a simple echo function in AWS Lambda.
+
+For more information, see the [AWS Lambda learn guide](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/).
+
+## Set up the prerequisites
+
+For instructions, see [Set up the prerequisites](https://ballerina.io/learn/run-in-the-cloud/function-as-a-service/aws-lambda/#set-up-the-prerequisites).
+
+## Write the function
+
+Follow the steps below to write the function.
+
+1. Execute the command below to create a new Ballerina package.
+
+::: out bal_new.out :::
+
+2. Replace the content of the generated Ballerina file with the content below.
+
+::: code aws-lambda-hello-world.bal :::
+
+## Build the function
+
+Execute the command below to generate the AWS Lambda artifacts.
+
+::: out bal_build.out :::
+
+## Deploy the function
+
+Execute the AWS CLI command given by the compiler to create and publish the functions by replacing the respective AWS `$LAMBDA_ROLE_ARN`, `$REGION_ID`, and `$FUNCTION_NAME` values given in the command with your values.
+
+::: out aws_deploy.out :::
+
+## Invoke the function
+
+Execute the commands below to invoke the function.
+
+::: out invoke_functions.out :::

examples/aws-lambda-hello-world/aws-lambda-hello-world.metatags

@@ -0,0 +1,2 @@
+description: This example demonstrates how to write a simple echo function in AWS Lambda.
+keywords:  ballerina, ballerina by example, serverless, aws lambda, cloud, function as a service

examples/aws-lambda-hello-world/aws_deploy.out

@@ -0,0 +1 @@
+$ aws lambda create-function --function-name echo --zip-file fileb://aws-ballerina-lambda-functions.zip --handler aws-lambda-hello-world.echo --runtime provided --role arn:aws:iam::908363916111:role/lambda-role--layers arn:aws:lambda:us-west-1:134633749276:layer:ballerina-jre11:6 --memory-size 512 --timeout 10

examples/aws-lambda-hello-world/bal_build.out

@@ -0,0 +1,12 @@
+$ bal build
+Compiling source
+        wso2/aws-lambda-hello-world:0.1.0
+
+Generating executable
+        @awslambda:Function: echo
+
+        Run the following command to deploy each Ballerina AWS Lambda function:
+        aws lambda create-function --function-name $FUNCTION_NAME --zip-file fileb://<project-dir>/aws-lambda-hello-world/target/bin/aws-ballerina-lambda-functions.zip --handler aws-lambda-hello-world.$FUNCTION_NAME --runtime provided --role $LAMBDA_ROLE_ARN --layers arn:aws:lambda:$REGION_ID:134633749276:layer:ballerina-jre11:6 --memory-size 512 --timeout 10
+
+        Run the following command to re-deploy an updated Ballerina AWS Lambda function:
+        aws lambda update-function-code --function-name $FUNCTION_NAME --zip-file fileb://aws-ballerina-lambda-functions.zip

examples/aws-lambda-hello-world/bal_new.out

@@ -0,0 +1 @@
+$ bal new aws-lambda-hello-world

examples/aws-lambda-hello-world/invoke_functions.out

@@ -0,0 +1,8 @@
+$ echo '{"MESSAGE":"HELLO"}' > input.json
+$ aws lambda invoke --function-name echo --payload fileb://input.json echo-response.txt
+{
+"ExecutedVersion": "$LATEST",
+"StatusCode": 200
+}
+$ cat echo-response.txt
+{"MESSAGE":"HELLO"}

examples/aws-lambda-s3-trigger/aws-lambda-s3-trigger.bal

@@ -0,0 +1,8 @@
+import ballerina/io;
+import ballerinax/awslambda;
+
+@awslambda:Function
+public function s3Trigger(awslambda:Context ctx,
+        awslambda:S3Event event) {
+    io:println(event.Records[0].s3.'object.key);
+}