conjure 0.2.8 → 0.2.9

data/History.md

@@ -1,3 +1,11 @@
+### Version 0.2.9
+2015-06-24
+
+* Add ssl_hostname and instance_size provisioning options
+* Use volumes to store data for provisioned containers
+* Make provisioned containers restart on reboot
+* Upgrade provisioned Ruby version to 2.2
+
 ### Version 0.2.8
 2014-10-31
 

data/lib/conjure/provision/docker/host.rb

@@ -18,7 +18,7 @@ module Conjure
         end
 
         def started_container_id(image_name, daemon_command, run_options = nil)
-          all_options = "-d #{run_options.to_s} #{image_name} #{daemon_command}"
+          all_options = "#{run_options.to_s} #{image_name} #{daemon_command}"
           @platform.run("docker run #{all_options}").strip
         end
 

data/lib/conjure/provision/docker/image.rb

@@ -9,13 +9,46 @@ module Conjure
           @name = image_name
         end
 
-        def start(command, options = {})
-          container_id = @docker_host.started_container_id @name, command, options[:run_options]
+        def start_volume(options = {})
+          @docker_host.started_container_id @name, "/bin/true", daemon_options(options)
+        end
+
+        def start_daemon(command, options = {})
+          container_id = @docker_host.started_container_id @name, command, daemon_options(options)
           sleep 2
           ip_address = @docker_host.container_ip_address container_id
           raise "Container failed to start" unless ip_address.present?
           ip_address
         end
+
+        private
+
+        def volume_options(options)
+          "-d " + run_options(options)
+        end
+
+        def daemon_options(options)
+          "-d --restart=always " + run_options(options)
+        end
+
+        def run_options(options)
+          [
+            mapped_options("--link", options[:linked_containers]),
+            ("--name #{options[:name]}" if options[:name]),
+            mapped_options("-p", options[:ports]),
+            listed_options("--volumes-from", options[:volume_containers]),
+          ].flatten.compact.join(" ")
+        end
+
+        def listed_options(command, values)
+          values ||= []
+          values.map { |v| "#{command} #{v}" }
+        end
+
+        def mapped_options(command, values)
+          values ||= {}
+          values.map { |from, to| "#{command} #{from}:#{to}" }
+        end
       end
     end
   end

data/lib/conjure/provision/docker/template.rb

@@ -25,6 +25,10 @@ module Conjure
           @commands << "RUN #{command}"
         end
 
+        def volume(name)
+          @commands << "VOLUME #{name}"
+        end
+
         def source
           @commands.join "\n"
         end

data/lib/conjure/provision/instance.rb

@@ -18,7 +18,7 @@ module Conjure
         if options[:local]
           platform = LocalDocker.new
         else
-          platform = Server.create "#{@app_name}-#{@rails_env}"
+          platform = Server.create "#{@app_name}-#{@rails_env}", @options
         end
 
         database = Postgres.new(platform)
@@ -39,7 +39,8 @@ module Conjure
           :ip_address => ip_address,
           :port => port,
           :user => "app",
-          :rails_env => @rails_env
+          :rails_env => @rails_env,
+          :pending_files => webserver.pending_files,
         }
       end
 

data/lib/conjure/provision/passenger.rb

@@ -13,22 +13,52 @@ module Conjure
         @nginx_directives = options[:nginx_directives] || {}
         @system_packages = options[:system_packages] || []
         @rubygems_version = options[:rubygems_version]
+        @use_ssl = !!options[:ssl_hostname]
+        @ssl_hostname = options[:ssl_hostname] || "unknown"
       end
 
       def start 
-        @ip_address = dockerfile.build(@platform).start("/sbin/my_init", start_options)
+        @ip_address = server_template.build(@platform).start_daemon("/sbin/my_init", start_options)
+      end
+
+      def pending_files
+        return [] unless @use_ssl
+        [
+          "/etc/ssl/certs/application.crt",
+          "/etc/ssl/certs/root_and_intermediates.crt",
+          "/etc/ssl/private/application.key",
+          "/etc/ssl/dhparam.pem",
+        ]
       end
 
       private
 
       def start_options
