unicorn-ctl 0.1.1 → 0.1.2

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## UnicornCtl Changelog
 
+### 0.1.2 / 2013-09-11
+
+* Added `status` command.
+
 ### 0.1.1 / 2013-09-11
 
 * Added `reopen-logs` command.

data/README.md

@@ -1,13 +1,13 @@
 ## unicornctl - unicorn/rainbows control script
 
-`unicornctl` is a simple and easy to use console tool for managing ruby applications using 
-[unicorn](http://unicorn.bogomips.org/) or [rainbows](http://rainbows.rubyforge.org/) application servers. 
-The tool provides a set of reliable commands to start/stop/restart unicorn instances or upgrade them 
-without or with minimal downtime. `unicornctl` script could easily be used as a base for a startup 
+`unicornctl` is a simple and easy to use console tool for managing ruby applications using
+[unicorn](http://unicorn.bogomips.org/) or [rainbows](http://rainbows.rubyforge.org/) application servers.
+The tool provides a set of reliable commands to start/stop/restart unicorn instances or upgrade them
+without or with minimal downtime. `unicornctl` script could easily be used as a base for a startup
 script for unix operating systems (see examples directory for a Redhat-style startup script example).
 
-Please note, that this is still an alpha-quality software and it could have many issues. If you try it and 
-find any problems, feel free to report them using [Github Issues page](https://github.com/swiftype/unicorn-ctl/issues). 
+Please note, that this is still an alpha-quality software and it could have many issues. If you try it and
+find any problems, feel free to report them using [Github Issues page](https://github.com/swiftype/unicorn-ctl/issues).
 Pull requests are welcome too!
 
 ### Installation
@@ -58,6 +58,10 @@ The following command are supported at the moment:
 * `upgrade` - zero or minimal downtime restart option for a unicorn application. Performs a set of
   steps to start a new copy of the application, test it and then gracefully shut down the old copy.
   If the graceful restart fails for any reason, the application is forcefully restarted.
+* `reopen-logs` - Makes unicorn reopen its log files. This allows logrotate to rotate files atomically
+  and quickly via rename instead of the racy and slow copytruncate method.
+* `status` - Display current application server status. If the server is up, the command exits with exit
+  code 0, otherwise the exit code will be 1.
 
 For more information on unicorn procss management you could check their
 [official documentation page](http://unicorn.bogomips.org/SIGNALS.html).

data/bin/unicornctl

@@ -14,6 +14,7 @@ VALID_COMMANDS = %w[
   force-restart
   upgrade
   reopen-logs
+  status
 ]
 
 #---------------------------------------------------------------------------------------------------
@@ -169,7 +170,7 @@ def start_application!(options)
       # Done
       exit(0)
     else
-      puts "WARNING: Slate pid file found, removing it: #{pid_file}"
+      puts "WARNING: Stale pid file found, removing it: #{pid_file}"
       FileUtils.rm(pid_file)
     end
   end
@@ -240,7 +241,7 @@ def stop_application!(options, graceful = false)
   if pid_running?(pid)
     stop_unicorn_process(pid, options[:timeout], graceful)
   else
-    puts "WARNING: Slate pid file found, removing it: #{pid_file}"
+    puts "WARNING: Stale pid file found, removing it: #{pid_file}"
     FileUtils.rm(pid_file)
   end
 
@@ -257,7 +258,7 @@ def restart_application!(options, graceful)
     if pid_running?(pid)
       stop_unicorn_process(pid, options[:timeout], graceful)
     else
-      puts "WARNING: Slate pid file found, removing it: #{pid_file}"
+      puts "WARNING: Stale pid file found, removing it: #{pid_file}"
       FileUtils.rm(pid_file)
     end
 
@@ -368,7 +369,7 @@ def reopen_logs!(options)
     puts "Sending USR1 signal to process with pid=#{pid}..."
     send_signal('USR1', pid)
   else
-    puts "WARNING: Slate pid file found, removing it: #{pid_file}"
+    puts "WARNING: Stale pid file found, removing it: #{pid_file}"
     FileUtils.rm(pid_file)
   end
 
@@ -376,6 +377,26 @@ def reopen_logs!(options)
   exit(0)
 end
 
+#---------------------------------------------------------------------------------------------------
+def status!(options)
+  # Check pid file
+  pid_file = unicorn_pid_file(options)
+  unless File.exists?(pid_file)
+    puts "No pid file found, the app is not running"
+    exit(1)
+  end
+
+  # Check the process
+  pid = read_pid(pid_file)
+  if pid_running?(pid)
+    puts "The app is running, pid=#{pid}..."
+    exit(0)
+  else
+    puts "Stale pid file found, the app is not running"
+    exit(1)
+  end
+end
+
 #---------------------------------------------------------------------------------------------------
 def show_help(error = nil)
   puts "ERROR: #{error}\n\n" if error
@@ -501,6 +522,9 @@ case command
   when 'reopen-logs'
     reopen_logs!(options)
 
+  when 'status'
+    status!(options)
+
   else
     show_help("ERROR: Invalid command: #{command}")
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: unicorn-ctl
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors: