Lambda Twitter Blog Poster

Automagically post to Twitter timeline about new blog post using Go on AWS Lambda.

TL;DR Events are generated using webhooks - Gitlab in this case because that's where I store my site. On specific commit events (the commits contain a [NEW POST] block), a Twitter status is pushed to my timeline.

Developing

Requirements

• Serverless
• Go

Getting started

1. Create a env.yml file in the root of the project.
2. Declare the following variables and values in the file -

secrets:
  HOOK_SECRET: *<gitlab-token-header-secret>*
  API_KEY: *<twitter-consumer-api-key>*
  API_SECRET: *<twitter-consumer-secret-key>*
  ACCESS_TOKEN: *<twitter-app-access-token>*
  ACCESS_SECRET: *<twitter-app-access-secret>*
  BASE_URL: *<url-of-blog>*

Deploy

1. To deploy, use sls deploy -v OR make deploy.
2. Once deployed, copy the API Gateway URL printed on the console.

Create a webhook

Only GitLab is supported at the moment

1. Navigate to the repo for which a webhook will be triggered.
2. From the panel on the left, go to Settings > Integrations to create a new webhook.
3. Paste the URL from the last section into the URL field and the secret from the serverless.env.yml file in to the Secret Token field.
4. Check Push Events under Trigger.
5. Click on Add webhook to save.

Triggering the function

1. To trigger a new post to Twitter on new post publishes, commit your new posts in the form -

[NEW POST]
The title of the post
permalink-of-the-post

2. Profit!

Contributing

Read the CONTRIBUTING guide for information.

License

Licensed under MIT. See LICENSE for more information.

Issues

Report a bug in issues.

Made with love in Kuala Lumpur, Malaysia by Riyadh Al Nur