opsask 2.0.14 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: afaab8b48d1b4b88a6d08b1fa8389047ecabd7d0
-  data.tar.gz: 5465eac2903cd280fbe7ac36529249ab5a202f55
+  metadata.gz: 684e95a8d720907abd8feb1b2a0f735cb3007165
+  data.tar.gz: 4c861f36f2c5935ccfe6a67211786b93708b2577
 SHA512:
-  metadata.gz: 04205e73b621125a06062784682815ae79f609730b8dd8d21a9c3da9b4ba2f2e9fcfff10b4477d664974ed94fcbdb87be23f4ef4a4bb99184ab549f043405c8b
-  data.tar.gz: 56a99dfc8c2f89188fe52157507deaab8de882d1f92883ac9af46843ce9f38a0ebf3bec91b733e0758de517f24bb70c2062c2e8267859d9731963847858f55c3
+  metadata.gz: 0509da3102cca736a57ec2cffa21d7417060daedb9e032c8f61ddc2357deeb5ce7ade8850d03671ab4209e73595ff238575d91d378e9f5e4d0c9e0cafe810a19
+  data.tar.gz: fcdc38a7e4f5270acf4401c946add892ede593acae992685706e2026fe982bae25d5177443ead1901125db930b009b3d55f2b15c021f6c39e5476e3499a0242b

data/Readme.md

@@ -1,3 +1,74 @@
 # OpsAsk
 
-Ask Ops for things.
+Ask Ops for things.
+
+![Sample](http://i.imgur.com/tBFuEAE.png?1)
+
+
+## Usage
+
+    $ opsask help
+    Commands:
+      opsask art             # Show the application art
+      opsask help [COMMAND]  # Describe available commands or one specific command
+      opsask server          # Start application web server
+      opsask version         # Show the application version
+
+You're probably most interested in the `server` command:
+
+    $ opsask help server
+    Usage:
+      opsask server -c, --config=CONFIG
+    
+    Options:
+      -c, --config=CONFIG              # Path to configuration file
+      -p, [--port=N]                   # Set Sinatra port
+                                       # Default: 3000
+      -e, [--environment=ENVIRONMENT]  # Set Sinatra environment
+                                       # Default: development
+      -b, [--bind=BIND]                # Set Sinatra interface
+                                       # Default: 0.0.0.0
+    
+    Start application web server
+
+
+## Configuration
+
+Configuration is JSON:
+
+    {
+      "assignee": "some_user",                     // This user will be assigned
+      "jira_user": "another_user",                 // This user will file JIRAs
+      "jira_pass": "some_really_strong_password",  // We'll need the password, too
+      "jira_url": "http://your.jira",              // Base URL for JIRA installation
+      "queue_size": 5,                             // Limit submissions per day
+      "cutoff_hour": 18,                           // Stop submissions after this hour
+      "project_key": "TEST",                       // Project to file JIRAs under
+      "project_name": "Test",                      // We also need the full name
+      "issue_type": "Task",                        // Kind of JIRA to file
+      "version": "Un-targeted",                    // If required by project
+      "jira_private_key": "/path/to/consumer.pem", // You probably generated it
+      "jira_consumer_key": "consumer-key",         // Name associated with key
+      "require_label": "GoodLabel",                // Scope to label (optional)
+      "ignore_label": "BadLabel"                   // Filter out label (optional)
+    }
+
+To fill out `jira_private_key` and `jira_consumer_key`, you'll need to create
+what JIRA calls an "Application Link" which is unfortunately non-trivial. Here
+are some sample configuration values, which oughta help:
+
+- *Applicaiton Name:* OpsAsk
+- *Application Type:* Generic Application
+- *Service Provider Name:* Your Company, Inc.
+- *Consumer Name:* OpsAsk
+- *Consumer Key:* opsask
+- *Shared secret:* opsask
+- *Consumer Callback URL:* http://opsask/callback
+- *Request Token URL:* http://jira/plugins/servlet/oauth/request-token
+- *Access Token URL:* http://jira/plugins/servlet/oauth/access-token
+- *Authorize URL:* http://jira/plugins/servlet/oauth/authorize
+
+To generate a keypair:
+
+    $ openssl genrsa -out opsask.pem 1024
+    $ openssl rsa -in opsask.pem -pubout -out opsask.pub

data/VERSION

@@ -1 +1 @@
-2.0.14
+2.1.0

data/lib/opsask/main.rb

@@ -23,8 +23,26 @@ module OpsAsk
     end
 
     desc 'server', 'Start application web server'
-    option :port, default: 3000, aliases: :p
-    option :config, default: nil, aliases: :c
+    option :config, \
+      type: :string,
+      aliases: %w[ -c ],
+      desc: 'Path to configuration file',
+      required: true
+    option :port, \
+      type: :numeric,
+      aliases: %w[ -p ],
+      desc: 'Set Sinatra port',
+      default: 3000
+    option :environment, \
+      type: :string,
+      aliases: %w[ -e ],
+      desc: 'Set Sinatra environment',
+      default: 'development'
+    option :bind, \
+      type: :string,
+      aliases: %w[ -b ],
+      desc: 'Set Sinatra interface',
+      default: '0.0.0.0'
     def server
       config = {
         ops_group: 'change-network-operations',
@@ -49,8 +67,12 @@ module OpsAsk
         config.merge! JSON::parse(File.read(options[:config]), symbolize_names: true)
       end
 
-      App.run! port: options[:port], config: config, \
-        environment: 'production', raise_errors: true
+      App.run! \
+        config: config,
+        bind: options[:bind],
+        port: options[:port],
+        environment: options[:environment],
+        raise_errors: true
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opsask
 version: !ruby/object:Gem::Version
-  version: 2.0.14
+  version: 2.1.0
 platform: ruby
 authors:
 - Sean Clemmer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-07 00:00:00.000000000 Z
+date: 2015-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor