Skip to content

A Jenkins notifier plugin that sends build notifications to an AWS SNS topic

License

Notifications You must be signed in to change notification settings

jenkinsci/snsnotify-plugin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

snsnotify-plugin

Sends build notifications to an AWS SNS topic as post-build step with customizable subject and message payload.

  1. git clone https://github.com/jenkinsci/snsnotify-plugin
  2. cd snsnotify-plugin
  3. mvn hpi:run compile and start Jetty with the Plugin ready to be used

Create an installable artifact:

  1. mvn clean install
  2. (wait for mvn to download the internet)
  3. Manage Jenkins > Plugins > Advanced > Upload ./target/snsnotify.hpi
  4. Restart Jenkins ([$JENKINS_URL]/safeRestart)

Now, login to AWS and do the following:

  1. Create an SNS Topic, subscribe a target SQS queue (or create subscription via email etc.)
  2. Right-click on targeted SQS queue to confirm subscription

Finally, back to Jenkins...

  1. Manage Jenkins > Configure Jenkins to use AWS creds and newly created Topic ARN. You can also specify the default bevaiour in case you want to send out also an SNS notification when the build is started (off by default).
  2. As part of your job: add post-build step for SNS notification, optionally configure subject and message (you can make use of build and environment variables, which do get substituted), resp. override Topic ARN (if you do not want to stick with globally configured one).

helpfull aws snippets

In case you work with more fain grained access controlls, this is an example policy for just publishing to a single topic

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AWSConfigSNSPolicy20150201",
            "Action": [
                "SNS:Publish"
            ],
            "Effect": "Allow",
            "Resource": "arn:aws{{just copy the whole arn into this}}"
        }
    ]
}

About

A Jenkins notifier plugin that sends build notifications to an AWS SNS topic

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 83.2%
  • HTML 16.8%