-        {:run_options => "-p 80:80 -p 443:443 -p 2222:22"}
+        {
+          :linked_containers => @database.container_link,
+          :name => "passenger",
+          :ports => {80 => 80, 443 => 443, 2222 => 22},
+          :volume_containers => [data_container_name],
+        }
+      end
+
+      def data_container_name
+        data_template.build(@platform).start_volume(:name => "passenger_data")
+        "passenger_data"
       end
 
-      def dockerfile
+      def data_template
+        file = Docker::Template.new("conjure/passenger-ruby22:1.0.0")
+        file.add_file_data database_yml, "/home/app/application/shared/config/database.yml"
+        file.add_file_data secrets_yml, "/home/app/application/shared/config/secrets.yml"
+        file.volume "/home/app/application"
+        file
+      end
+
+      def server_template
         public_key = File.expand_path("~/.ssh/id_rsa.pub")
         raise "Error: ~/.ssh/id_rsa.pub must exist." unless File.exist?(public_key)
-        file = Docker::Template.new("conjure/passenger-ruby21:1.0.2")
+        file = Docker::Template.new("conjure/passenger-ruby22:1.0.0")
         file.run apt_command if apt_command
         file.run rubygems_command if rubygems_command
         file.add_file public_key, "/root/.ssh/authorized_keys"
@@ -37,9 +67,8 @@ module Conjure
         file.run "chown root.root /root/.ssh/authorized_keys"
         file.add_file_data nginx_conf, "/etc/nginx/sites-available/application-no-ssl.conf"
         file.add_file_data nginx_ssl_conf, "/etc/nginx/sites-available/application-ssl.conf"
-        file.run "ln -s /etc/nginx/sites-available/application-no-ssl.conf /etc/nginx/sites-enabled/application.conf"
-        file.add_file_data database_yml, "/home/app/application/shared/config/database.yml"
-        file.add_file_data secrets_yml, "/home/app/application/shared/config/secrets.yml"
+        which_config = @use_ssl ? "application-ssl" : "application-no-ssl"
+        file.run "ln -s /etc/nginx/sites-available/#{which_config}.conf /etc/nginx/sites-enabled/application.conf"
         file
       end
 
@@ -75,7 +104,7 @@ module Conjure
       def render_template(name)
         template_path = File.join File.dirname(__FILE__), "templates", "#{name}.erb"
         template_data = File.read template_path
-        Erubis::Eruby.new(template_data).result :rails_env => @rails_env
+        Erubis::Eruby.new(template_data).result :rails_env => @rails_env, :ssl_hostname => @ssl_hostname
       end
     end
   end

data/lib/conjure/provision/postgres.rb

@@ -11,23 +11,49 @@ module Conjure
       end
 
       def start
-        @ip_address = dockerfile.build(@platform).start("/sbin/my_init")
+        @ip_address = server_template.build(@platform).start_daemon("/sbin/my_init", start_options)
       end
 
       def rails_config
         {
           "adapter" => "postgresql",
           "database" => @name,
-          "host" => @ip_address,
+          "host" => container_name,
           "username" => "db",
           "password" => @password,
           "template" => "template0",
         }
       end
 
+      def container_link
+        {container_name => container_name}
+      end
+
       private
 
