CCM-10591: Lambda Boilerplate

Author: jamesthompson26-nhs

infrastructure/terraform/components/examplecomponent/README.md

@@ -13,6 +13,7 @@ No requirements.
 | <a name="input_component"></a> [component](#input\_component) | The variable encapsulating the name of this component | `string` | `"examplecomponent"` | no |
 | <a name="input_default_tags"></a> [default\_tags](#input\_default\_tags) | A map of default tags to apply to all taggable resources within the component | `map(string)` | `{}` | no |
 | <a name="input_environment"></a> [environment](#input\_environment) | The name of the tfscaffold environment | `string` | n/a | yes |
+| <a name="input_force_lambda_code_deploy"></a> [force\_lambda\_code\_deploy](#input\_force\_lambda\_code\_deploy) | If the lambda package in s3 has the same commit id tag as the terraform build branch, the lambda will not update automatically. Set to True if making changes to Lambda code from on the same commit for example during development | `bool` | `false` | no |
 | <a name="input_group"></a> [group](#input\_group) | The group variables are being inherited from (often synonmous with account short-name) | `string` | n/a | yes |
 | <a name="input_log_retention_in_days"></a> [log\_retention\_in\_days](#input\_log\_retention\_in\_days) | The retention period in days for the Cloudwatch Logs events to be retained, default of 0 is indefinite | `number` | `0` | no |
 | <a name="input_project"></a> [project](#input\_project) | The name of the tfscaffold project | `string` | n/a | yes |

infrastructure/terraform/components/examplecomponent/module_lambda_example_lambda.tf

@@ -0,0 +1,52 @@
+# module "example_lambda" {
+#   source = "git::https://github.com/NHSDigital/nhs-notify-shared-modules.git//infrastructure/modules/lambda?ref=v2.0.10"
+
+#   function_name = "example-lambda"
+#   description   = "An example lambda function"
+
+#   aws_account_id = var.aws_account_id
+#   component      = var.component
+#   environment    = var.environment
+#   project        = var.project
+#   region         = var.region
+#   group          = var.group
+
+#   log_retention_in_days = var.log_retention_in_days
+#   kms_key_arn           = module.kms.key_arn ## Requires shared kms module
+
+#   iam_policy_document = {
+#     body = data.aws_iam_policy_document.example_lambda.json
+#   }
+
+#   function_s3_bucket      = local.acct.s3_buckets["lambda_function_artefacts"]["id"]
+#   function_code_base_path = local.aws_lambda_functions_dir_path
+#   function_code_dir       = "example-lambda/dist"
+#   function_include_common = true
+#   handler_function_name   = "handler"
+#   runtime                 = "nodejs22.x"
+#   memory                  = 128
+#   timeout                 = 5
+#   log_level               = var.log_level
+
+#   force_lambda_code_deploy = var.force_lambda_code_deploy
+#   enable_lambda_insights   = false
+
+#   lambda_env_vars = {
+#   }
+# }
+
+# data "aws_iam_policy_document" "example_lambda" {
+#   statement {
+#     sid    = "KMSPermissions"
+#     effect = "Allow"
+
+#     actions = [
+#       "kms:Decrypt",
+#       "kms:GenerateDataKey",
+#     ]
+
+#     resources = [
+#       module.kms.key_arn, ## Requires shared kms module
+#     ]
+#   }
+# }

infrastructure/terraform/components/examplecomponent/pre.sh

@@ -1,9 +1,9 @@
-# This script is run before the Terraform apply command.
-# It ensures all Node.js dependencies are installed, generates any required dependencies,
-# and builds all Lambda functions in the workspace before Terraform provisions infrastructure.
+# # This script is run before the Terraform apply command.
+# # It ensures all Node.js dependencies are installed, generates any required dependencies,
+# # and builds all Lambda functions in the workspace before Terraform provisions infrastructure.
 
-npm ci
+# npm ci
 
-npm run generate-dependencies --workspaces --if-present
+# npm run generate-dependencies --workspaces --if-present
 
-npm run lambda-build --workspaces --if-present
+# npm run lambda-build --workspaces --if-present

infrastructure/terraform/components/examplecomponent/variables.tf

@@ -56,3 +56,9 @@ variable "log_retention_in_days" {
   description = "The retention period in days for the Cloudwatch Logs events to be retained, default of 0 is indefinite"
   default     = 0
 }
+
+variable "force_lambda_code_deploy" {
+  type        = bool
+  description = "If the lambda package in s3 has the same commit id tag as the terraform build branch, the lambda will not update automatically. Set to True if making changes to Lambda code from on the same commit for example during development"
+  default     = false
+}

lambdas/example-lambda/src/index.ts

@@ -1 +1,9 @@
-// Replace me with the actual code for your Lambda function
+import { Handler } from 'aws-lambda';
+
+export const handler: Handler = async (event) => {
+  console.log('Received event:', event);
+  return {
+    statusCode: 200,
+    body: 'Event logged',
+  };
+};