Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/infraspecdev/terraform-aws-lambda-s3-notification
This terraform modules provides creates needed to invoke a lambda function on s3 bucket notification events
https://github.com/infraspecdev/terraform-aws-lambda-s3-notification
Last synced: 3 days ago
JSON representation
This terraform modules provides creates needed to invoke a lambda function on s3 bucket notification events
- Host: GitHub
- URL: https://github.com/infraspecdev/terraform-aws-lambda-s3-notification
- Owner: infraspecdev
- License: mit
- Created: 2022-08-18T10:36:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-08-31T05:38:24.000Z (over 2 years ago)
- Last Synced: 2024-11-08T09:28:38.063Z (about 2 months ago)
- Language: HCL
- Size: 26.4 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# terraform-aws-lambda-s3-notification
This terraform modules provides creates needed to invoke a lambda function on s3 bucket notification events.
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.2.0 |
| [aws](#requirement\_aws) | ~> 4.16 |
## Providers
| Name | Version |
|------|---------|
| [aws](#provider\_aws) | ~> 4.16 |
## Modules
No modules.
## Resources
| Name | Type |
|------|------|
| [aws_cloudwatch_log_group.lambda_s3](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_log_group) | resource |
| [aws_iam_role.iam_for_lambda](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role) | resource |
| [aws_iam_role_policy.logs](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role_policy) | resource |
| [aws_iam_role_policy_attachment.lambda_policy](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role_policy_attachment) | resource |
| [aws_lambda_function.lambda_s3](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lambda_function) | resource |
| [aws_lambda_function_event_invoke_config.lambda_s3_invoke_config](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lambda_function_event_invoke_config) | resource |
| [aws_lambda_permission.allow_s3_invoke_lambda](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lambda_permission) | resource |
| [aws_s3_bucket_notification.push_to_lambda](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_notification) | resource |
| [aws_region.current](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/region) | data source |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [bucket\_filter\_prefix](#input\_bucket\_filter\_prefix) | Optional prefix to limit the notifications to objects with keys that start with matching characters | `string` | `""` | no |
| [bucket\_filter\_suffix](#input\_bucket\_filter\_suffix) | Optional suffix to limit the notifications to objects with keys that end with matching characters | `string` | `""` | no |
| [bucket\_names](#input\_bucket\_names) | List of S3 bucket names to create Event Notifications for. | `list(string)` | n/a | yes |
| [directory\_path](#input\_directory\_path) | The path to the directory containing the zip file that will be executed by lambda. Defaults to current directory. | `string` | `"."` | no |
| [env\_vars](#input\_env\_vars) | A map of env vars to be passed to lambda function | `map(string)` | `{}` | no |
| [environment](#input\_environment) | This is the environment in which the load balancer will be running | `string` | n/a | yes |
| [file\_name](#input\_file\_name) | This is the name of the zip file that contains binary to be executed by the lambda | `string` | n/a | yes |
| [lambda\_execution\_policy\_arn](#input\_lambda\_execution\_policy\_arn) | The managed policy arn for lambda, for more info: https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html#permissions-executionrole-features | `string` | `"arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"` | no |
| [lambda\_timeout](#input\_lambda\_timeout) | Amount of time your Lambda Function has to run in seconds | `number` | `120` | no |
## Outputs
| Name | Description |
|------|-------------|
| [aws\_iam\_role\_arn](#output\_aws\_iam\_role\_arn) | The ARN of the IAM Role created for the lambda function |
| [aws\_lambda\_function\_arn](#output\_aws\_lambda\_function\_arn) | The ARN of the Lambda Function created |
## Pre-requisite for PR
### Set up pre-commit
```shell
brew install pre-commit
brew install terraform-docs
brew install tflint
pre-commit install
#to run hooks against all files for first time after setup
pre-commit run --all-files
```
TF docs will be populated as part of pre-commit hook, you would need to commit the changes.
For further information on pre-commit, visit [this](https://pre-commit.com/#intro).
For further information on pre-commit-terraform, visit [this](https://github.com/antonbabenko/pre-commit-terraform).