walterkopp/Amplify-build-notifications

Amplify build notifications for Slack

Amplify Slack Notifications

Ever wanted simple yet cool AWS Amplify build notifications in Slack or MS Teams? Well here you go!

Table of contents

Click to expand!

• Amplify Slack Notifications
  • Table of contents
  • Previews
  • Architecture
  • Resources
  • Installation
    • Slack
    • MS Teams (coming soon)
  • Deployment
    • Prerequisites
    • Makefile
    • Cleanup

Previews

Slack previews

MS Teams previews

ℹ coming soon

Architecture

Resources

• CloudFormation stacks
  • aws-sam-cli-managed-default
  • amplify-notifications
• S3 Buckets
  • aws-sam-cli-managed-default
• Lambda
  • Language: python
• IAM role
  • Lambda execution & logging

ℹ Note: The aws-sam-cli-managed-default bucket & CF stack are created using sam deploy --guided and managed by AWS SAM. This is required in order to store the CF stack template + packaged / compiled Lambda code

Installation

Slack

In order to use notifications for Slack, follow these steps to create an incoming webhook:

Incoming webhooks for Slack

1. Create a new Slack app in your workspace
2. From the Features page, toggle Activate Incoming Webhooks on
3. Click Add New Webhook to Workspace
4. Pick a channel that the app will post to, then click Authorize
5. Reference the Webhook URL in the WebhookUrl parameter when deploying with AWS SAM

MS Teams (coming soon)

Loading... ↺

Deployment

Deployment is managed using AWS SAM

Prerequisites

Plugin	Version
AWS CLI	>= v2.7
SAM CLI	>= v.1.55

Makefile

In order to make deploying a little bit easier a Makefile is provided

Usage:

make help

Cleanup

Done with playing around and the resources are not needed anymore?

1. Simply delete your created AWS CloudFormation stack via console or SAM delete
2. Don't forget to remove the aws-sam-cli-managed-default CF stack