README.md

Browse the Repo

.circleci

_docs

examples

api-gateway-account-settings

lambda-build

lambda-dead-letter-queue

lambda-edge

nodejs

README.md

main.tf

outputs.tf

vars.tf

lambda-keep-warm

lambda-s3-deployment-package

lambda-s3

lambda-service

lambda-vpc

scheduled-lambda-job

modules

test

.gitignore

.pre-commit-config.yaml

CODEOWNERS

LICENSE.txt

README.md

owners.txt

terraform-cloud-enterprise-private-module-...

Browse the Repo

.circleci

_docs

examples

api-gateway-account-settings

lambda-build

lambda-dead-letter-queue

lambda-edge

nodejs

README.md

main.tf

outputs.tf

vars.tf

lambda-keep-warm

lambda-s3-deployment-package

lambda-s3

lambda-service

lambda-vpc

scheduled-lambda-job

modules

test

.gitignore

.pre-commit-config.yaml

CODEOWNERS

LICENSE.txt

README.md

owners.txt

terraform-cloud-enterprise-private-module-...

AWS Lambda

Deploy Lambda functions with Terraform. Supports uploading deployment packages, configuring environment variables, and scheduled functions.

Lambda@Edge example

This folder shows an example of how to use the lambda-edge module to create a Lambda function that logs incoming requests.

How do you deploy this example?

To apply the Terraform templates:

Install Terraform.
Open vars.tf, set the environment variables specified at the top of the file, and fill in any other variables that don't have a default.
Run terraform get.
Run terraform plan.
If the plan looks good, run terraform apply.

We do not yet have the CloudFront trigger automated, so once the example is deployed, you'll have to configure the trigger manually.

How do you test the Lambda function?

There are two ways to test the Lambda function once it's deployed:

Test in AWS
Test locally

Test in AWS

Open up the AWS Console UI, find the function, click the "Test" button, and enter test data that looks something like this (full format available in the Lambda@Edge Event Structure documentation):

{
  "Records": [
    {
      "cf": {
        "config": {
          "distributionId": "EDFDVBD6EXAMPLE",
          "requestId": "MRVMF7KydIvxMWfJIglgwHQwZsbG2IhRJ07sn9AkKUFSHS9EXAMPLE=="
        },
        "request": {
          "clientIp": "2001:0db8:85a3:0:0:8a2e:0370:7334",
          "querystring": "size=large",
          "uri": "/picture.jpg",
          "method": "GET",
          "headers": {
            "host": [
              {
                "key": "Host",
                "value": "d111111abcdef8.cloudfront.net"
              }
            ],
            "user-agent": [
              {
                "key": "User-Agent",
                "value": "curl/7.51.0"
              }
            ]
          },
          "origin": {
            "custom": {
              "customHeaders": {
                "my-origin-custom-header": [
                  {
                    "key": "My-Origin-Custom-Header",
                    "value": "Test"
                  }
                ]
              },
              "domainName": "example.com",
              "keepaliveTimeout": 5,
              "path": "/custom_path",
              "port": 443,
              "protocol": "https",
              "readTimeout": 5,
              "sslProtocols": [
                "TLSv1",
                "TLSv1.1"
              ]
            },
            "s3": {
              "authMethod": "origin-access-identity",
              "customHeaders": {
                "my-origin-custom-header": [
                  {
                    "key": "My-Origin-Custom-Header",
                    "value": "Test"
                  }
                ]
              },
              "domainName": "my-bucket.s3.amazonaws.com",
              "path": "/s3_path",
              "region": "us-east-1"
            }
          }
        }
      }
    }
  ]
}

Click "Save and test" and AWS will show you the log output and returned value in the browser.

Test locally

The code you write for a Lambda function is just regular code with a well-defined entrypoint (the "handler"), so you can also run it locally by calling that entrypoint. There are multiple frameworks for local testing NodeJS Lambda functions, including:

Questions? Ask away.

We're here to talk about our services, answer any questions, give advice, or just to chat.

Ready to hand off the Gruntwork?

Buy Now

"https://cdn.gruntwork.io/gruntwork-website/"

{"index":{"js":"https://cdn.gruntwork.io/gruntwork-website/index.bundle.c7884255553b53fbca3a.js","map":"https://cdn.gruntwork.io/gruntwork-website/index.bundle.1b14c1b7d19f1f5eb35d6e118e838255.map"},"styles":{"css":"https://cdn.gruntwork.io/gruntwork-website/styles.bundle.f22938926651ddec7c49.css","js":"https://cdn.gruntwork.io/gruntwork-website/styles.bundle.e782420e74a20dcb8691.js","map":"https://cdn.gruntwork.io/gruntwork-website/styles.bundle.d5e2af49807c6ca33f8367d621ece507.map"},"vendors":{"css":"https://cdn.gruntwork.io/gruntwork-website/vendors.bundle.29f7d0366a0978763f96.css","js":"https://cdn.gruntwork.io/gruntwork-website/vendors.bundle.fa8174a130797d75d12c.js","map":"https://cdn.gruntwork.io/gruntwork-website/vendors.bundle.57243d94deeeb29d5061288a338b4eb6.map"}}

AWS Lambda

Code Preview

Preview the Code

Lambda@Edge example

How do you deploy this example?

How do you test the Lambda function?

Test in AWS

Test locally

Questions? Ask away.

Ready to hand off the Gruntwork?