OR13h

Twitter Bot powered by OpenShift and Github

Examples:

@OR13h image me invader zim gir
@OR13h youtube nyan cat remix

Getting Started From Scratch

Clone Find Replace "OR13h" with "MyCoolAppName"...

OpenShift RHC Setup

Signup for an openshift account: https://www.openshift.com/app/account/new

Intall RHC: https://developers.openshift.com/en/managing-client-tools.html

Create Your Hubot App

rhc app create OR13h nodejs-0.10 http://cartreflect-claytondev.rhcloud.com/reflect?github=smarterclayton/openshift-redis-cart --from-code=https://github.com/codemiller/hubot-openshift

Testing locally

Install hubot:

npm install -g hubot coffee-script

Run locally:

$ ./bin/hubot --name OR13h

There are several included scripts that will be loaded. Try running a few commands, such as the following:

OR13h> OR13h help
OR13h> OR13h ping
OR13h> OR13h the rules
OR13h> OR13h map me sydney
OR13h> OR13h pug me
OR13h> OR13h ship it

Install Twitter Adapter

Install the hubot twitter adapter.

npm install hubot-twitter --save

Setup Your Twitter Account

Create a new twitter account named OR13h.
Add a mobile number so you can create an app.
Consider using google voice if you need a new number.
Create a new app named OR13h here: https://apps.twitter.com/app/new.
Use 'rhc app show' to find your app url.
Enter this app url for website and callback fields, add description, agree to TOS (after reading) and save.
Go ahead and create an Access Token.

Set Your Environment Variables

Export some variables for local testing (all these fields are visible from the Access Token view in twitter).

export HUBOT_TWITTER_KEY=XXX
export HUBOT_TWITTER_SECRET=XXX
export HUBOT_TWITTER_TOKEN=XXX
export HUBOT_TWITTER_TOKEN_SECRET=XXX

You must run this command to make the variables available in openshift.

rhc env set HUBOT_TWITTER_KEY=XXX HUBOT_TWITTER_SECRET=XXX HUBOT_TWITTER_TOKEN=XXX HUBOT_TWITTER_TOKEN_SECRET=XXX -a OR13h

Testing Twitter Locally

You can test the twitter adapter locally (assuming environment variables have been exported).

$ ./bin/hubot --name OR13h --adapter twitter

Update package.json

Make these changes so OpenShift knows to use the twitter adapter:

"start": "PORT=$OPENSHIFT_NODEJS_PORT BIND_ADDRESS=$OPENSHIFT_NODEJS_IP HEROKU_URL=$OPENSHIFT_APP_DNS REDIS_URL=redis://:$REDIS_PASSWORD@$OPENSHIFT_REDIS_HOST:$OPENSHIFT_REDIS_PORT bin/hubot -n OR13h -a twitter"

Deploying to OpenShift

Deploy via git as usual:

git add -A
git commit -m "Adding Twitter adapter and other changes..."
git push

Deploying to Github

Create a new repo on github with the same name.

git remote add github git@github.com:OR13/OR13h.git
git push -u github master

I like to rename the origin to openshift.

git remote rename origin openshift

Now we can:

git push github 
git push openshift

Adding More Scripts

Lets say you want to add some more scripts to your hubot, say google images and youtube.

For Google images, we can just:

npm install hubot-google-images --save

Don't forget to add to your external deps file:

"hubot-google-images"

For Youtube, we need to get some access keys first:

See: https://github.com/hubot-scripts/hubot-youtube

Then make sure that OpenShift can access the key:


rhc env set HUBOT_YOUTUBE_API_KEY=XXX -a OR13h

Setting a Password


rhc env set OR13H_USER=XXX OR13H_PASSWORD=XXX -a OR13h

Credits

These instructions were adopted from this wonderful blog post:

https://blog.openshift.com/hitchhikers-guide-to-tweetbots-hosting-a-hubot-on-openshift/

OR13 / OR13h