NuoKeg is a NuoDB backed Rails app that I originally wrote to keep track of the beer on tap at the NuoDB office. It wound up being a reasonable example of using NuoDB with Rails so I'm putting it up as a guide.
You'll need a few things if you want to run your own NuoKeg
- An install of NuoDB
- An API key from BreweryDB
- (Optional) Twitter API Keys
Currently, the NuoDB ActiveRecord Adapter does not support the rake db:create task. However it is easy to startup a NuoDB database manually using the command line NuoDB Manager tool.
java -jar /opt/nuodb/jar/nuodbmanager.jar --broker localhost --user domain --password bird --command "start process sm host localhost database nuokeg-dev archive /var/opt/nuodb/production-archives/nuokeg-dev initialize yes"
java -jar /opt/nuodb/jar/nuodbmanager.jar --broker localhost --user domain --password bird --command "start process te host localhost database nuokeg-dev options '--dba-user dab --dba-password dba'"If you ran the previous two commands exactly as they are your database.yml is already good to go. If you changed the database name or dba credentials you will need to update it accordingly.
development:
adapter: nuodb
database: nuokeg-dev@localhost
username: dba
password: dba
schema: nuokegMake sure you have the necessary gems (including the NuoDB Ruby Driver and the ActiveRecord Adapter) installed by running a bundle install and then create the NuoKeg schema with rake db:migrate.
NuoKeg expects to find the API keys that it needs in environment variables. You can set them in a ruby config file
ENV["BREWERY_DB_KEY"]="YOURKEY"
ENV["TWITTER_CONSUMER_KEY"]="YOURKEY"
ENV["TWITTER_CONSUMER_SECRET"]="YOURKEY"
ENV["TWITTER_OAUTH_TOKEN"]="YOURKEY"
ENV["TWITTER_OAUTH_TOKEN_SECRET"]="YOURKEY"bash
export BREWERY_DB_KEY=YOURKEY
export TWITTER_CONSUMER_KEY=YOURKEY
export TWITTER_CONSUMER_SECRET=YOURKEY
export TWITTER_OAUTH_TOKEN=YOURKEY
export TWITTER_OAUTH_TOKEN_SECRET=YOURKEYor using something like Foreman
Start NuoKeg by running rails server and enjoy!