thundercat 0.0.1

data/README.md

@@ -0,0 +1,79 @@
+# Deploy & Monitor RAP Packaged Rack Applications
+
+ThunderCat is a ruby application container for Rack based applications. It is very similar in concept to war files and Tomcat. When you drop a .rap file into ThunderCats webapps directory it will auto expand and start the webapp.
+There is a web admin panel which lets you upload a .rap archive and also see which webapps are running and start/stop/remove them.
+
+[![Build Status](https://travis-ci.org/masterthought/thundercat.png?branch=master)](https://travis-ci.org/masterthought/thundercat)
+
+## Background
+
+ThunderCat aims to be a sort of rack application container. It's not really a container but more of a place to deploy all your sinatra/rails/rack applications in one place and start/stop/remove them. The core
+philosophy is to have a single artifact (a .rap archive) which can be dropped into ThunderCat and auto startup to make deployment extremely simple.
+
+It might not suit everyone but it could be very useful for deploying internal applications inside a big corporation or even just your blog up to your website if you control the server it lives on. Instead of using something
+like capistrano you just drop a .rap archive into ThunderCat and it does the rest.
+
+Currently thin and unicorn are supported but raise and issue if you want any others supported.
+
+ThunderCat is designed to be used in conjunction with [Rappa](https://github.com/masterthought/rappa). Using Rappa you create your .rap archive and then upload it to ThunderCat via the admin panel or use the rappa deploy command.
+
+## Install
+
+gem install thundercat
+
+## Usage
+
+First you need to create your ThunderCat file structure:
+
+     thundercat my_apps
+
+This will create a directory structure with the path you provide it - the structure is as follows:
+
+![file structure]
+(https://github.com/masterthought/thundercat/raw/master/.README/thundercat_structure.jpg)
+
+The start.sh and stop.sh scripts are used to start and stop ThunderCat. Logs go into the logs directory and webapps go into the webapps directory. The archive directory holds backups when you deploy/remove apps via the admin panel.
+The monitor.rb file is what gets started and monitors the webapps directory for changes.
+
+When you start ThunderCat for the first time it starts on port 9898 with the following credentials:
+
+     username: thundercat
+     password: thundercat
+
+## Config
+
+You can configure the username and password and the port ThunderCat starts on in the config.yml in webapps/thundercat. You have to startup thundercat first in order for the thundercat.rap to be expanded and installed - but after that you can go and edit the config.yml and restart thundercat.
+You can also set the api_key - this is what you need in order to deploy from the rappa command as shown below.
+
+### deploy
+
+This deploys a rap archive to a thundercat server e.g.
+
+     rappa deploy -r myapp.rap -u http://thundercat/api/deploy -k your_api_key
+
+-r is to specify your rap archive and -u is the url of the deploy api where your thundercat instance is running. -k is your api_key which is configured in your
+thundercat server.
+
+## Screenshots
+
+### Admin Page
+
+![admin page]
+(https://github.com/masterthought/thundercat/raw/master/.README/thundercat_admin.jpg)
+
+### Login Page
+
+![login page]
+(https://github.com/masterthought/thundercat/raw/master/.README/thundercat_login.jpg)
+
+## Additional Info
+
+The bootstrap.sh could be used to set an environment variable like RAILS_ENV and the start.sh could contain a rake command in which the rakefile contains a start command that uses the environment variable to deploy with the correct environment.
+This does mean you will have to expand the rap, update the bootstrap script and then package again if deploying to different environments needs different config. Any suggestions around this area are welcome and since this is
+in the early stages it's fairly experimental.
+
+
+## Develop
+
+Interested in contributing? Great just let me know how you want to help.
+

data/bin/thundercat

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+require 'fileutils'
+
+name = ARGV[0]
+
+if name.nil? or name.empty?
+  puts '[ThunderCat] Error you must supply a target directory name'
+else
+
+  begin
+    rap = File.dirname(File.expand_path(__FILE__)) + '/../src/rap/thundercat.rap'
+    monitor = File.dirname(File.expand_path(__FILE__)) + '/../src/monitor/monitor.rb'
+    start_script = File.dirname(File.expand_path(__FILE__)) + '/../src/monitor/start.sh'
+    stop_script = File.dirname(File.expand_path(__FILE__)) + '/../src/monitor/stop.sh'
+
+    target_dir = "#{name}"
+    if File.exists?(target_dir)
+      puts "[ThunderCat] The directory you supplied: #{target_dir} already exists"
+    else
+      FileUtils.mkpath(target_dir)
+      FileUtils.mkpath("#{target_dir}/webapps")
+      FileUtils.mkpath("#{target_dir}/log")
+      FileUtils.mkpath("#{target_dir}/archive")
+      FileUtils.cp(rap, "#{target_dir}/webapps")
+      FileUtils.cp(monitor, target_dir)
+      FileUtils.cp(start_script, target_dir)
+      FileUtils.cp(stop_script, target_dir)
+      puts "[ThunderCat] Successfully created ThunderCat structure at: #{target_dir}"
+    end
+  rescue => e
+    puts "[ThunderCat] OOps something went wrong: #{e}"
+  end
+end
+
+
+
+
+
+

data/src/monitor/monitor.rb

@@ -0,0 +1,121 @@
+#!/usr/bin/env ruby
+require 'fssm'
+require 'dante'
+require 'yaml'
+require 'rappa'
+
+class Decision
+
+  def decide(option, base, relative, type)
+    rap_file = base + '/' + relative
+    rap_dir = path_without_ext(rap_file, base)
+    if option == :create
+      clean_rap(rap_dir, rap_file, base) if rap_already_deployed?(rap_dir)
+      deploy_rap(rap_file, rap_dir, base)
+    end
+  end
+
+  def initial(webapps_dir)
+    Dir.entries(webapps_dir).each do |entry|
+      if entry.match(/.rap$/)
+        decide(:create, webapps_dir, entry, 'file')
+      end
+    end
+    `cd #{webapps_dir}/thundercat; ./start.sh`
+  end
+
+  private
+
+  def deploy_rap(rap_file, rap_dir, base)
+    Rappa.new(:input_archive => rap_file, :output_archive => base).expand
+    rap_config = rap_dir + '/rap.yml'
+    if File.exists?(rap_config)
+      rap = YAML.load_file(rap_config)
+      start_script = rap[:start_script]
+      stop_script = rap[:stop_script]
+      bootstrap_script = rap[:bootstrap]
+      p "1. found boostrap script: #{bootstrap_script}"
+      `cd #{rap_dir} ; chmod +x #{start_script}`
+      `cd #{rap_dir} ; chmod +x #{stop_script}`
+      if !bootstrap_script.nil?
+        p "2. found boostrap script: #{bootstrap_script}"
+        `cd #{rap_dir} ; chmod +x #{bootstrap_script}`
+        puts "[Thundercat] executing boostrap: #{bootstrap_script}"
+        puts `cd #{rap_dir} ; ./#{bootstrap_script}`
+      end
+      `cd #{rap_dir} ; ./#{start_script}`
+      puts "[ThunderCat] Successfully deployed and started app at: #{rap_file}"
+      archive_rap(rap_file,base)
+    else
+      puts '[ThunderCat] no rap file found so could not start app'
+    end
+
+  end
+
+  def stop_app(rap_dir)
+    rap_file = rap_dir + '/rap.yml'
+    if File.exists?(rap_file)
+      rap = YAML.load_file(rap_file)
+      stop_script = rap[:stop_script]
+      `cd #{rap_dir} ; chmod +x #{stop_script}`
+      `cd #{rap_dir} ; ./#{stop_script}`
+    else
+      puts '[ThunderCat] no rap file found so could not stop app'
+    end
+  end
+
+  def archive_existing_app(rap_dir, rap_file, base)
+    FileUtils.mv(rap_dir, "#{base}/../archive/#{file_without_ext(rap_file)}.#{Time.now.to_i}")
+  end
+
+  def archive_rap(rap_file,base)
+    FileUtils.mv(rap_file, "#{base}/../archive/#{file_without_ext(rap_file)}.#{Time.now.to_i}.rap")
+    puts "[ThunderCat] archived rap file: #{rap_file}"
+  end
+
+  def rap_already_deployed?(rap_dir)
+    File.exists?(rap_dir)
+  end
+
+  def clean_rap(rap_dir, rap_file, base)
+    stop_app(rap_dir)
+    archive_existing_app(rap_dir, rap_file, base)
+  end
+
+  def path_without_ext(file, base)
+    base_name = File.basename(file)
+    base + '/' + base_name.chomp(File.extname(base_name))
+  end
+
+  def file_without_ext(file)
+    base_name = File.basename(file)
+    base_name.chomp(File.extname(base_name))
+  end
+
+end
+
+
+class Monitor
+
+  def self.go
+    begin
+      webapps_dir = File.dirname(__FILE__) + '/webapps'
+      Decision.new.initial(webapps_dir)
+      FSSM.monitor(webapps_dir, '**/*.rap', :directories => true) do
+        update { |base, relative, type| puts "updated #{base}, #{relative}, #{type}" }
+        delete { |base, relative, type| puts  "delete #{base}, #{relative}, #{type}" }
+        create { |base, relative, type| Decision.new.decide(:create, base, relative, type) }
+      end
+    rescue => e
+      puts "[ThunderCat] Monitor encountered an error: #{e}"
+    end
+  end
+
+end
+
+Dante.run('monitor') do |opts|
+  Monitor.go
+end
+
+
+

data/src/monitor/start.sh

@@ -0,0 +1 @@
+./monitor.rb -P ./log/monitor.pid -d -l ./log/monitor.log

data/src/monitor/stop.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+require 'fileutils'
+
+begin
+
+pid = File.read(File.dirname(__FILE__) + '/log/monitor.pid').strip
+`kill -9 #{pid}`
+FileUtils.rm(File.dirname(__FILE__) + '/log/monitor.pid')
+puts "[ThunderCat] stopped thundercat monitor with process: #{pid}"
+
+thunder_dir = File.dirname(__FILE__) + '/webapps/thundercat'
+`cd #{thunder_dir} ; chmod +x ./stop.sh`
+puts `cd #{thunder_dir} ; ./stop.sh`
+
+puts "[ThunderCat] stopped thundercat webapp"
+
+rescue => e
+ puts "[ThunderCat] Oops something went wrong: #{e}"
+end

metadata

@@ -0,0 +1,231 @@
+--- !ruby/object:Gem::Specification
+name: thundercat
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Kingsley Hendrickse
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sinatra-formhelpers
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sinatra-single-user-auth
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sucker_punch
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fssm
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thin
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: log4r
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sys-proctable
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! 'Easy way to deploy and monitor Rack applications as .rap archives
+
+'
+email: kingsley@masterthought.net
+executables:
+- /thundercat
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- src/rap/thundercat.rap
+- src/monitor/monitor.rb
+- src/monitor/start.sh
+- src/monitor/stop.sh
+- README.md
+- bin/thundercat
+homepage: https://github.com/masterthought/thundercat
+licenses:
+- Apache 2.0
+post_install_message: 
+rdoc_options: []
+require_paths:
+- src
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Thundercat Rack deployment and monitoring
+test_files: []