feat: add spot termination watcher (beta)

[npalm]

This PR is adding a lambda function to watch termination events.

• Log instance information for termination warnings
• Create optional a metric with dimensions for the environment and instance type.

This PR limits to only checking the termination warning. Later we can extend on also start acting on terminations.

Testing

Spot termination can be tested by initiate a termination event via the Spot Request overview (or cli).

Todo

• Write docs
• Add to multi runner
• Describe next steps in an issue.

[npalm]

@GuptaNavdeep1983 @ScottGuymer @nadavsinai-philips @saragerion Do one of you have any clue why middy is let failing the unit tests. For modules like lamdas/functions/webhook. The test is lambda.test.ts are working, where lambda.te also initiates middy.

In lambdas/functions/spot-termination-watcher the tests are failing with the error:

    TypeError: Cannot destructure property 'before' of 'middleware' as it is undefined.

      14 | import { Config } from './ConfigResolver';
      15 |
    > 16 | middy(interruptionWarning).use(captureLambdaHandler(tracer)).use(logMetrics(metrics));
         |                            ^
      17 | const config = new Config();
      18 |
      19 | export async function interruptionWarning(

      at Function.middy.use (../../node_modules/@middy/core/index.cjs:90:21)
      at Object.use (src/lambda.ts:16:28)
      at Object.<anonymous> (src/lambda.test.ts:6:1)

Even without adding the metrics part, which is the only difference comparing to the other modules, the tests are failing. CI is failing as well https://github.com/philips-labs/terraform-aws-github-runner/actions/runs/8129056369/job/22215682414

[npalm]

@GuptaNavdeep1983 @ScottGuymer @nadavsinai-philips @saragerion Do one of you have any clue why middy is let failing the unit tests. For modules like lamdas/functions/webhook. The test is lambda.test.ts are working, where lambda.te also initiates middy.

In lambdas/functions/spot-termination-watcher the tests are failing with the error:

    TypeError: Cannot destructure property 'before' of 'middleware' as it is undefined.

      14 | import { Config } from './ConfigResolver';
      15 |
    > 16 | middy(interruptionWarning).use(captureLambdaHandler(tracer)).use(logMetrics(metrics));
         |                            ^
      17 | const config = new Config();
      18 |
      19 | export async function interruptionWarning(

      at Function.middy.use (../../node_modules/@middy/core/index.cjs:90:21)
      at Object.use (src/lambda.ts:16:28)
      at Object.<anonymous> (src/lambda.test.ts:6:1)

Even without adding the metrics part, which is the only difference comparing to the other modules, the tests are failing. CI is failing as well https://github.com/philips-labs/terraform-aws-github-runner/actions/runs/8129056369/job/22215682414

Fixed, figured out the problem. Tracer handler could be undefined in unit test (at least).

[ScottGuymer]

Its a bit of a long one.

tried to take a look at the important stuff and it all seems ok to me.