deep_thought 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a46a75aa7fcacd8d1492652f8c961bc6d256e737
+  data.tar.gz: 73151bb16afadfdb0bb284989a7f17656b477e2a
+SHA512:
+  metadata.gz: 74361c6cb41cc55f79f8b1a495bebf040ab4702c774ae2db5a2752f73f33c20f351a743f0a3eccea11fbc83f6031b4c4463aab1432642956f3e92bcf85b654c5
+  data.tar.gz: 00b5faf81cd62a8952da46b1de010ab8fae5eeafaf6221e3340703298a47703943a71fc3deb95c54a25229964c134045bc80139827b1538b18779b08a3cbbc18

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Ian Lollar
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,184 @@
+# DeepThought
+
+Deploy smart, not hard.
+
+## See
+
+Deep Thought takes all of the thought out of deploying.
+
+Want to prevent deployment conflicts? Deep Thought does that. Want to deploy with Hubot? Deep Thought has you covered. Looking to ensure a build is green before it is deployed? Deep Thought yawns at your puny requests. Want a web interface? Got it. How about an API? Yep. Security? Totally locked down. Deep Thought has your deployments covered.
+
+Deep Thought was inspired by GitHub's own Hubot+Heaven workflow. Check out [Zach Holman's talk](http://zachholman.com/talk/unsucking-your-teams-development-environment/) to see the original inspiration.
+
+## Want
+
+Use [this Gist](https://gist.github.com/redhotvengeance/5746731) to get started:
+
+    git clone git://gist.github.com/5746731 deep_thought
+
+## Use
+
+### Setup
+
+Deep Thought is designed to be deployed to Heroku:
+
+    heroku apps:create [NAME]
+    heroku config:set RACK_ENV=production
+
+Deep Thought will, by default, route all requests through https for security. It is *strongly* recommended to set a secret token to be used for session cookies:
+
+    uuid=`UUIDGEN`
+    secret=$(echo -ne "\0$uuid" | base64 | sed -e "s/=//g")
+    heroku config:set SESSION_SECRET="$secret"
+
+Deep Thought requires a PostgreSQL database. Add one to your Heroku app:
+
+    heroku addons:add heroku-postgresql
+
+Now go ahead and push Deep Thought to Heroku:
+
+    git push heroku master
+
+To start using Deep Thought, you'll need to create an initial user. Fortunately, Deep Thought makes this easy to do:
+
+    heroku run rake create_user[user@email.com,secretpassword]
+
+Now head over to your Deep Thought instance and login:
+
+    open https://<app-name>.herokuapp.com
+
+Deep Thought requires the use of a background worker for deployments. Normally, on Heroku, this could become costly, as it would require spinning up a second (worker) dyno. However, Deep Thought includes the ability to intelligently spin this dyno up and down to help minimize (or even eliminate) costs. To enable this functionality, two environment variables need to be set:
+
+    HEROKU_APP=<app-name>
+    HEROKU_API_KEY=<your-heroku-api-key>
+
+### Add a project
+
+Once logged in, click the `+ add project` button on the `projects` page. Enter a unique project name and the remote Git repository url for the project. Click `create project`, and now your project is set up and ready to deploy.
+
+### .deepthought.yml
+
+Deep Thought expects to find a `.deepthought.yml` file in the root of all projects. This file serves as a config for the project - it tells Deep Thought the information it needs to know to deploy the project.
+
+Here's an example `.deepthought.yml`:
+
+    deploy_type: shell
+    ci:
+      enabled: true
+      name: project-name
+    root: script/deploy
+
+`deploy_type` should be the key name for the deployer (defaults to `shell`). `ci` is group for continuous integration setting - `enabled` tells Deep Thought to check the CI server for green builds and `name` is the name of the project on the CI server. `root` is a shell deployer-specific setting - it tells Deep Thought where the deploy shell script it located in the project (defaults to `script/deploy`).
+
+Make sure to add any dependencies needed to deploy your project to your Gemfile.
+
+### Add a key
+
+It is likely that your project repos are private, and even if they are not, you still probably need to authenticate via ssh key to access servers for deployment. If you need to add an ssh key to Deep Thought hosted on Heroku, then you can use the Deep Thought buildpack:
+
+    heroku config:set BUILDPACK_URL=https://github.com/redhotvengeance/heroku-buildpack-deep-thought
+    ssh_key=`cat ~/.ssh/your_ssh_key`
+    heroku config:set SSH_KEY="$ssh_key"
+    heroku config:set SSH_HOST=github.com
+
+Keep in mind that the ssh key shouldn't have a password - otherwise Deep Thought won't be able to use it!
+
+### Deploy
+
+Click on a project from the homepage. Select the branch to deploy, and optionally define additional parameters:
+
+- `environment`: Sets the environment to deploy to (`development`, `staging`, `production`, etc - defaults to `development`).
+- `box`: Sets a specific server to deploy to (passed as an argument to the shell script - `script/deploy development deploy box=prod`).
+- `action`: Sets a subtask to deploy (for instance, if "config" is added, then Deep Thought would execute `script/deploy development deploy:config`).
+- `variable`: Sets additional values that can be passed to the deploy (for instance, if set to `force=true`, Deep Thought would execute `script/deploy development deploy force=true`).
+
+Click `deploy` - now a deployment is underway!
+
+Deep Thought will let you know once the deployment is finished. If you'd like to see a log of previous deployments, click the `history` button. Clicking on a subsequent deployment will show you the details of that deployment.
+
+### Continuous integration
+
+If you use continuous integration, you can have Deep Thought check to make sure a build is green before deploying. By default, Heroku supports interfacing with [Janky](https://github.com/github/janky).
+
+To enable continuous integration, several environment variables must be set:
+
+    heroku config:set CI_SERVICE=janky
+    heroku config:set CI_SERVICE_ENDPOINT=http://your-janky-server.com
+    heroku config:set CI_SERVICE_USERNAME=janky_username
+    heroku config:set CI_SERVICE_PASSWORD=janky_password
+
+Now, so long as a project enables continuous integration in its `.deepthought.yml` file, Deep Thought will check the project/branch build status before deploying.
+
+### API
+
+To use the API, you must have an API key. To generate a key, go to the `me` page and click `generate new api key`.
+
+All API requests must have the `Accept` header set to `application/json`. To authenticate, the `Authorization` header should be set to `Token token="<your api key>"`.
+
+The current API routes are:
+
+- `GET /deploy/status` - Get the current status of Deep Thought.
+- `POST /deploy/:app` - Deploy a project. Optionally pass (JSON encoded) `environment`, `box`, `actions` (array), `variables` (key/value object), and `on_behalf_of` (username requesting deploy - useful for bots).
+- `POST /deploy/setup/:app` - Setup a new project. Required to include (JSON encoded) `repo_url`.
+
+### Hubot
+
+Hubot integrates wonderfully with Deep Thought. He communicates via the API, which means he'll need an account with an API generated.
+
+Once you've setup the Hubot user and have its API key, grab the Deep Thought Hubot script and add it to your Hubot.
+
+Set the following config variables for your Hubot:
+
+    heroku config:set DEEP_THOUGHT_URL=https://your-deep-thought.herokuapp.com
+    heroku config:set DEEP_THOUGHT_TOKEN=<hubot api key>
+
+Finally, Deep Thought likes to talk back to Hubot to let him know how deploys are going. Login to the Hubot account on Deep Thought, head to the `me` page, and set the `notification url` to `http://your.hubot.com/notify`.
+
+To learn more about how to ask Hubot to deploy, check out the Hubot script.
+
+## Enjoy
+
+Feel that? Yep - that's your stresses melting away. Look at all this time you have now! Maybe you'll make a sandwich. Or watch a documentary. Perhaps start a cute herb garden.
+
+## Hack
+
+Want to hack on Deep Thought?
+
+Set it up:
+
+    script/bootstrap
+
+Create an `.env`:
+
+    echo RACK_ENV=development > .env
+
+Set up the databases (PostgreSQL):
+
+    createuser deep_thought
+    createdb -O deep_thought -E utf8 deep_thought_development
+    createdb -O deep_thought -E utf8 deep_thought_test
+    rake db:migrate
+
+Start the server:
+
+    script/server
+
+Open it:
+
+    open http://localhost:4242
+
+Test it:
+
+    script/test
+
+## Give
+
+Want to make Deep Thought even deeper and more thoughtier? Contribute!
+
+1. Fork
+2. Create
+3. Code
+4. Test
+5. Push
+6. Submit
+7. Yay!

data/Rakefile

@@ -0,0 +1,50 @@
+$LOAD_PATH.unshift(File.expand_path("../lib", __FILE__))
+
+require "bundler/gem_tasks"
+require "active_record"
+require "fileutils"
+
+ENV["RACK_ENV"] ||= "development"
+
+require "deep_thought"
+
+DeepThought.setup(ENV)
+
+require "deep_thought/tasks"
+
+namespace :db do
+  desc 'Output the schema to db/schema.rb'
+  task :schema do
+    ActiveRecord::Schema.verbose = true
+    File.open('db/schema.rb', 'w') do |f|
+      ActiveRecord::SchemaDumper.dump(ActiveRecord::Base.connection, f)
+    end
+  end
+
+  desc "Create a migration at ./db/migrate/{NAME}"
+  task :create_migration do
+    name = ENV['NAME']
+    abort("No name specified. Use `rake db:create_migration NAME=migration_name`") if !name
+
+    migrations_dir = File.join("db", "migrate")
+    version = ENV["VERSION"] || Time.now.utc.strftime("%Y%m%d%H%M%S")
+    filename = "#{version}_#{name}.rb"
+    migration_name = name.gsub(/_(.)/) { $1.upcase }.gsub(/^(.)/) { $1.upcase }
+
+    FileUtils.mkdir_p(migrations_dir)
+
+    open(File.join(migrations_dir, filename), 'w') do |f|
+      f << (<<-EOS).gsub("      ", "")
+      class #{migration_name} < ActiveRecord::Migration
+        def up
+        end
+
+        def down
+        end
+      end
+      EOS
+    end
+
+    puts "New migration created at #{migrations_dir}/#{filename}"
+  end
+end

data/config.ru

@@ -0,0 +1,5 @@
+require "deep_thought"
+
+DeepThought.setup(ENV)
+
+run DeepThought.app

data/db/migrate/20130414012805_create_projects.rb

@@ -0,0 +1,15 @@
+class CreateProjects < ActiveRecord::Migration
+  def up
+    create_table :projects do |t|
+      t.string :name
+      t.string :repo_url
+      t.string :deploy_type
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :projects
+  end
+end

data/db/migrate/20130426165010_create_states.rb

@@ -0,0 +1,14 @@
+class CreateStates < ActiveRecord::Migration
+  def up
+    create_table :states do |t|
+      t.string :name
+      t.string :state
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :states
+  end
+end

data/db/migrate/20130501003758_create_users.rb

@@ -0,0 +1,14 @@
+class CreateUsers < ActiveRecord::Migration
+  def up
+    create_table :users do |t|
+      t.string :email
+      t.string :password_digest
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :users
+  end
+end

data/db/migrate/20130508001711_add_api_key_to_users.rb

@@ -0,0 +1,9 @@
+class AddApiKeyToUsers < ActiveRecord::Migration
+  def up
+    add_column :users, :api_key, :string
+  end
+
+  def down
+    remove_column :users, :api_key
+  end
+end

data/db/migrate/20130509014935_create_deploys.rb

@@ -0,0 +1,27 @@
+class CreateDeploys < ActiveRecord::Migration
+  def up
+    create_table :deploys do |t|
+      t.text :actions
+      t.string :branch
+      t.string :environment
+      t.string :box
+      t.text :variables
+      t.string :commit
+      t.datetime :started_at
+      t.datetime :finished_at
+      t.boolean :in_progress, :default => false
+      t.boolean :was_successful
+      t.text :log
+      t.string :via
+      t.string :on_behalf_of
+      t.references :project
+      t.references :user
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :deploys
+  end
+end

data/db/migrate/20130514062148_create_delayed_jobs.rb

@@ -0,0 +1,21 @@
+class CreateDelayedJobs < ActiveRecord::Migration
+  def up
+    create_table :delayed_jobs do |t|
+      t.integer :priority, :default => 0
+      t.integer :attempts, :default => 0
+      t.text :handler
+      t.string :last_error
+      t.datetime :run_at
+      t.datetime :locked_at
+      t.datetime :failed_at
+      t.string :locked_by
+      t.string :queue
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :delayed_jobs
+  end
+end

data/db/migrate/20130516042149_change_delayed_job_last_error_to_text.rb

@@ -0,0 +1,9 @@
+class ChangeDelayedJobLastErrorToText < ActiveRecord::Migration
+  def up
+    change_column :delayed_jobs, :last_error, :text
+  end
+
+  def down
+    change_column :delayed_jobs, :last_error, :string
+  end
+end

data/db/migrate/20130517010210_add_ci_to_projects.rb

@@ -0,0 +1,9 @@
+class AddCiToProjects < ActiveRecord::Migration
+  def up
+    add_column :projects, :ci, :boolean, :default => true
+  end
+
+  def down
+    remove_column :projects, :ci
+  end
+end

data/db/migrate/20130525001332_add_notification_url_to_users.rb

@@ -0,0 +1,9 @@
+class AddNotificationUrlToUsers < ActiveRecord::Migration
+  def up
+    add_column :users, :notification_url, :string
+  end
+
+  def down
+    remove_column :users, :notification_url
+  end
+end

data/db/migrate/20131127022704_remove_deploy_type_and_ci_from_projects.rb

@@ -0,0 +1,11 @@
+class RemoveDeployTypeAndCiFromProjects < ActiveRecord::Migration
+  def up
+    remove_column :projects, :ci
+    remove_column :projects, :deploy_type
+  end
+
+  def down
+    add_column :projects, :ci, :string
+    add_column :projects, :deploy_type, :string
+  end
+end

data/db/schema.rb

@@ -0,0 +1,72 @@
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# Note that this schema.rb definition is the authoritative source for your
+# database schema. If you need to create the application database on another
+# system, you should be using db:schema:load, not running all the migrations
+# from scratch. The latter is a flawed and unsustainable approach (the more migrations
+# you'll amass, the slower it'll run and the greater likelihood for issues).
+#
+# It's strongly recommended to check this file into your version control system.
+
+ActiveRecord::Schema.define(:version => 20131127022704) do
+
+  create_table "delayed_jobs", :force => true do |t|
+    t.integer  "priority",   :default => 0
+    t.integer  "attempts",   :default => 0
+    t.text     "handler"
+    t.text     "last_error"
+    t.datetime "run_at"
+    t.datetime "locked_at"
+    t.datetime "failed_at"
+    t.string   "locked_by"
+    t.string   "queue"
+    t.datetime "created_at",                :null => false
+    t.datetime "updated_at",                :null => false
+  end
+
+  create_table "deploys", :force => true do |t|
+    t.text     "actions"
+    t.string   "branch"
+    t.string   "environment"
+    t.string   "box"
+    t.text     "variables"
+    t.string   "commit"
+    t.datetime "started_at"
+    t.datetime "finished_at"
+    t.boolean  "in_progress",    :default => false
+    t.boolean  "was_successful"
+    t.text     "log"
+    t.string   "via"
+    t.string   "on_behalf_of"
+    t.integer  "project_id"
+    t.integer  "user_id"
+    t.datetime "created_at",                        :null => false
+    t.datetime "updated_at",                        :null => false
+  end
+
+  create_table "projects", :force => true do |t|
+    t.string   "name"
+    t.string   "repo_url"
+    t.datetime "created_at", :null => false
+    t.datetime "updated_at", :null => false
+  end
+
+  create_table "states", :force => true do |t|
+    t.string   "name"
+    t.string   "state"
+    t.datetime "created_at", :null => false
+    t.datetime "updated_at", :null => false
+  end
+
+  create_table "users", :force => true do |t|
+    t.string   "email"
+    t.string   "password_digest"
+    t.datetime "created_at",       :null => false
+    t.datetime "updated_at",       :null => false
+    t.string   "api_key"
+    t.string   "notification_url"
+  end
+
+end