Merge pull request #1070 from aligent/feature/MICRO-196-Slack-Alerts

MICRO-196: Slack Alerts

.nvmrc

@@ -1 +1 @@
-16.2.0
+v18.17.0

package.json

@@ -9,8 +9,9 @@
         ]
     },
     "devDependencies": {
+        "@types/aws-lambda": "^8.10.121",
         "@types/jest": "^26.0.10",
-        "@types/node": "16.9.4",
+        "@types/node": "^18.15.3",
         "jest": "^26.4.2",
         "source-map-support": "^0.5.19",
         "ts-jest": "^26.5.6",
@@ -21,6 +22,7 @@
         "esbuild": "^0.12.15"
     },
     "dependencies": {
+        "@aws-sdk/client-sns": "^3.413.0",
         "aws-cdk-lib": "^2.90.0",
         "constructs": "10.1.56"
     },

packages/graphql-mesh-server/README.md

@@ -1,6 +1,8 @@
-# Prerender in Fargate
+# GraphQL Mesh in Fargate
 A construct host [GraphQL Mesh](https://the-guild.dev/graphql/mesh) server in Fargate. 
 
+## Deployment notifications
+If notificationArn is set this construct creates a CodeStar notification rule, SNS topic and Lambda function to receive notifications for codepipeline executions and forward them to another SNS topic. This is so that you can setup AWS Chatbot either in this account OR another account and forward the notifications there. 
 ## Props
  - `vpc?`: VPC to attach Redis and Fargate instances to (default: create a vpc)
  - `vpcName?`: If no VPC is provided create one with this name (default: 'graphql-server-vpc')
@@ -13,3 +15,4 @@ A construct host [GraphQL Mesh](https://the-guild.dev/graphql/mesh) server in Fa
  - `memory?`: Amount of memory per Fargate instance (default: 1024)
  - `redis?`: Redis instance to use for mesh caching
  - `secrets?`: SSM values to pass through to the container as secrets
+ - `notificationArn?`: SNS Topic ARN to publish deployment notifications to

packages/graphql-mesh-server/assets/notify-sns.ts

@@ -0,0 +1,20 @@
+import { PublishCommand, SNSClient } from '@aws-sdk/client-sns';
+import { SNSEvent } from 'aws-lambda';
+
+const client = new SNSClient({ region: process.env.AWS_REGION });
+
+export const handler = async (event: SNSEvent): Promise<void> => {
+    const record = event.Records[0];
+    const message = record.Sns.Message;
+
+    const command = new PublishCommand({
+        TopicArn: process.env.SNS_TOPIC,
+        Message: message,
+    });
+
+    try {
+        await client.send(command);
+    } catch (e) {
+        console.log(e);
+    }
+};

packages/graphql-mesh-server/lib/graphql-mesh-server.ts

@@ -53,6 +53,10 @@ export type MeshHostingProps = {
      * SSM values to pass through to the container as secrets
      */
     secrets?: {[key: string]: ssm.IStringParameter | ssm.IStringListParameter};
+    /**
+     * ARN of the SNS Topic to send deployment notifications to
+     */
+    notificationArn?: string; 
 };
 
 export class MeshHosting extends Construct {
@@ -90,6 +94,7 @@ export class MeshHosting extends Construct {
         new CodePipelineService(this, 'pipeline', {
             repository: this.repository,
             service: this.service,
+            notificationArn: props.notificationArn
         });
     }
 }

packages/graphql-mesh-server/lib/pipeline.ts

@@ -8,6 +8,12 @@ import { Construct } from 'constructs';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as YAML from 'yaml';
+import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
+import { Runtime } from 'aws-cdk-lib/aws-lambda';
+import { Effect, PolicyStatement } from 'aws-cdk-lib/aws-iam';
+import { Topic } from 'aws-cdk-lib/aws-sns';
+import { LambdaSubscription } from 'aws-cdk-lib/aws-sns-subscriptions';
+import { DetailType, NotificationRule } from 'aws-cdk-lib/aws-codestarnotifications';
 
 export interface CodePipelineServiceProps {
     /**
@@ -24,6 +30,11 @@ export interface CodePipelineServiceProps {
      * Path to buildspec.yml (default: '../assets/buildspec.yml')
      */
     buildspecPath?: string;
+
+    /**
+     * ARN of the SNS Topic to send deployment notifications to
+     */
+    notificationArn?: string; 
 }
 
 export class CodePipelineService extends Construct {
@@ -87,5 +98,41 @@ export class CodePipelineService extends Construct {
                 }),
             ],
         });
+
+        if (props.notificationArn) {
+            const notifier = new NodejsFunction(this, 'NotifierLambda', {
+                entry: path.resolve(__dirname, '../assets/notify-sns.ts'),
+                description: 'Lambda function to forward SNS messages to another account.',
+                runtime: Runtime.NODEJS_18_X,
+                handler: 'index.handler',
+                timeout: Duration.seconds(10),
+                environment: {
+                    SNS_TOPIC: props.notificationArn
+                }
+            });
+
+            notifier.addToRolePolicy(new PolicyStatement({
+                actions: ['sns:publish'],
+                resources: [props.notificationArn],
+                effect: Effect.ALLOW
+            }));
+
+            const topic = new Topic(this, 'NotifierTopic');
+            topic.addSubscription(new LambdaSubscription(notifier));
+
+            const rule = new NotificationRule(this, 'CodeStarNotificationRule', {
+                detailType: DetailType.FULL,
+                events: [
+                    'codepipeline-pipeline-pipeline-execution-failed',
+                    'codepipeline-pipeline-pipeline-execution-canceled',
+                    'codepipeline-pipeline-pipeline-execution-started',
+                    'codepipeline-pipeline-pipeline-execution-resumed',
+                    'codepipeline-pipeline-pipeline-execution-succeeded',
+                    'codepipeline-pipeline-pipeline-execution-superseded',
+                ],
+                targets: [topic],
+                source: this.pipeline,
+            });
+        }
     }
 }

tsconfig.json

@@ -1,8 +1,8 @@
 {
   "compilerOptions": {
-    "target": "ES2018",
+    "target": "ES2022",
     "module": "commonjs",
-    "lib": ["es2018"],
+    "lib": ["es2022"],
     "declaration": true,
     "strict": true,
     "noImplicitAny": true,