-      def dockerfile
+      def start_options
+        {
+          :name => container_name,
+          :volume_containers => [data_container_name],
+        }
+      end
+
+      def container_name
+        "postgres"
+      end
+
+      def data_container_name
+        data_template.build(@platform).start_volume(:name => "postgres_data")
+        "postgres_data"
+      end
+
+      def data_template
+        file = Docker::Template.new("conjure/postgres93:1.0.0")
+        file.volume "/var/lib/postgresql/9.3/main"
+        file
+      end
+
+      def server_template
         file = Docker::Template.new("conjure/postgres93:1.0.0")
         file.run "echo \"ALTER USER db PASSWORD '#{@password}'\" >/tmp/setpass"
         file.run "/sbin/my_init -- /sbin/setuser postgres sh -c \"sleep 1; psql -f /tmp/setpass\""

data/lib/conjure/provision/server.rb

@@ -31,23 +31,23 @@ module Conjure
       end
 
       def install_swap
-        run "dd if=/dev/zero of=/root/swapfile bs=1024 count=524288"
+        run "dd if=/dev/zero of=/root/swapfile bs=4096 count=524288"
         run "mkswap /root/swapfile; swapon /root/swapfile"
       end
 
-      def self.create(name)
+      def self.create(name, options = {})
         puts "Creating DigitalOcean droplet..."
-        new DigitalOcean::Droplet.new(droplet_options uniquify(name))
+        new DigitalOcean::Droplet.new(droplet_options(uniquify(name), options))
       end
 
-      def self.droplet_options(name)
+      def self.droplet_options(name, options = {})
         raise "Error: DIGITALOCEAN_API_TOKEN must be set." unless ENV["DIGITALOCEAN_API_TOKEN"]
         {
           image: "docker",
           key_data: key_data,
           name: name,
           region: "nyc3",
-          size: "512mb",
+          size: (options[:instance_size] || "512mb"),
           token: ENV["DIGITALOCEAN_API_TOKEN"],
         }
       end

data/lib/conjure/provision/templates/application-no-ssl.conf.erb

@@ -3,6 +3,6 @@ server {
   root /home/app/application/current/public;
   passenger_enabled on;
   passenger_user app;
-  passenger_ruby /usr/bin/ruby2.1;
+  passenger_ruby /usr/bin/ruby2.2;
   passenger_app_env <%= rails_env %>;
 }

data/lib/conjure/provision/templates/application-ssl.conf.erb

