Deploying a Connector Proxy as an AWS Lambda Function

This guide shows you how to deploy the demo Connector Proxy as an AWS Lambda Function and integrate it with SpiffArena. We will use the Getting Started Guide as the basis for integration, but the steps should easily map to any custom installation.

It is assumed that you have access to log in to the AWS Console and can create/deploy Lambda functions.

Building the Zip

One method of deploying a Lambda function is by uploading a zip file containing the source code or executable. Run the following command in the root of this repository:

make zip

This will create a zip file containing the lambda entry point function and all the dependencies needed to execute the connectors. For this example, the libraries spiffworkflow-proxy for discovering connectors and connector-http, an example connector that provides HTTP get and post requests, are used.

Once make zip completes, connector_proxy_lambda_demo.zip will be available in the repository root.

Creating the Lambda Function

Log in to the AWS Console and navigate to the Lambda section.

From there, choose Create function.

Opt for Author from scratch and select the most recent Python runtime.

Under Advanced Settings, check Enable function URL. For this demo, we will use the NONE auth type to keep things simple.

After clicking the Create function button, you will be taken to your new Lambda function:

In the bottom right of the first section is a link to your Lambda’s function URL. Click it for a hello world response.

Deploying the Lambda Function

If you scroll down, you will see a section with the example code created with your Lambda function. We are going to replace this with the contents of our zip file. Choose Upload from and select .zip file.

After a confirmation dialog, you will see that your lambda has been updated:

Click your function URL again to see a greeting from our deployed Connector Proxy.

Integrating With SpiffArena

Congratulations, your Connector Proxy has been deployed as a Lambda function. For information on configuring SpiffArena to use the new Connector Proxy URL, please see Configure a Connector Proxy.