bosh_cli_plugin_redis 0.2.0

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bosh_release/.final_builds/jobs/*/*.tgz
+bosh_release/.final_builds/packages/*/*.tgz
+bosh_release/releases/*.tgz
+deployments

data/ChangeLog.md

@@ -0,0 +1,34 @@
+# Change Log
+
+
+## v0.2 - bosh_cli_plugin_redis
+
+Converted into a bosh plugin. Prefix "bosh" to the sub-commands below:
+
+    prepare redis 
+        Prepare bosh for deploying one or more Redis services 
+
+    create redis [--name] [--size] [--security_group] 
+        Create a Redis service deployed upon target bosh 
+        --name           Unique name for service (within bosh & cloud foundry) 
+        --size           Size of provisioned VMs 
+        --security_group Security group to assign to provisioned VMs 
+
+    show redis uri 
+        Show the redis URI for connection via bosh DNS 
+
+    delete redis 
+        Delete current Redis service 
+
+Note: the `cf bind-redis-env-var` command has been removed as it is a) specific to a Cloud Foundry user not a bosh user; b) kinda crappy "services" integration. Perhaps move it back into a cf plugin in future.
+
+## v0.1 - redis-cf-plugin
+
+Initial release! The initial commands offered are:
+
+    cf create-redis               Create a Redis service deployed upon target bosh
+    cf show-redis-uri             Show the redis URI for connection via bosh DNS
+    cf bind-redis-env-var APP     Bind current Redis service URI to current app via env variable
+    cf delete-redis               Delete current Redis service
+
+The redis service URI uses bosh DNS. As such it must be deployed into the same bosh being used for Cloud Foundry.

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+source 'https://s3.amazonaws.com/bosh-jenkins-gems/' # for prerelease bosh_cli
+
+# Specify your gem's dependencies in redis-cf-plugin.gemspec
+gemspec
+
+bosh_cli_path = File.expand_path("~/gems/cloudfoundry/bosh/bosh_cli")
+if File.directory?(bosh_cli_path)
+  gem "bosh_cli", path: bosh_cli_path
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Dr Nic Williams
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,129 @@
+# Dedicate Redis services on AWS or OpenStack
+
+This is a simple `bosh` CLI plugin to create and delete dedicated redis services and provide a simple URI. It runs on AWS or OpenStack via bosh.
+
+Example create/delete scenario that includes binding the redis service to a Cloud Foundry application via environment variables:
+
+```
+$ bosh prepare redis
+$ bosh create redis --name demoredis
+$ bosh show redis uri
+redis://:c1da049a75b3@0.redis.default.demoredis.microbosh:6379/0
+$ cf set-env myapp REDIS_URI redis://:c1da049a75b3@0.redis.default.redis-123.microbosh:6379/0
+
+$ cf unset-env myapp REDIS_URI
+$ bosh delete redis
+```
+
+The resulting redis servers can be discovered and accessed by any systems (such as Cloud Foundry applications) using the same bosh (or microbosh) or a connected DNS.
+
+## Requirements
+
+You must use the same BOSH for deploying redis as you use to deploy Cloud Foundry (unless your DNS is configured to be shared across the two BOSH).
+
+It is also requried that you have login access to the same BOSH being used to deploy your Cloud Foundry.
+
+Confirm this by running:
+
+```
+$ bosh status
+$ bosh deployments
+```
+
+The former will confirm you are targeting a bosh. The latter will display the deployments. One of which should be your Cloud Foundry.
+
+## Installation
+
+Install via RubyGems:
+
+```
+$ gem install bosh_cli "~> 1.5.0.pre" --source https://s3.amazonaws.com/bosh-jenkins-gems/ 
+$ gem install bosh_cli_plugin_redis
+```
+
+The `bosh_cli` gem is currently only available from S3, rather than RubyGem itself. So it needs to be installed first.
+
+## Usage
+
+Each time you install the latest `redis-cf-plugin` you will want to re-upload the latest available redis release to your bosh. If no newer release is available then nothing good nor bad will occur.
+
+```
+$ bosh prepare redis
+Uploading new redis release to bosh...
+```
+
+To create/provision a new redis service you run the following command. By default, it will select the smallest known instance size.
+
+```
+$ bosh create redis myapp-redis
+$ bosh create redis myapp-redis --size small
+$ bosh create redis myapp-redis --size medium
+$ bosh create redis myapp-redis --size large
+$ bosh create redis myapp-redis --size xlarge
+```
+
+NOTE: By default, the `default` security group is used. It must have port `6379` open.
+
+To chose a different security group, use the `--security-group` option:
+
+```
+$ bosh create redis --security-group redis-server
+```
+
+To see the list of available instance sizes or to edit the list of available instance size, see the section "Customizing" below.
+
+* TODO - how to show available instance sizes
+* TODO - how to update a redis server to a different instance size/flavor
+* TODO - how to update the persistent disk for the redis server
+
+## Customizing
+
+* TODO - how to edit available instance sizes (via the bosh deployment file templates)
+
+## Releasing new plugin gem versions
+
+There are two reasons to release new versions of this plugin.
+
+1. Package the latest [redis-boshrelease](https://github.com/cloudfoundry-community/redis-boshrelease) bosh release (which describes how the redis service is implemented)
+2. New features or bug fixes to the plugin
+
+To package the latest "final release" of the redis bosh release into this source repository, run the following command:
+
+```
+$ cd /path/to/releases
+$ git clone https://github.com/cloudfoundry-community/redis-boshrelease.git
+$ cd -
+$ rake bosh:release:import[/path/to/releases/redis-boshrelease]
+# for zsh shell quotes are required around rake arguments:
+$ rake bosh:release:import'[/path/to/releases/redis-boshrelease]'
+```
+
+Note: only the latest "final release" will be packaged. See https://github.com/cloudfoundry-community/redis-boshrelease#readme for information on creating new bosh releases.
+
+To locally test the plugin (`bosh` cli loads plugins from its local path automatically):
+
+```
+$ cf /path/to/bosh_cli_plugin_redis
+$ bosh redis
+```
+
+To release a new version of the plugin as a RubyGem:
+
+1. Edit `bosh_cli_plugin_redis.gemspec` to update the major or minor or patch version.
+2. Run the release command:
+
+```
+$ rake release
+```
+
+## Contributing
+
+For fixes or features to the `bosh_cli_plugin_redis` (`bosh redis`) plugin:
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+For fixes or features to the redis bosh release, please visit https://github.com/cloudfoundry-community/redis-boshrelease. Final releases of `redis-boshrelease` will be distributed in future gem versions of this plugin.

data/Rakefile

@@ -0,0 +1,43 @@
+require "bundler/gem_tasks"
+
+bosh_release = "redis-boshrelease"
+target_bosh_release_path = File.expand_path("../bosh_release", __FILE__)
+
+namespace :bosh do
+  namespace :release do
+    desc "Import latest #{bosh_release}"
+    task :import, :path do |t, args|
+      source_bosh_release = File.expand_path(args[:path])
+      unless File.directory?(source_bosh_release)
+        $stderr.puts "Please pass path to source bosh release"
+        exit 1
+      end
+
+      sh "rm -rf #{target_bosh_release_path}"
+
+      # required directories to pass bosh_cli validations
+      %w[config jobs packages src].each do |dir|
+        sh "mkdir -p #{target_bosh_release_path}/#{dir}"
+        sh "touch #{target_bosh_release_path}/#{dir}/.gitkeep"
+      end
+
+      chdir(target_bosh_release_path) do
+        sh "cp -R #{source_bosh_release}/releases #{target_bosh_release_path}"
+        sh "cp -R #{source_bosh_release}/templates #{target_bosh_release_path}"
+
+        sh "cp -R #{source_bosh_release}/.final_builds #{target_bosh_release_path}"
+        sh "cp -R #{source_bosh_release}/config/final.yml #{target_bosh_release_path}/config"
+      end
+    end
+
+    desc "Remove any large temporary tgz from internal bosh_release"
+    task :clean do
+      chdir(target_bosh_release_path) do
+        sh "ls .final_builds/**/*.tgz | xargs rm; true"
+        sh "ls releases/**/*.tgz | xargs rm; true"
+      end
+    end
+  end
+end
+
+task :release => "bosh:release:clean"

data/bosh_cli_plugin_redis.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+Gem::Specification.new do |spec|
+  spec.name          = "bosh_cli_plugin_redis"
+  spec.version       = "0.2.0"
+  spec.authors       = ["Dr Nic Williams"]
+  spec.email         = ["drnicwilliams@gmail.com"]
+  spec.description   = %q{Create dedicated Redis servers using Bosh}
+  spec.summary       = %q{Create dedicated Redis servers using Bosh}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "bosh_cli", "~> 1.5.0.pre"
+  spec.add_runtime_dependency "rake"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+end

data/bosh_release/.final_builds/jobs/redis/index.yml

@@ -0,0 +1,7 @@
+---
+builds:
+  !binary "ODk5Mzk1NzViM2ZkZGZlYjc4ZTk0NjNiNmI2Y2E5MDY3ZTczMDI2Zg==":
+    blobstore_id: 7b088545-1abf-4c52-a75d-efcc9172e04c
+    version: 1
+    sha1: !binary |-
+      MmRmNzYwY2I0ZGJiODdhYzE0YTBiZGMwYzBhNTU5OTc2NWViMzU2Mg==

data/bosh_release/.final_builds/packages/redis/index.yml

@@ -0,0 +1,7 @@
+---
+builds:
+  !binary "MDY3Y2QwMjVmNjFlZjAxNjI1NzFhYTg2NTQwYTE1OGMwOWE3YzM2Ng==":
+    blobstore_id: b51c851a-eab2-41cd-8b76-f714b1adb6bb
+    version: 1
+    sha1: !binary |-
+      OGJlZjUyYzQ2ZmRlNWI5ZWMwYzliYzVkY2I2YjQ2MjYxYmYzYTEwOA==

data/bosh_release/config/final.yml

@@ -0,0 +1,10 @@
+---
+blobstore:
+  provider: s3
+  options:
+    bucket_name: redis-boshrelease
+    access_key_id: AKIAJPWUHOHV42IMTNQQ
+    secret_access_key: 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
+    encryption_key: cloudfoundry-community
+min_cli_version: 1.5.0.pre.699
+final_name: redis

data/bosh_release/releases/index.yml

@@ -0,0 +1,4 @@
+---
+builds:
+  !binary "ZWU0YzZkYjNlY2Q2YjVkNWE4NjRlZmU5MGNiZTZiMzRmZjVmZWY5ZQ==":
+    version: 1

data/bosh_release/releases/redis-1.yml

@@ -0,0 +1,20 @@
+---
+packages:
+- name: redis
+  version: 1
+  sha1: !binary |-
+    OGJlZjUyYzQ2ZmRlNWI5ZWMwYzliYzVkY2I2YjQ2MjYxYmYzYTEwOA==
+  fingerprint: !binary |-
+    MDY3Y2QwMjVmNjFlZjAxNjI1NzFhYTg2NTQwYTE1OGMwOWE3YzM2Ng==
+  dependencies: []
+jobs:
+- name: redis
+  version: 1
+  fingerprint: !binary |-
+    ODk5Mzk1NzViM2ZkZGZlYjc4ZTk0NjNiNmI2Y2E5MDY3ZTczMDI2Zg==
+  sha1: !binary |-
+    MmRmNzYwY2I0ZGJiODdhYzE0YTBiZGMwYzBhNTU5OTc2NWViMzU2Mg==
+commit_hash: 59e77715
+uncommitted_changes: true
+name: redis
+version: 1

data/bosh_release/templates/aws/sample_deployment_file.yml

@@ -0,0 +1,16 @@
+# Then target that deployment file:
+#
+#     $ bosh deployment path/to/file/above
+#
+# Then apply this template:
+#
+#     $ bosh diff templates/aws/single_vm.yml.erb
+#
+---
+name: NAME
+director_uuid: UUID
+networks: {}
+properties:
+  redis:
+    resource: medium
+    security_group: redis-server

data/bosh_release/templates/aws/single_vm.yml.erb

@@ -0,0 +1,107 @@
+---
+<%-
+# Example source deployment file that can be used:
+# ---
+# name: NAME
+# director_uuid: 4ae3a0f0-70a5-4c0d-95f2-7fafaefe8b9e
+# networks: {}
+# properties:
+#   redis:
+#     instance_type: m1.medium
+#     security_groups: redis-server
+#
+# Then target that deployment file:
+#
+#     $ bosh deployment path/to/file/above
+#
+# Then apply this template:
+#
+#     $ bosh diff templates/aws/single_vm.yml.erb
+#
+redis_sg = find("properties.redis.security_group")
+redis_port = 6379
+redis_password = random_string 12, :redis
+redis_resource = find("properties.redis.resource")
+-%>
+name: <%= find("name") %>
+director_uuid: <%= find("director_uuid") %>
+
+release:
+  name: redis
+  version: latest
+
+compilation:
+  workers: 10
+  network: default
+  reuse_compilation_vms: true
+  cloud_properties:
+    instance_type: m1.small
+
+update:
+  canaries: 1
+  canary_watch_time: 30000-300000
+  update_watch_time: 30000-300000
+  max_in_flight: 4
+  max_errors: 1
+
+networks:
+- name: default
+  type: dynamic
+  cloud_properties:
+    security_groups:
+    - <%= redis_sg %>
+
+resource_pools:
+- name: small
+  network: default
+  size: <%= redis_resource == "small" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.small
+
+- name: medium
+  network: default
+  size: <%= redis_resource == "medium" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.medium
+
+- name: large
+  network: default
+  size: <%= redis_resource == "large" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.large
+
+- name: xlarge
+  network: default
+  size: <%= redis_resource == "xlarge" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.xlarge
+
+jobs:
+- name: redis
+  template: redis
+  instances: 1
+  resource_pool: <%= redis_resource %>
+  networks:
+  - name: default
+    default:
+    - dns
+    - gateway
+
+properties:
+  redis:
+    resource: <%= redis_resource %>
+    security_group: <%= redis_sg %>
+    port: <%= redis_port %>
+    password: <%= redis_password %>

data/bosh_release/templates/aws/spec

@@ -0,0 +1,13 @@
+---
+resources:
+- small
+- medium
+- large
+- xlarge
+
+properties:
+- name: redis.resource
+  description: Resource/flavor of instance to use
+- name: redis.security_group
+  description: Security group for instance(s). Must have TCP ports 22 & 6379 open.
+  default: default

data/bosh_release/templates/openstack/sample_deployment_file.yml

@@ -0,0 +1,16 @@
+# Then target that deployment file:
+#
+#     $ bosh deployment path/to/file/above
+#
+# Then apply this template:
+#
+#     $ bosh diff templates/openstack/single_vm.yml.erb
+#
+---
+name: NAME
+director_uuid: UUID
+networks: {}
+properties:
+  redis:
+    resource: medium
+    security_group: redis-server

data/bosh_release/templates/openstack/single_vm.yml.erb

@@ -0,0 +1,107 @@
+---
+<%-
+# Example source deployment file that can be used:
+# ---
+# name: NAME
+# director_uuid: 4ae3a0f0-70a5-4c0d-95f2-7fafaefe8b9e
+# networks: {}
+# properties:
+#   redis:
+#     instance_type: m1.medium
+#     security_groups: redis-server
+#
+# Then target that deployment file:
+#
+#     $ bosh deployment path/to/file/above
+#
+# Then apply this template:
+#
+#     $ bosh diff templates/openstack/single_vm.yml.erb
+#
+redis_sg = find("properties.redis.security_group")
+redis_port = 6379
+redis_password = random_string 12, :redis
+redis_resource = find("properties.redis.resource")
+-%>
+name: <%= find("name") %>
+director_uuid: <%= find("director_uuid") %>
+
+release:
+  name: redis
+  version: latest
+
+compilation:
+  workers: 10
+  network: default
+  reuse_compilation_vms: true
+  cloud_properties:
+    instance_type: m1.small
+
+update:
+  canaries: 1
+  canary_watch_time: 30000-300000
+  update_watch_time: 30000-300000
+  max_in_flight: 4
+  max_errors: 1
+
+networks:
+- name: default
+  type: dynamic
+  cloud_properties:
+    security_groups:
+    - <%= redis_sg %>
+
+resource_pools:
+- name: small
+  network: default
+  size: <%= redis_resource == "small" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.small
+
+- name: medium
+  network: default
+  size: <%= redis_resource == "medium" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.medium
+
+- name: large
+  network: default
+  size: <%= redis_resource == "large" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.large
+
+- name: xlarge
+  network: default
+  size: <%= redis_resource == "xlarge" ? 1 : 0 %>
+  stemcell:
+    name: bosh-stemcell
+    version: latest
+  cloud_properties:
+    instance_type: m1.xlarge
+
+jobs:
+- name: redis
+  template: redis
+  instances: 1
+  resource_pool: <%= redis_resource %>
+  networks:
+  - name: default
+    default:
+    - dns
+    - gateway
+
+properties:
+  redis:
+    resource: <%= redis_resource %>
+    security_group: <%= redis_sg %>
+    port: <%= redis_port %>
+    password: <%= redis_password %>

data/lib/bosh/cli/commands/redis.rb

