matsuri 0.1.0 → 0.3.0

data/lib/matsuri/cmds/cli.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Matsuri
+  module Cmds
+    class Cli < Thor
+      include Matsuri::Cmd
+
+      # Don't want to write code to _not_ load in the config, so not going to do it here
+      #class_option :config,  aliases: :c, type: :string, default: File.join(Matsuri::Config.base_path, 'config', 'matsuri.rb')
+      class_option :verbose, aliases: :v, type: :boolean
+      class_option :debug,   aliases: :D, type: :boolean
+
+      desc 'generate SUBCOMMAND ...ARGS', 'generate Matsuri scaffolding'
+      subcommand 'generate', Matsuri::Cmds::Generate
+
+      desc 'kubectl SUBCOMMAND ...ARGS', 'manage kubectl configs'
+      subcommand 'kubectl', Matsuri::Cmds::Kubectl
+
+      desc 'show SUBCOMMAND ...ARGS', 'show resource'
+      subcommand 'show', Matsuri::Cmds::Show
+      map describe: :show
+
+      desc 'diff SUBCOMMAND ...ARGS', 'diff resource (show what would be applied)  '
+      subcommand 'diff', Matsuri::Cmds::Diff
+
+      desc 'status SUBCOMMAND ...ARGS', 'resource status'
+      subcommand 'status', Matsuri::Cmds::Status
+      map top: :status
+
+      desc 'create SUBCOMMAND ...ARGS', 'create resource (kubectl create)'
+      subcommand 'create', Matsuri::Cmds::Create
+      map start: :create
+
+      desc 'apply SUBCOMMAND ...ARGS', 'create or update resource (kubectl apply)'
+      subcommand 'apply', Matsuri::Cmds::Apply
+
+      desc 'rebuild', 'Not Implementd'
+      def rebuild
+        puts "Rebuild not implemented yet"
+        exit (1)
+      end
+
+      desc 'recreate SUBCOMMAND ...ARGS', 'recreate resource'
+      subcommand 'recreate', Matsuri::Cmds::Recreate
+      map restart: :recreate
+
+      desc 'delete SUBCOMMAND ...ARGS', 'delete resource'
+      subcommand 'delete', Matsuri::Cmds::Delete
+      map stop: :delete
+
+      desc 'converge STACK_NAME [IMAGE_TAG]', 'Idempotently converges a stack and all dependencies'
+      option :restart, type: :boolean, default: false
+      option :stack_config, type: :string, banner: 'PATH'
+      def converge(name, image_tag = nil)
+        with_config do |opt|
+          Matsuri::Registry.stack(name)
+            .new(image_tag: image_tag, config: stack_config_data(opt))
+            .converge!(opt)
+        end
+      end
+
+      desc 'reconcile', 'Reconcile and converge cluster-wide resources, such as RBAC and NetworkPolicy'
+      def reconcile
+        with_config do |opt|
+          Matsuri::Tasks::Cluster.new.reconcile!(opt)
+        end
+      end
+
+      desc 'reload STACK_NAME', 'Reloads a stack without recreating underlying pods'
+      def reload(name, image_tag = nil)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new(image_tag: image_tag).reload!(opt)
+        end
+      end
+
+      desc 'scale SUBCOMMAND ...ARGS', 'scale resource'
+      subcommand 'scale', Matsuri::Cmds::Scale
+
+      desc 'migrate STACK_NAME VERSION', 'Migrates a stack to VERSION'
+      def migrate(name, version)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new.migrate!(version, opt)
+        end
+      end
+
+      desc 'update STACK_NAME [VERSION]', 'Updates a stack to VERSION'
+      option :skip_migrations
+      def update(name, version = nil)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new.update!(version, opt)
+        end
+      end
+
+      desc 'sh STACK_NAME', 'Shells into a stack container'
+      option :root, aliases: :r, type: :boolean, default: false
+      option :user, aliases: :u, type: :string
+      option :pod,  aliases: :p, type: :string
+      def sh(name, *args)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new.sh!(opt, args)
+        end
+      end
+
+      desc 'sh! STACK_NAME', 'Shells into a stack container as root'
+      option :pod,  aliases: :p, type: :string
+      def sh!(name, *args)
+        with_config do |opt|
+          opt[:root] = true
+          Matsuri::Registry.stack(name).new.sh!(opt, args)
+        end
+      end
+
+      desc 'console STACK_NAME', 'Gets to the console of a stack'
+      option :root, type: :boolean, default: false
+      option :user, type: :string
+      option :pod,  aliases: :p, type: :string
+      def console(name, *args)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new.console!(opt, args)
+        end
+      end
+
+      desc 'build STACK_NAME', 'Builds docker image for stack'
+      option :dev,         type: :boolean,  default: false
+      option :version,     type: :string
+      option :branch,      type: :string
+      option :github_user, type: :string
+      option :repo,        type: :string
+      def build(name)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new.build!(opt)
+        end
+      end
+
+      desc 'push STACK_NAME', 'Pushes docker image for stack'
+      option :dev,     type: :boolean, default: false
+      option :version, type: :string,  default: 'latest'
+      def push(name)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new.push!(opt)
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/create.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Matsuri
+  module Cmds
+    class Create < Thor
+      include Matsuri::Cmd
+
+      class_option :'no-deps', type: :boolean, default: false
+
+      def self.create_cmd_for(resource_name, image_tag: false)
+        unless image_tag
+          define_method(resource_name) do |name = :not_specified|
+            create_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+          end
+        else
+          define_method(resource_name) do |name = :not_specified, image_tag = nil|
+            create_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new(image_tag: image_tag_for(image_tag)) }
+          end
+        end
+      end
+
+      desc 'pod POD_NAME [IMAGE_TAG]', 'create a pod'
+      create_cmd_for :pod, image_tag: true
+
+      desc 'replica-set RS_NAME [IMAGE_TAG]', 'create a replica set'
+      create_cmd_for :replica_set, image_tag: true
+      map replicaset: :replica_set
+      map rs: :replica_set
+
+      desc 'stateful_set STATEFUL_SET_NAME', 'create a stateful_set'
+      create_cmd_for :stateful_set, image_tag: true
+      map sts: :stateful_set
+
+      desc 'daemon_set DAEMON_SET_NAME', 'create a daemon_set'
+      create_cmd_for :daemon_set, image_tag: true
+      map ds: :daemon_set
+
+      desc 'deployment DEPLOYMENT_NAME [IMAGE_TAG]', 'create a deployment'
+      create_cmd_for :deployment, image_tag: true
+      map deploy: :deployment
+
+      desc 'cron-job CRONJOB_NAME', 'apply changes to a cronjob'
+      create_cmd_for :cron_job, image_tag: true
+      map cj: :cron_job
+      map cronjob: :cron_job
+
+      desc 'service SERVICE_NAME', 'create a service'
+      create_cmd_for :service
+
+      desc 'ingress INGRESS_NAME', 'create a ingress'
+      create_cmd_for :ingress
+
+      desc 'endpoints ENDPOINTS_NAME', 'create an endpoint set'
+      create_cmd_for :endpoints
+
+      desc 'secret SECRET_NAME', 'upload a secret'
+      create_cmd_for :secret
+
+      desc 'config-map CONFIG_MAP_NAME', 'upload a config map'
+      create_cmd_for :config_map
+      map configmap: :config_map
+      map cm: :config_map
+
+      desc 'pv PV_NAME', 'create a persistent volume'
+      create_cmd_for :pv
+
+      desc 'pvc PVC_NAME', 'create a persistent volume claim'
+      create_cmd_for :pvc
+
+      desc 'storage_class STORAGE_CLASS_NAME', 'upload a storage class'
+      create_cmd_for :storage_class
+
+      desc 'horizontal_pod_autoscaler HPA_NAME', 'create a horizontal pod autoscaler'
+      create_cmd_for :horizontal_pod_autoscaler
+      map hpa: :horizontal_pod_autoscaler
+
+      private
+
+      def create_resource
+        with_config do |opt|
+          resource = yield
+          Matsuri::Tasks::KubectlOps.create(resource)
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/delete.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Matsuri
+  module Cmds
+    class Delete < Thor
+      include Matsuri::Cmd
+
+      def self.delete_cmd_for(resource_name)
+        define_method(resource_name) do |name = :not_specified|
+          delete_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+        end
+      end
+
+      desc 'pod POD_NAME', 'delete a pod'
+      delete_cmd_for :pod
+
+      desc 'replica_set REPLICA_SET_NAME', 'delete a replica_set'
+      delete_cmd_for :replica_set
+      map replicaset: :replica_set
+      map rs: :replica_set
+
+      desc 'stateful_set STATEFUL_SET_NAME', 'delete stateful_set'
+      delete_cmd_for :stateful_set
+      map sts: :stateful_set
+
+      desc 'daemon_set DAEMON_SET_NAME', 'delete daemon_set'
+      delete_cmd_for :daemon_set
+      map ds: :daemon_set
+
+      desc 'deployment DEPLOYMENT_NAME', 'delete a deployment'
+      delete_cmd_for :deployment
+      map deploy: :deployment
+
+      desc 'cron-job CRONJOB_NAME', 'apply changes to a cronjob'
+      delete_cmd_for :cron_job
+      map cj: :cron_job
+      map cronjob: :cron_job
+
+      desc 'service SERVICE_NAME', 'delete a service'
+      delete_cmd_for :service
+
+      desc 'ingress INGRESS_NAME', 'delete a ingress'
+      delete_cmd_for :ingress
+
+      desc 'endpoints ENDPOINTS_NAME', 'delete an endpoint set'
+      delete_cmd_for :endpoints
+
+      desc 'stack STACK_NAME', 'deletes all resources in a stack'
+      def stack(name = :not_specified)
+        with_config do |opt|
+          Matsuri::Registry.fetch_or_load(:stack, name).new.delete!
+        end
+      end
+
+      desc 'secret SECRET_NAME', 'delete a secret'
+      delete_cmd_for :secret
+
+      desc 'config-map CONFIG_MAP_NAME', 'delete a config map'
+      delete_cmd_for :config_map
+      map configmap: :config_map
+      map cm: :config_map
+
+      desc 'horizontal_pod_autoscaler HPA_NAME', 'delete a horizontal pod autoscaler'
+      delete_cmd_for :horizontal_pod_autoscaler
+      map hpa: :horizontal_pod_autoscaler
+
+      desc 'pv PV_NAME', 'delete a persistent volume'
+      delete_cmd_for :pv
+
+      desc 'pvc PVC_NAME', 'delete a persistent volume claim'
+      delete_cmd_for :pvc
+
+      desc 'storage_class STORAGE_CLASS_NAME', 'delete a storage class'
+      delete_cmd_for :storage_class
+
+      private
+
+      def delete_resource
+        with_config do |opt|
+          resource = yield
+          Matsuri::Tasks::KubectlOps.delete(resource)
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/diff.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'matsuri/core_ext'
+
+module Matsuri
+  module Cmds
+    class Diff < Thor
+      include Matsuri::Cmd
+
+      class_option :primary_container, aliases: :p, type: :boolean, default: false
+      class_option :hash_diff,         type: :boolean, default: false
+
+      def self.diff_cmd_for(resource_name, image_tag: false)
+        unless image_tag
+          define_method(resource_name) do |name = :not_specified|
+            diff_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+          end
+        else
+          define_method(resource_name) do |name = :not_specified, image_tag = nil|
+            diff_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new(image_tag: image_tag_for(image_tag)) }
+          end
+        end
+      end
+
+      desc 'stack STACK_NAME', 'diff manifests for all stack members'
+      option :stack_config, type: :string, banner: 'PATH'
+      def stack(name = :not_specified)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new(config: stack_config_data(opt)).diff!(opt)
+        end
+      end
+
+      desc 'pod POD_NAME', 'diff manifest for pod'
+      diff_cmd_for :pod, image_tag: true
+
+      desc 'replica_set REPLICA_SET_NAME', 'diff manifest for replica_set'
+      diff_cmd_for :replica_set, image_tag: true
+      map replicaset: :replica_set
+      map rs: :replica_set
+
+      desc 'stateful_set STATEFUL_SET_NAME', 'diff manifest for stateful_set'
+      diff_cmd_for :stateful_set, image_tag: true
+      map sts: :stateful_set
+
+      desc 'daemon_set DAEMON_SET_NAME', 'diff manifest for daemon_set'
+      diff_cmd_for :daemon_set, image_tag: true
+      map ds: :daemon_set
+
+      desc 'deployment DEPLOYMENT_NAME', 'diff manifest for deployment'
+      diff_cmd_for :deployment, image_tag: true
+      map deploy: :deployment
+
+      desc 'cron-job CRONJOB_NAME', 'apply changes to a cronjob'
+      diff_cmd_for :cron_job, image_tag: true
+      map cj: :cron_job
+      map cronjob: :cron_job
+
+      desc 'service SERVICE_NAME', 'diff manifest for service'
+      diff_cmd_for :service
+
+      desc 'ingress INGRESS_NAME', 'diff manifest for ingress'
+      diff_cmd_for :ingress
+
+      desc 'endpoints ENDPOINT_NAME', 'diff manifest for endpoints'
+      diff_cmd_for :endpoints
+
+      desc 'secret SECRET_NAME', 'diff a secret'
+      diff_cmd_for :secret
+
+      desc 'config_map CONFIG_MAP_NAME', 'diff a config map'
+      diff_cmd_for :config_map
+      map configmap: :config_map
+      map cm: :config_map
+
+      desc 'horizontal_pod_autoscaler HPA_NAME', 'diff a horizontal pod autoscaler'
+      diff_cmd_for :horizontal_pod_autoscaler
+      map hpa: :horizontal_pod_autoscaler
+
+      desc 'pv PV_NAME', 'diff manifest for persistent volume'
+      diff_cmd_for :pv
+
+      desc 'pvc PVC_NAME', 'diff manifest for persistent volume claim'
+      diff_cmd_for :pvc
+
+      desc 'storage_class STORAGE_CLASS_NAME', 'diff manifest for storage class'
+      diff_cmd_for :storage_class
+
+      private
+
+      def diff_resource
+        with_config do |opt|
+          resource = yield opt
+          # --primary-container is a HashDiff-only projection, so it
+          # implies --hash-diff
+          if opt[:hash_diff] || opt[:primary_container]
+            Matsuri::Tasks::HashDiff.new(resource: resource, primary_container: opt[:primary_container]).run!
+          else
+            Matsuri::Tasks::KubectlOps.diff(resource)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/generate.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Matsuri
+  module Cmds
+    class Generate < Thor
+      include Matsuri::Cmd
+
+      def self.generate_cmd_for(resource_name)
+        define_method(resource_name) do |name = :not_specified|
+          generate_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+        end
+      end
+
+      private
+
+      def generate_resource
+        with_config do |opt|
+          resource = yield
+          resource.generate_template!
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/kubectl.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Matsuri
+  module Cmds
+    class Kubectl < Thor
+      include Matsuri::Cmd
+
+      desc 'setup', 'generate aliases for kubectl context'
+      def setup
+        with_config do |opt|
+          Matsuri::Tasks::Kubectl.new(opt).setup!
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/recreate.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Matsuri
+  module Cmds
+    class Recreate < Thor
+      include Matsuri::Cmd
+
+      class_option :r, desc: 'recreate dependencies', type: :boolean, default: false
+
+      def self.recreate_cmd_for(resource_name, image_tag: false)
+        unless image_tag
+          define_method(resource_name) do |name = :not_specified|
+            recreate_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+          end
+        else
+          define_method(resource_name) do |name = :not_specified, image_tag = nil|
+            recreate_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new(image_tag: image_tag_for(image_tag)) }
+          end
+        end
+      end
+
+      desc 'pod POD_NAME [IMAGE TAG]', 'recreate a pod'
+      recreate_cmd_for :pod, image_tag: true
+
+      desc 'replica-set REPLICA_SET_NAME [IMAGE TAG]', 'recreate a replica set'
+      recreate_cmd_for :replica_set, image_tag: true
+      map replicaset: :replica_set
+      map rs: :replica_set
+
+      desc 'stateful_set STATEFUL_SET_NAME', 'recreate a stateful_set'
+      recreate_cmd_for :stateful_set, image_tag: true
+      map sts: :stateful_set
+
+      desc 'daemon_set DAEMON_SET_NAME', 'recreate a daemon_set'
+      recreate_cmd_for :daemon_set, image_tag: true
+      map ds: :daemon_set
+
+      desc 'deployment DEPLOYMENT_NAME [IMAGE TAG]', 'recreate a deployment'
+      recreate_cmd_for :deployment, image_tag: true
+      map deploy: :deployment
+
+      desc 'horizontal_pod_autoscaler HPA_NAME', 'recreate a horizontal pod autoscaler'
+      recreate_cmd_for :horizontal_pod_autoscaler
+      map hpa: :horizontal_pod_autoscaler
+
+      desc 'service SERVICE_NAME', 'recreate a service'
+      recreate_cmd_for :service
+
+      desc 'ingress INGRESS_NAME', 'recreate a ingress'
+      recreate_cmd_for :ingress
+
+      desc 'endpoints ENDPOINTS_NAME', 'recreate an endpoint set'
+      recreate_cmd_for :endpoints
+
+      private
+
+      def recreate_resource
+        with_config do |opt|
+          resource = yield
+          Matsuri::Tasks::KubectlOps.recreate(resource)
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/scale.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Matsuri
+  module Cmds
+    class Scale < Thor
+      include Matsuri::Cmd
+
+      def self.scale_cmd_for(resource_name)
+        define_method(resource_name) do |name = :not_specified, replicas|
+          scale_resource(replicas) { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+        end
+      end
+
+      desc 'replica-set RS_NAME REPLICAS', 'scale a replica set'
+      scale_cmd_for :replica_set
+      map replicaset: :replica_set
+      map rs: :replica_set
+
+      desc 'stateful_set STATEFUL_SET_NAME', 'scale a stateful_set'
+      scale_cmd_for :stateful_set
+      map sts: :stateful_set
+
+      desc 'deployment DEPLOYMENT_NAME REPLICAS', 'scale a deployment'
+      scale_cmd_for :deployment
+      map deploy: :deployment
+
+      private
+
+      def scale_resource(replicas)
+        with_config do |opt|
+          resource = yield
+          Matsuri::Tasks::KubectlOps.scale(resource, replicas)
+        end
+      end
+    end
+  end
+end

data/lib/matsuri/cmds/show.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'matsuri/core_ext'
+
+module Matsuri
+  module Cmds
+    class Show < Thor
+      include Matsuri::Cmd
+
+      class_option :json, aliases: :j, type: :boolean, default: false
+
+      def self.show_cmd_for(resource_name, image_tag: false)
+        unless image_tag
+          define_method(resource_name) do |name = :not_specified|
+            show_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new }
+          end
+        else
+          define_method(resource_name) do |name = :not_specified, image_tag = nil|
+            show_resource { Matsuri::Registry.fetch_or_load(resource_name, name).new(image_tag: image_tag_for(image_tag)) }
+          end
+        end
+      end
+
+      desc 'config', 'displays config'
+      def config
+        with_config do |opt|
+          puts opt.inspect if opt[:debug]
+          conf = Matsuri::Config.save(true)
+          platform = Matsuri::Platform.save(true)
+          if options[:json]
+            puts JSON.pretty_generate(conf), JSON.pretty_generate(platform)
+          else
+            puts conf.deep_stringify_keys.to_yaml, platform.deep_stringify_keys.to_yaml
+          end
+        end
+      end
+
+      desc 'stack STACK_NAME', 'show manifests for all stack members'
+      option :stack_config, type: :string, banner: 'PATH'
+      def stack(name = :not_specified)
+        with_config do |opt|
+          Matsuri::Registry.stack(name).new(config: stack_config_data(opt)).show!(opt)
+        end
+      end
+
+      desc 'imported_manifest NAME', 'show imported manifest'
+      show_cmd_for :imported_manifest
+
+      desc 'pod POD_NAME', 'show manifest for pod'
+      show_cmd_for :pod, image_tag: true
+
+      desc 'replica_set REPLICA_SET_NAME', 'show manifest for replica_set'
+      show_cmd_for :replica_set, image_tag: true
+      map replicaset: :replica_set
+      map rs: :replica_set
+
+      desc 'stateful_set STATEFUL_SET_NAME', 'show manifest for stateful_set'
+      show_cmd_for :stateful_set, image_tag: true
+      map sts: :stateful_set
+
+      desc 'daemon_set DAEMON_SET_NAME', 'show manifest for daemon_set'
+      show_cmd_for :daemon_set, image_tag: true
+      map ds: :daemon_set
+
+      desc 'deployment DEPLOYMENT_NAME', 'show manifest for deployment'
+      show_cmd_for :deployment, image_tag: true
+      map deploy: :deployment
+
+      desc 'cron-job CRONJOB_NAME', 'apply changes to a cronjob'
+      show_cmd_for :cron_job, image_tag: true
+      map cj: :cron_job
+      map cronjob: :cron_job
+
+      desc 'service SERVICE_NAME', 'show manifest for service'
+      show_cmd_for :service
+
+      desc 'ingress INGRESS_NAME', 'show manifest for ingress'
+      show_cmd_for :ingress
+
+      desc 'endpoints ENDPOINT_NAME', 'show manifest for endpoints'
+      show_cmd_for :endpoints
+
+      desc 'secret SECRET_NAME', 'show a secret'
+      show_cmd_for :secret
+
+      desc 'config-map CONFIG_MAP_NAME', 'show a config map'
+      map configmap: :config_map
+      show_cmd_for :config_map
+
+      desc 'horizontal_pod_autoscaler HPA_NAME', 'show a horizontal pod autoscaler'
+      show_cmd_for :horizontal_pod_autoscaler
+      map hpa: :horizontal_pod_autoscaler
+
+      desc 'pv PV_NAME', 'show manifest for persistent volume'
+      show_cmd_for :pv
+
+      desc 'pvc PVC_NAME', 'show manifest for persistent volume claim'
+      show_cmd_for :pvc
+
+      desc 'storage_class STORAGE_CLASS_NAME', 'show manifest for storage class'
+      show_cmd_for :storage_class
+
+      desc 'cluster', 'show manifest set for cluster-wide manifests (RBAC, ResourceQuota, NetworkPolicy, etc.)'
+      def cluster
+        with_config { |opt| Matsuri::Tasks::Cluster.new.show!(opt) }
+      end
+
+      private
+
+      def show_resource
+        with_config do |opt|
+          resource = yield opt
+          if options[:json]
+            puts resource.pretty_print
+          else
+            puts resource.to_yaml
+          end
+        end
+      end
+    end
+  end
+end