@@ -5,23 +5,23 @@ server {
 
 server {
   listen 443 ssl;
+  server_name <%= ssl_hostname %>;
   root /home/app/application/current/public;
   passenger_enabled on;
   passenger_user app;
-  passenger_ruby /usr/bin/ruby2.1;
+  passenger_ruby /usr/bin/ruby2.2;
   passenger_app_env <%= rails_env %>;
 
   ssl_certificate /etc/ssl/certs/application.crt;
   ssl_certificate_key /etc/ssl/private/application.key;
+  ssl_session_timeout 1d;
+  ssl_session_cache shared:SSL:50m;
+  ssl_dhparam /etc/ssl/dhparam.pem;
   ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
-  ssl_ciphers ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+3DES:DH+3DES:RSA+AESGCM:RSA+AES:RSA+3DES:!aNULL:!MD5:!DSS;
+  ssl_ciphers 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA';
   ssl_prefer_server_ciphers on;
-
-  proxy_set_header X-SSL-Subject $ssl_client_s_dn;
-  proxy_set_header X-SSL-Issuer $ssl_client_i_dn;
-  proxy_set_header X-Forwarded-Proto https;
-  proxy_set_header X-Real-IP $remote_addr;
-  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-  proxy_set_header Host $http_host;
-  proxy_redirect off;
+  ssl_stapling on;
+  ssl_stapling_verify on;
+  ssl_trusted_certificate /etc/ssl/certs/root_and_intermediates.crt;
+  resolver 8.8.8.8 8.8.4.4;
 }

data/lib/conjure/service/cloud_server.rb

@@ -1,7 +1,6 @@
 module Conjure
   module Service
     class CloudServer
-      require "fog"
       require "pathname"
       attr_reader :name
 

data/lib/conjure/version.rb

@@ -1,3 +1,3 @@
 module Conjure
-  VERSION = "0.2.8" unless defined?(VERSION)
+  VERSION = "0.2.9" unless defined?(VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: conjure
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.2.9
   prerelease: 
 platform: ruby
 authors:
@@ -9,16 +9,16 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-31 00:00:00.000000000 Z
+date: 2015-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: fog
+  name: net-scp
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.19.0
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,9 +26,9 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.19.0
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: thor
+  name: net-ssh
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -44,7 +44,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: unf
+  name: thor
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -163,54 +163,53 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/conjure.rb
-- lib/conjure/instance.rb
-- lib/conjure/target.rb
-- lib/conjure/provider.rb
 - lib/conjure/application.rb
+- lib/conjure/command.rb
 - lib/conjure/command_target.rb
-- lib/conjure/log.rb
-- lib/conjure/version.rb
 - lib/conjure/config.rb
+- lib/conjure/data_set.rb
+- lib/conjure/digital_ocean/account.rb
+- lib/conjure/digital_ocean/droplet.rb
+- lib/conjure/digital_ocean/key.rb
+- lib/conjure/digital_ocean/key_set.rb
+- lib/conjure/http_request.rb
 - lib/conjure/identity.rb
-- lib/conjure/provision/server.rb
+- lib/conjure/instance.rb
+- lib/conjure/log.rb
+- lib/conjure/provider.rb
+- lib/conjure/provision/docker/host.rb
+- lib/conjure/provision/docker/image.rb
+- lib/conjure/provision/docker/template.rb
 - lib/conjure/provision/instance.rb
+- lib/conjure/provision/local_docker.rb
 - lib/conjure/provision/passenger.rb
 - lib/conjure/provision/postgres.rb
-- lib/conjure/provision/docker/host.rb
-- lib/conjure/provision/docker/template.rb
-- lib/conjure/provision/docker/image.rb
-- lib/conjure/provision/templates/application-ssl.conf.erb
+- lib/conjure/provision/server.rb
 - lib/conjure/provision/templates/application-no-ssl.conf.erb
-- lib/conjure/provision/local_docker.rb
-- lib/conjure/command.rb
-- lib/conjure/data_set.rb
-- lib/conjure/service/digital_ocean_account.rb
-- lib/conjure/service/rails_codebase.rb
-- lib/conjure/service/database/postgres.rb
+- lib/conjure/provision/templates/application-ssl.conf.erb
+- lib/conjure/provision.rb
+- lib/conjure/service/cloud_server.rb
 - lib/conjure/service/database/mysql.rb
-- lib/conjure/service/rails_log_view.rb
-- lib/conjure/service/docker_host.rb
+- lib/conjure/service/database/postgres.rb
 - lib/conjure/service/database.rb
-- lib/conjure/service/cloud_server.rb
+- lib/conjure/service/digital_ocean_account.rb
+- lib/conjure/service/docker_host.rb
+- lib/conjure/service/docker_shell.rb
 - lib/conjure/service/forwarded_shell.rb
+- lib/conjure/service/rails_codebase.rb
+- lib/conjure/service/rails_console.rb
+- lib/conjure/service/rails_log_view.rb
 - lib/conjure/service/rails_server.rb
+- lib/conjure/service/rake_task.rb
 - lib/conjure/service/remote_file_set.rb
 - lib/conjure/service/remote_shell.rb
-- lib/conjure/service/rails_console.rb
-- lib/conjure/service/rake_task.rb
-- lib/conjure/service/docker_shell.rb
 - lib/conjure/service/repository_link.rb
 - lib/conjure/service/volume.rb
-- lib/conjure/provision.rb
-- lib/conjure/notes.txt
-- lib/conjure/view/table_view.rb
+- lib/conjure/target.rb
+- lib/conjure/version.rb
 - lib/conjure/view/application_view.rb
-- lib/conjure/digital_ocean/key.rb
-- lib/conjure/digital_ocean/key_set.rb
-- lib/conjure/digital_ocean/account.rb
-- lib/conjure/digital_ocean/droplet.rb
-- lib/conjure/http_request.rb
+- lib/conjure/view/table_view.rb
+- lib/conjure.rb
 - README.md
 - History.md
 - License.txt
@@ -236,7 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.29
+rubygems_version: 1.8.30
 signing_key: 
 specification_version: 3
 summary: Magically powerful deployment for Rails applications

data/lib/conjure/notes.txt

@@ -1,201 +0,0 @@
-==== New hook-based architecture:
-  1. Proxy app, binds to machine's ports and proxies traffic to other containers
-  2. Deployer app, builds and starts revisions of the app in other containers
-    - Recieves github push notification, builds a new container with the new app revision
-    - Uses a custom-built Dockerfile for the app, designed to rebuild with minimal i/o
-    - After new revision is verified up and running, notifies the proxy to redirect
-    - Could run a small capybara smoke test against the production app
-    - Stops old container. Destroys it? (Rebuilding it should be fast if needed)
-  3. The application itself
-====
-
-1. Add area in conjure repo to build and publish docker images
-  - publish "conjure/passenger-ruby21"
-  - publish "conjure/postgres"
-2. Add isolated conjure commands to work with custom docker images:
-  - "provision [rails-env]"
-    - Creates DO server using DIGITAL_OCEAN_* env vars
-    - Starts conjure/postgres
-    - Installs shared database.yml
-    - Adds 'passenger_app_env ENV' to http{} section of nginx.conf
-    - Starts conjure/passenger-ruby21 linked to postgres
-    - Displays needed Cap info: ip, ssh port, deploy user, app path, rails_env
-  - "addkey [ip] [sshport]"
-3. Add conjure to client app & run "provision staging"
-4. Add Cap to client app and configure staging settings
-5. "cap staging deploy" from client app
-
-==== Steps to deploy w/ Cap:
-
-Dockerfile (webserver):
-  Install passenger/nginx
-  Install likely gem dependencies incl. node
-  Install required ruby version
-Dockerfile (postgres):
-
-Conjure:
-  Provision DigitalOcean Docker instance
-
-  Postgres:
-    Start postgres container
-
-  Passenger:
-    Start webserver container linked to postgres container
-    Install public key in webserver container
-    Install nginx config for app
-    Install shared database.yml
-
-Script in app:
-Capistrano:
-  Deploy current app version
-
-
-TASKS:
-  Remove "label" from prepared shell creation
-    Alternate way to show per-service progress output
-      Log creation and status from each service
-      Log name and IP from docker container creation in verbose mode only
-  Separate platforms vs services
-  Deployment.deploy should become Deployment.create
-
-Instead of passing DockerHost objects around, pass something that
-knows how to provision OS shells (possibly from multiple sources).
-DigitalOceanAccount etc should be an implementation of this interface.
-shell = shell_source.prepare_shell do
-  run "cmd"
-  run "cmd2"
-  environment :key => "value"
-  port 80
-end
-
-Application - the code to be deployed (in the abstract, i.e. in a
-repo not yet copied to the server(s)
-
-Instance - a specific running copy of an application
-  accessed through various interfaces: web address, rails console, etc
-
-Database - n/a, too ambiguous
-Dataset - A specific data set
-  accessed through an interface w/ a specific db protocol.
-
-Deployment should return a shell in the app environment as an
-interface
-
-Deployment should return a DataSet (that possible aggregates multiple
-data sets used by the app). If an app needs a MySQL database, a Redis
-database, and a local directory of user-uploaded files, all these must
-stay in sync with each other and so should be aggregated under a
-single DataSet interface.
-
-Instance should instantiate and provide subsequent access to all
-runtime dependencies of the codebase. This includes the web server,
-data sets, etc. An app's mutable local filesystem should be considered
-a data set too, and probably also the logs.
-
-An Application should be something more abstract than the current
-Codebase. It shouldn't know about the rails environment or the
-database, it should be little more than a reference to a git repo. The
-concept of a "codebase" that's checked out onto the deployment
-server(s) should be something else (maybe just a Volume that a branch
-of the application gets copied to).
-
-But where do the database, logger, cron jobs, and other required
-services get identified and instantiated?
-
-Conjure's basic job is: deploy [something] [somewhere] using
-[platforms]. "Something" is a Service, of which Instance and DataSet
-are both types. "Somewhere" is the desired interface over which the
-new Service will be accessible. "Platform" is the cloud service, local
-VMs, and other combined platforms that will be used to do the
-deployment.
-
-Need a concept for something that has both stdin and stdout (and
-stderr) streams ("Console"?). This is what's returned by a rake task
-or rails console instantiation, to connect it to the user's console,
-and it can also be returned from a CommandShell to give the user
-direct access to that as well.
-
-"Show" output prototype:
-
-# Showing application status (Conjure v1.2.23)
-#        Origin  git@github.com/brianauton/conjure
-# Authorization  OK (using public key)
-# 
-# Deployed Instances:
-# Address      Environment  Branch  Revision
-# 192.168.0.1  production   master  3FA4D099 (up to date)
-#
-# Data Sets:
-# Name          Status    Size
-# production-2  active    2GB
-# production-1  archived  2MB
-
-# Showing instance status (Conjure v1.2.23)
-#     Address  192.168.0.1
-# Environment  production
-#      Branch  master
-#    Revision  3FA4D099 (behind by 2 commits)
-#      Uptime  2 days, 3 hours, 17 minutes
-
-Could have "named" instances ("production-2", user-specified names,
-etc) but "address" is enough to identify instances for now. Should
-guess the specified instance by either ip address, subdomain (when
-supported), or rails_env. Need "deploy" to be a shorthand for either
-"create" or "update" since "deploy staging" is ambiguous if there's
-already a staging instance. Maybe "deploy" should be deprecated?
-
-Needs:
-  Separate commands to "create" and "update" instances
-  Support specific env/branch when creating
-  Preserve existing env/branch when updating
-  Support changing env/branch when updating
-  Support default instance params based on addr/env/other info given
-  Destroy instances
-  Introduce "platforms"
-  Deploy to local docker
-  Deploy to vagrant (?)
-  Progress display
-  Allow specifying SHA for deployment (pull out into object with repo+branch?)
-  Used stored docker images for faster deployment
-
-
-New Refactor (POODR)
-
-  Application-related models:
-    Application - All revisions of the app in abstract (a repo URL for now)
-    ApplicationVersion - Refers to a specific repo/branch/revision
-    ApplicationSource - Unpacked into a file system for reading/writing
-
-  UserPreferredPlatform - used by Command. Takes all user
-  configuration (command line switches, config file, etc) and produces
-  a Platform used to provision services.
-
-  InstanceFactory - takes a Platform and an ApplicationRevision to deploy on it.
-    queries [something] to ask which services the ApplicationRevision needs.
-    queries Instance to create it with the services
-  Instance - associates an ApplicationVersion with multiple Services that support it.
-    traverses the services to find certain kinds (web service, database)
-
-
-Acceptance specs that drive Command and watch for specific output
-Unit specs for Command that expect messages to collaborators
-
-
-[binary]
-  constructs Command with a CommandResultView
-
-Command
-  takes status_view (via constant)
-  sends output to status_view
-
-StatusView
-  takes various *View classes for rendering different types
-  takes output_stream
-  sends output_stream and object for each object rendered
-  sends text output directly to output_stream
-
-ApplicationView
-  takes output_stream and application
-
-Cloud server infrastructure tips:
-http://wblinks.com/notes/aws-tips-i-wish-id-known-before-i-started/