@@ -0,0 +1,254 @@
+require "yaml"
+
+# for the #sh helper
+require "rake"
+require "rake/file_utils"
+
+module Bosh::Cli::Command
+  class Redis < Base
+    include FileUtils
+    include Bosh::Cli::Validation
+
+    usage "redis"
+    desc  "show micro bosh sub-commands"
+    def redis_help
+      say("bosh redis sub-commands:")
+      nl
+      cmds = Bosh::Cli::Config.commands.values.find_all {|c|
+        c.usage =~ /redis/
+      }
+      Bosh::Cli::Command::Help.list_commands(cmds)
+    end
+
+    usage "prepare redis"
+    desc "Prepare bosh for deploying one or more Redis services"
+    def prepare_redis
+      within_bosh_release do
+        # the releases/index.yml contains all the available release versions in an unordered
+        # hash of hashes in YAML format:
+        #     --- 
+        #     builds: 
+        #       af61f03c5ad6327e0795402f1c458f2fc6f21201: 
+        #         version: 3
+        #       39c029d0af9effc6913f3333434b894ff6433638: 
+        #         version: 1
+        #       5f5d0a7fb577fec3c09408c94f7abbe2d52a042c: 
+        #         version: 4
+        #       f044d47e0183f084db9dac5a6ef00d7bd21c8451: 
+        #         version: 2
+        release_index = YAML.load_file("releases/index.yml")
+        latest_version = release_index["builds"].values.inject(0) do |max_version, release|
+          version = release["version"]
+          max_version < version ? version : max_version
+        end
+
+        sh "bosh upload release releases/*-#{latest_version}.yml"
+      end
+    end
+
+    # TODO - size must be valid
+    # TODO - name must be unique (cf services & bosh deployments)
+
+    usage "create redis"
+    desc "Create a Redis service deployed upon target bosh"
+    option "--name redis-<timestamp>", String, "Unique bosh deployment name"
+    option "--size small", String, "Size of provisioned VMs"
+    option "--security-group default", String, "Security group to assign to provisioned VMs"
+    def create_redis
+      auth_required
+
+      service_name = options[:name] || default_name
+      resource_size = options[:size] || default_size
+      security_group = options[:security_group] || default_security_group
+      redis_port = 6379
+
+      bosh_status # preload
+      nl
+      say "CPI: #{bosh_cpi}"
+      say "Deployment name: #{service_name.make_green}"
+      say "Resource size: #{resource_size.make_green}"
+      say "Security group: #{security_group.make_green}"
+      nl
+      unless confirmed?("Security group exists with ports 22 & #{redis_port}")
+        cancel_deployment
+      end
+      unless confirmed?("Creating redis service")
+        cancel_deployment
+      end
+
+      template_file = template_file("single_vm.yml.erb")
+
+      # Create an initial deployment file; upon which the CPI-specific template will be applied below
+      # Initial file will look like:
+      # ---
+      # name: NAME
+      # director_uuid: UUID
+      # networks: {}
+      # properties:
+      #   redis:
+      #     resource: medium
+      #     security_group: redis-server
+      deployment_file = "deployments/redis/#{service_name}.yml"
+      step("Checking/creating #{redis_deployments_store_path} for deployment files",
+           "Failed to create #{redis_deployments_store_path} for deployment files", :fatal) do
+        mkdir_p(redis_deployments_store_path)
+      end
+
+      step("Creating deployment file #{deployment_file}",
+           "Failed to create deployment file #{deployment_file}", :fatal) do
+        File.open(deployment_file, "w") do |file|
+          file << {
+            "name" => service_name,
+            "director_uuid" => bosh_uuid,
+            "networks" => {},
+            "properties" => {
+              "redis" => {
+                "resource" => resource_size,
+                "security_group" => security_group
+              }
+            }
+          }.to_yaml
+        end
+
+        stdout = Bosh::Cli::Config.output
+        Bosh::Cli::Config.output = nil
+        deployment_cmd(non_interactive: true).set_current(deployment_file)
+        biff_cmd(non_interactive: true).biff(template_file)
+        Bosh::Cli::Config.output = stdout
+      end
+      # re-set current deployment to show output
+      deployment_cmd.set_current(deployment_file)
+      deployment_cmd(non_interactive: options[:non_interactive]).perform
+    end
+
+    usage "show redis uri"
+    desc "Show the redis URI for connection via bosh DNS"
+    def show_redis_uri
+      load_bosh_and_validate_current_deployment
+      print service_uri
+    end
+
+    usage "delete redis"
+    desc "Delete current Redis service"
+    def delete_redis
+      load_bosh_and_validate_current_deployment
+      deployment_cmd(non_interactive: options[:non_interactive]).delete(deployment_name)
+    end
+
+    protected
+
+    def default_name
+      "redis-#{Time.now.to_i}"
+    end
+
+    def default_size
+      "small"
+    end
+
+    def default_security_group
+      "default"
+    end
+
+    def release_name
+      "redis"
+    end
+
+    def redis_deployments_store_path
+      "deployments/redis"
+    end
+
+    def bosh_release_dir
+      File.expand_path("../../../../../bosh_release", __FILE__)
+    end
+
+    def within_bosh_release(&block)
+      chdir(bosh_release_dir, &block)
+    end
+
+    def bosh_status
+      @bosh_status ||= begin
+        step("Fetching bosh information", "Cannot fetch bosh information", :fatal) do
+           @bosh_status = bosh_director_client.get_status
+        end
+        @bosh_status
+      end
+    end
+
+    def bosh_uuid
+      bosh_status["uuid"]
+    end
+
+    def bosh_cpi
+      bosh_status["cpi"]
+    end
+
+    def template_file(file)
+      File.join(bosh_release_dir, "templates", bosh_cpi, file)
+    end
+
+    # TODO this is now a bosh cli command itself; use #director
+    def bosh_director_client
+      director
+    end
+
+    def deployment_cmd(options = {})
+      cmd = Bosh::Cli::Command::Deployment.new
+      options.each do |key, value|
+        cmd.add_option key.to_sym, value
+      end
+      cmd
+    end
+
+    def biff_cmd(options = {})
+      cmd = Bosh::Cli::Command::Biff.new
+      options.each do |key, value|
+        cmd.add_option key.to_sym, value
+      end
+      cmd
+    end
+
+    # TODO this is now a bosh cli command itself
+    def deployment_file
+      @current_deployment_file ||= ::Bosh::Cli::Command::Deployment.new.deployment
+    end
+
+    # TODO use bosh cli helpers to validate/require this
+    def load_bosh_and_validate_current_deployment
+      auth_required
+      unless File.exists?(deployment_file)
+        err "Target deployment file no longer exists: #{deployment_file}"
+      end
+      @deployment = YAML.load_file(deployment_file)
+      unless @deployment["release"] && @deployment["release"]["name"] == release_name
+        err "Target deployment file is not for redis service: #{deployment_file}"
+      end
+    end
+
+    def deployment_name
+      @deployment["name"]
+    end
+
+    def service_uri
+      password = @deployment["properties"]["redis"]["password"]
+      port = @deployment["properties"]["redis"]["port"]
+      db = 0
+      "redis://:#{password}@#{server_host}:#{port}/#{db}"
+    end
+
+    # returns the first DNS entry for the running instance
+    def server_host
+      @server_host ||= begin
+        vms = bosh_director_client.fetch_vm_state(deployment_name, use_cache: false)
+        if vms.empty?
+          err "Deployment has no running instances"
+        end
+        if vms.size > 1
+          say "#{"WARNING!".make_red} Deployment has more than 1 running instance (#{vms.size}); using first instance"
+        end
+        vm = vms.first
+        # bug in bosh dns means old dns entries might still point to this new VM
+        vm["dns"].select { |dns| dns =~ %r{#{deployment_name}}  }.first
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: bosh_cli_plugin_redis
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
+platform: ruby
+authors:
+- Dr Nic Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bosh_cli
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.0.pre
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.0.pre
+- !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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: Create dedicated Redis servers using Bosh
+email:
+- drnicwilliams@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- ChangeLog.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bosh_cli_plugin_redis.gemspec
+- bosh_release/.final_builds/jobs/redis/index.yml
+- bosh_release/.final_builds/packages/redis/index.yml
+- bosh_release/config/.gitkeep
+- bosh_release/config/final.yml
+- bosh_release/jobs/.gitkeep
+- bosh_release/packages/.gitkeep
+- bosh_release/releases/index.yml
+- bosh_release/releases/redis-1.yml
+- bosh_release/src/.gitkeep
+- bosh_release/templates/aws/sample_deployment_file.yml
+- bosh_release/templates/aws/single_vm.yml.erb
+- bosh_release/templates/aws/spec
+- bosh_release/templates/openstack/sample_deployment_file.yml
+- bosh_release/templates/openstack/single_vm.yml.erb
+- lib/bosh/cli/commands/redis.rb
+homepage: ''
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4389263479679262262
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4389263479679262262
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Create dedicated Redis servers using Bosh
+test_files: []