pprxmtr is a system that consists of a Slack App and a bunch of AWS Lambda functions that can be used to generate animated GIFs that "approximate" the GIF where a certain professional wrestling promoter falls on his back.
- JDK 8
- Maven 3
- Node
- Serverless
- Slack credentials
- Slack App preferably set up already
- Slash command
- Permissions:
- Add commands (commands)
- Send messages (chat:write:bot)
- Access workspace emoji (emoji:read)
- Access workspace files (files:read)
- Incoming webhooks (incoming-webhook)
- AWS credentials:
- Serverless credentials
- Whatever permissions required to use Lambda, S3, API Gateway, SNS and DynamoDB, see serverless.yml
- Create a Slack App manually or see link for more instructions
- Open pom.xml
- Set missing properties: aws.user.id, s3.bucket.name, slack.oauth.token, slack.verification.token, slack.client.id, slack.client.secret.
- Change other properties as you see fit, relevant ones are defaultLocale, aws.region and node debug settings. Maven resources plugin will populate serverless.yml files with relevant properties.
- It might be best to narrow down the permissions given to the Lambda functions in serverless.yml before going to production! Note Maven resources plugin generates the actual serverless.yml used, always make your edits to the ones in serverless subfolder.
- Once you feel like ready to deploy the app, run
mvn clean install
if you just want to build everything without running serverless deploy, use
mvn clean package
- If everything went well, you should now have two serverless stacks deployed and AWS backend ready to receive slash commands from Slack.
- Take note of the POST endpoint created for service pprxmtr-request-handler, this will be the request URL that you have to hook your Slack slash command to.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 1.0 which is available at http://www.eclipse.org/org/documents/epl-v10.php