require 'optparse' module CloudCrowd class CommandLine # Configuration files required for the `crowd` command to function. CONFIG_FILES = ['config.yml', 'config.ru', 'database.yml'] # Reference the absolute path to the root. CC_ROOT = File.expand_path(File.dirname(__FILE__) + '/../..') # Path to the Daemons gem script which launches workers. WORKER_RUNNER = File.expand_path("#{CC_ROOT}/lib/cloud_crowd/runner.rb") # Command-line banner for the usage message. BANNER = <<-EOS Usage: crowd COMMAND OPTIONS COMMANDS: install Install the CloudCrowd configuration files to the specified directory server Start up the central server (requires a database) workers Control worker daemons, use: (start | stop | restart | status | run) console Launch a CloudCrowd console, connected to the central database load_schema Load the schema into the database specified by database.yml OPTIONS: EOS # Creating a CloudCrowd::CommandLine runs from the contents of ARGV. def initialize parse_options command = ARGV.shift case command when 'console' then run_console when 'server' then run_server when 'workers' then run_workers_command when 'load_schema' then run_load_schema when 'install' then run_install else usage end end # Spin up an IRB session with the CloudCrowd code loaded in, and a database # connection established. The equivalent of Rails' `script/console`. def run_console require 'irb' require 'irb/completion' load_code connect_to_database IRB.start end # Convenience command for quickly spinning up the central server. More # sophisticated deployments, load-balancing across multiple app servers, # should use the config.ru rackup file directly. This method will start # a single Thin server, if Thin is installed, otherwise the rackup defaults # (Mongrel, falling back to WEBrick). The equivalent of Rails' script/server. def run_server ensure_config require 'rubygems' rackup_path = File.expand_path("#{@options[:config_path]}/config.ru") if Gem.available? 'thin' exec "thin -e production -p #{@options[:port]} -R #{rackup_path} start" else exec "rackup -E production -p #{@options[:port]} #{rackup_path}" end end # Load in the database schema to the database specified in 'database.yml'. def run_load_schema load_code connect_to_database require 'cloud_crowd/schema.rb' end # Install the required CloudCrowd configuration files into the specified # directory, or the current one. def run_install require 'fileutils' install_path = ARGV.shift || '.' FileUtils.mkdir_p install_path unless File.exists?(install_path) install_file "#{CC_ROOT}/config/config.example.yml", "#{install_path}/config.yml" install_file "#{CC_ROOT}/config/config.example.ru", "#{install_path}/config.ru" install_file "#{CC_ROOT}/config/database.example.yml", "#{install_path}/database.yml" install_file "#{CC_ROOT}/actions", "#{install_path}/actions", true end # Manipulate worker daemons -- handles all commands that the Daemons gem # provides: start, stop, restart, run, and status. def run_workers_command ensure_config command = ARGV.shift case command when 'start' then start_workers when 'stop' then stop_workers when 'restart' then stop_workers && start_workers when 'run' then run_worker when 'status' then show_worker_status else usage end end # Start up N workers, specified by argument or the number of workers in # config.yml. def start_workers load_code num_workers = @options[:num_workers] || CloudCrowd.config[:num_workers] num_workers.times do `CLOUD_CROWD_CONFIG='#{File.expand_path(@options[:config_path] + "/config.yml")}' ruby #{WORKER_RUNNER} start` end end # For debugging, run a single worker in the current process, showing output. def run_worker exec "CLOUD_CROWD_CONFIG='#{File.expand_path(@options[:config_path] + "/config.yml")}' ruby #{WORKER_RUNNER} run" end # Stop all active workers. def stop_workers `ruby #{WORKER_RUNNER} stop` end # Display the status of all active workers. def show_worker_status puts `ruby #{WORKER_RUNNER} status` end # Print `crowd` usage. def usage puts @option_parser end private # Check for configuration files, either in the current directory, or in # the CLOUD_CROWD_CONFIG environment variable. Exit if they're not found. def ensure_config return if @config_found found = CONFIG_FILES.all? {|f| File.exists? "#{@options[:config_path]}/#{f}" } found ? @config_dir = true : config_not_found end # Parse all options for all actions. # TODO: Think about parsing options per sub-command separately. def parse_options @options = { :port => 9173, :config_path => ENV['CLOUD_CROWD_CONFIG'] || '.' } @option_parser = OptionParser.new do |opts| opts.on('-c', '--config PATH', 'path to configuration directory') do |conf_path| @options[:config_path] = conf_path end opts.on('-n', '--num-workers NUM', OptionParser::DecimalInteger, 'number of worker processes') do |num| @options[:num_workers] = num end opts.on('-p', '--port PORT', 'central server port number') do |port_num| @options[:port] = port_num end opts.on_tail('-v', '--version', 'show version') do load_code puts "CloudCrowd version #{VERSION}" exit end end @option_parser.banner = BANNER @option_parser.parse!(ARGV) end # Load in the CloudCrowd module code, dependencies, lib files and models. # Not all commands require this. def load_code ensure_config require 'rubygems' require "#{CC_ROOT}/lib/cloud-crowd" CloudCrowd.configure("#{@options[:config_path]}/config.yml") end # Establish a connection to the central server's database. Not all commands # require this. def connect_to_database require 'cloud_crowd/models' CloudCrowd.configure_database("#{@options[:config_path]}/database.yml") end # Exit with an explanation if the configuration files couldn't be found. def config_not_found puts "`crowd` can't find the CloudCrowd configuration directory. Please either run `crowd` from inside of the configuration directory, or use `crowd -c path/to/config`" exit(1) end # Install a file and log the installation. def install_file(source, dest, is_dir=false) is_dir ? FileUtils.cp_r(source, dest) : FileUtils.cp(source, dest) puts "installed #{dest}" end end end