Skip to content

npalm/terraform-aws-lambda-github-app

Repository files navigation

Terraform module for AWS lambda to receive GitHub App events

This module creates the required infra to handle events of GitHub app via a Lambda connected to API Gateway V2.

The module will create by default an API Gateway with a route on webhook for HTTP Post. Requests sent to this webhook will be sent to the lambda. The example lambda will check the GitHub secret.

Usages

To create a lambda and API gateway endpoint.

module "lambda-github-app" {
  source = "npalm/lambda-github-app/aws"

  environment = "test"
  labmda_config = {
    filename = "lambda.zip"
    handler  = "index.handler"
    runtime  = "nodejs12.x"
    variables = {
      GITHUB_APP_WEBHOOK_SECRET = "my-secret"
    }
  }
}

Examples

  • default : Example that will create the lambda based on provided config and a zip file.
  • provided- : Example that will let you create the lambda resource and pass the resource to the module. The module will create the API gateway for you.

Prerequisite:

  • Terraform 0.12.x
  • Docker for building the example lambda
  • Amazon account for deployment
  • GitHub account for creating an app

Usages

# build the lambda
cd examples/lambda-nodejs-ts
./build.sh

## create infra
cd ../default
terraform init
terraform apply

Terraform will output the webhook endpoint and secret for the GitHub. Go to https://github.com/settings/apps and create your app.

Requirements

No requirements.

Providers

Name Version
aws n/a

Inputs

Name Description Type Default Required
environment Name of the environment will be used to name resources unique. string n/a yes
create_lambda Let the module create the lambda, provide the config for the lambda via lambda_config. bool true no
labmda_config Configuration for the lambda. Only required if create_lambda is set to true.
object({
filename = string
handler = string
runtime = string
variables = map(string)
})
null no
lambda Provide your own lambda resource. Only required if create_lambda is set to false. any null no
tags Map of tags that will be added to created resources. By default resources will be tagged with name and environment. map(string) {} no

Outputs

Name Description
gateway n/a

Requirements

Name Version
terraform ~> 0.12
aws ~> 2.50

Providers

Name Version
aws ~> 2.50

Inputs

Name Description Type Default Required
environment Name of the environment will be used to name resources unique. string n/a yes
create_lambda Let the module create the lambda, provide the config for the lambda via lambda_config. bool true no
labmda_config Configuration for the lambda. Only required if create_lambda is set to true.
object({
filename = string
handler = string
runtime = string
variables = map(string)
})
null no
lambda Provide your own lambda resource. Only required if create_lambda is set to false. any null no
tags Map of tags that will be added to created resources. By default resources will be tagged with name and environment. map(string) {} no

Outputs

Name Description
gateway n/a

Requirements

Name Version
terraform ~> 0.12
aws ~> 2.50

Providers

Name Version
aws ~> 2.50

Inputs

Name Description Type Default Required
environment Name of the environment will be used to name resources unique. string n/a yes
create_lambda Let the module create the lambda, provide the config for the lambda via lambda_config. bool true no
labmda_config Configuration for the lambda. Only required if create_lambda is set to true.
object({
filename = string
handler = string
runtime = string
variables = map(string)
})
null no
lambda Provide your own lambda resource. Only required if create_lambda is set to false. any null no
tags Map of tags that will be added to created resources. By default resources will be tagged with name and environment. map(string) {} no

Outputs

Name Description
gateway n/a

About

Terraform module for GitHub App Lambda webhook

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages