This small Lambda app will post updates to a Slack channel for pipeline events generated by AWS Code Pipeline.
If you have Code Pipelines in multiple accounts / sub-accounts and/or regions then you'll need to deploy this application to each account+region combo that you have your Code Pipelines in.
The easiest way to use this application is via the AWS Serverless Application Repo. You can find it here .
If you can't, or don't want to, use the SAR version, then carry on here...
- AWS Account using Code Pipeline. Otherwise there's not much point to this. :)
- Slack account, and an incoming webhook URL you can use to post to it. This will be something like
https://hooks.slack.com/services/....
- An AWS user with sufficient privileges to deploy the application from the AWS Serverless Application Repository
- An S3 bucket that you can use as a location of your build artifact. You should have write privileges to this from your AWS user.
- Locally: Node, and an at least relatively recent version of the AWS CLI
-
Run the following from a terminal, substituting
YOUR_S3_BUCKET
for the S3 bucket described above, andYOUR-INCOMING-WEBHOOK-URL
for the Slack URL described above:$ npm install $ npm run dist $ aws cloudformation package --template-file sam.yml --s3-bucket YOUR_S3_BUCKET --output-template-file target/packaged-template.yaml $ aws cloudformation deploy --template-file ./target/packaged-template.yaml --stack-name cp-slack-notifier --parameter-overrides SlackUrl=YOUR-INCOMING-WEBHOOK-URL --capabilities CAPABILITY_IAM
If you'd like to test the app, you can configure the following test event in the Lambda console, and test there:
{
"version": "0",
"id": "d852b55d-a96a-e396-2e34-107bc39d1e21",
"detail-type": "CodePipeline Pipeline Execution State Change",
"source": "aws.codepipeline",
"account": "123456789012",
"time": "2018-02-23T16:54:45Z",
"region": "us-west-2",
"resources": [
"arn:aws:codepipeline:us-west-2:123456789012:serverless-weather-build-CodePipeline-ABCDEFGHIJKL"
],
"detail": {
"pipeline": "serverless-weather-build-CodePipeline-ABCDEFGHIJKL",
"execution-id": "1620f6b6-6731-4d93-aa3c-123456789012",
"state": "STARTED",
"version": 1
}
}
-
To change which types of events you want to be notified about you can specify a filter within the Cloudwatch Event rule. For instance, to only notify on failed runs of the pipeline, update the
EventPattern
section of theCodePipelineEvent
in thesam.yml
file as follows:EventPattern: source: - aws.codepipeline detail-type: - CodePipeline Pipeline Execution State Change detail: state: - FAILED
-
Similarly, to only notify for certain pipelines you can use the
pipeline
attribute of thedetail
element. For more details of event filtering, see the documentation at http://docs.aws.amazon.com/codepipeline/latest/userguide/detect-state-changes-cloudwatch-events.html -
You can also listen for different, more granular, events within CodePipeline. This is also detailed in the link above.
-
You can perform filtering in code, in the Lambda function, but that will mean your Lambda function is getting triggered more often, which can lead to increased costs.
-
Another nice extension would be different types of message for different kinds of events, or posting to different channels for different pipelines. Either of these are possible by modifying the message POSTed to Slack. See https://api.slack.com/docs/messages for more details
To teardown the notifier delete the stack through the Web Console, or use the incantation below:
$ aws cloudformation delete-stack --stack-name cp-slack-notifier
Copyright 2017, Symphonia LLC