seira 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c5be00c536176932142946b6895318dc29d53f76
-  data.tar.gz: 2a902ea955ee77f72c174de8672d15def2eef544
+  metadata.gz: 669843ecfb6cfb054f7be793690a37584566cc73
+  data.tar.gz: 9889f757784af3d0ad4634ffd4c211c5abb9799f
 SHA512:
-  metadata.gz: fb4e57972ea5e115b7daa89105662789e74aa9c80bd51a36cd5454331bc88d873610fb532a3e1a528dc2bc7577ad5b47b95b0969006459b06145aa89e480e475
-  data.tar.gz: ecaa4df24618206589985f0e06641243173d0ccef6b11934651f928f10f686b0a3fa8ffad35dd42ff71f6d946c73fea07057c0c861b541b6e77586f4d665e31e
+  metadata.gz: 0ef7516626cf358152b97b9eece4dbd5e1466ad773ff6ee21960cab59fc9bba3be27bbe5b23ba4f7d7d8524e2aa009e633e0069aaf21ff90db106617c4e2e9de
+  data.tar.gz: 2fb02399b82c25635a4d969306ec50ab1aeb3b514aa029d7e9a1bf4dbe60b510eeead7008b83a7a83eb35d58a8a3be50d29b63caca3b4629b850bdb8bcffd372

data/lib/seira.rb

@@ -42,7 +42,9 @@ module Seira
 
       # The cluster and proxy command are not specific to any app, so that
       # arg is not in the ARGV array and should be skipped over
-      if ARGV[1] == 'cluster'
+      if ARGV[0] == 'help'
+        @category = reversed_args.pop
+      elsif ARGV[1] == 'cluster'
         cluster = reversed_args.pop
         @category = reversed_args.pop
         @action = reversed_args.pop
@@ -65,7 +67,10 @@ module Seira
     end
 
     def run
-      if category == 'setup'
+      if category == 'help'
+        run_base_help
+        exit(0)
+      elsif category == 'setup'
         Seira::Setup.new(arg: cluster, settings: settings).run
         exit(0)
       end
@@ -123,5 +128,16 @@ module Seira
     def simple_cluster_change?
       app.nil? && category.nil? # Special case where user is simply changing environments
     end
+
+    def run_base_help
+      puts 'Seira is a library for managing Kubernetes as a PaaS.'
+      puts 'All commands take the following form: `seira <cluster-name> <app-name> <category> <action> <args...>`'
+      puts 'For example, `seira staging foo-app secrets list`'
+      puts "Possible categories: \n\n"
+      CATEGORIES.each do |key, klass|
+        puts "#{key}: #{klass::SUMMARY}"
+      end
+      puts "\nTo get more help for a specific category, run `seira <cluster-name> <app-name> <category> help` command"
+    end
   end
 end

data/lib/seira/app.rb

@@ -6,7 +6,8 @@ require 'fileutils'
 # seira staging specs app bootstrap
 module Seira
   class App
-    VALID_ACTIONS = %w[bootstrap apply upgrade restart scale].freeze
+    VALID_ACTIONS = %w[help bootstrap apply restart scale].freeze
+    SUMMARY = "Bootstrap, scale, configure, restart, your apps.".freeze
 
     attr_reader :app, :action, :args, :context
 
@@ -19,12 +20,12 @@ module Seira
 
     def run
       case action
+      when 'help'
+        run_help
       when 'bootstrap'
         run_bootstrap
       when 'apply'
         run_apply
-      when 'upgrade'
-        run_upgrade
       when 'restart'
         run_restart
       when 'scale'
@@ -34,6 +35,16 @@ module Seira
       end
     end
 
+    def run_help
+      puts SUMMARY
+      puts "\n\n"
+      puts "Possible actions:\n\n"
+      puts "bootstrap: Create new app with main secret, cloudsql secret, and gcr secret in the new namespace."
+      puts "apply: Apply the configuration in kubernetes/<cluster-name>/<app-name> using REVISION environment variable to find/replace REVISION in the YAML."
+      puts "restart: TODO."
+      puts "scale: Scales the given tier deployment to the specified number of instances."
+    end
+
     def run_restart
       # TODO
     end

data/lib/seira/cluster.rb

@@ -5,7 +5,8 @@ require 'fileutils'
 # Example usages:
 module Seira
   class Cluster
-    VALID_ACTIONS = %w[bootstrap].freeze
+    VALID_ACTIONS = %w[help bootstrap].freeze
+    SUMMARY = "For managing whole clusters.".freeze
 
     attr_reader :action, :args, :context, :settings
 
@@ -18,6 +19,8 @@ module Seira
 
     def run
       case action
+      when 'help'
+        run_help
       when 'bootstrap'
         run_bootstrap
       else

data/lib/seira/db.rb

@@ -2,7 +2,8 @@ require 'securerandom'
 
 module Seira
   class Db
-    VALID_ACTIONS = %w[create delete list].freeze
+    VALID_ACTIONS = %w[help create delete list].freeze
+    SUMMARY = "Manage your Cloud SQL Postgres databases.".freeze
 
     attr_reader :app, :action, :args, :context
 
@@ -15,6 +16,8 @@ module Seira
 
     def run
       case action
+      when 'help'
+        run_help
       when 'create'
         run_create
       when 'delete'
@@ -28,6 +31,12 @@ module Seira
 
     private
 
+    def run_help
+      puts SUMMARY
+      puts "\n\n"
+      puts "TODO"
+    end
+
     def run_create
       # We allow overriding the version, so you could specify a mysql version but much of the
       # below assumes postgres for now

data/lib/seira/memcached.rb

@@ -3,7 +3,8 @@ require 'base64'
 
 module Seira
   class Memcached
-    VALID_ACTIONS = %w[list status credentials create delete].freeze
+    VALID_ACTIONS = %w[help list status credentials create delete].freeze
+    SUMMARY = "Manage your Helm Memcached instances.".freeze
 
     attr_reader :app, :action, :args, :context
 
@@ -17,6 +18,8 @@ module Seira
     # TODO: logs, upgrades?, backups, restores, CLI connection
     def run
       case action
+      when 'help'
+        run_help
       when 'list'
         run_list
       when 'status'
@@ -34,6 +37,12 @@ module Seira
 
     private
 
+    def run_help
+      puts SUMMARY
+      puts "\n\n"
+      puts "TODO"
+    end
+
     def run_list
       puts existing_instances
     end

data/lib/seira/pods.rb

@@ -2,7 +2,8 @@ require 'json'
 
 module Seira
   class Pods
-    VALID_ACTIONS = %w[list delete logs top run connect].freeze
+    VALID_ACTIONS = %w[help list delete logs top run connect].freeze
+    SUMMARY = "Manage your application's pods.".freeze
 
     attr_reader :app, :action, :args, :pod_name, :context
 
@@ -16,6 +17,8 @@ module Seira
 
     def run
       case action
+      when 'help'
+        run_help
       when 'list'
         run_list
       when 'delete'
@@ -35,6 +38,12 @@ module Seira
 
     private
 
+    def run_help
+      puts SUMMARY
+      puts "\n\n"
+      puts "TODO"
+    end
+
     def run_list
       puts `kubectl get pods --namespace=#{app} -o wide`
     end

data/lib/seira/proxy.rb

@@ -1,5 +1,7 @@
 module Seira
   class Proxy
+    SUMMARY = "Open up the proxy UI for a given cluster.".freeze
+
     def initialize
     end
 

data/lib/seira/redis.rb

@@ -3,7 +3,8 @@ require 'base64'
 
 module Seira
   class Redis
-    VALID_ACTIONS = %w[list status credentials create delete].freeze
+    VALID_ACTIONS = %w[help list status credentials create delete].freeze
+    SUMMARY = "Manage your Helm Redis instances.".freeze
 
     attr_reader :app, :action, :args, :context
 
@@ -17,6 +18,8 @@ module Seira
     # TODO: logs, upgrades?, backups, restores, CLI connection
     def run
       case action
+      when 'help'
+        run_help
       when 'list'
         run_list
       when 'status'
@@ -34,6 +37,12 @@ module Seira
 
     private
 
+    def run_help
+      puts SUMMARY
+      puts "\n\n"
+      puts "TODO"
+    end
+
     def run_list
       puts existing_instances
     end
@@ -115,7 +124,7 @@ module Seira
 
       file_name = write_config(values)
       unique_name = Seira::Random.unique_name(existing_instances)
-      name = "#{app}-#{unique_name}"
+      name = "#{app}-redis-#{unique_name}"
       puts `helm install --namespace #{app} --name #{name} --wait -f #{file_name} stable/redis`
 
       File.delete(file_name)
@@ -126,7 +135,7 @@ module Seira
     end
 
     def run_delete
-      to_delete = "#{app}-#{args[0]}"
+      to_delete = "#{app}-redis-#{args[0]}"
 
       exit(1) unless HighLine.agree("Are you sure you want to delete #{to_delete}? If any apps are using this redis instance, they will break.")
 

data/lib/seira/secrets.rb

@@ -8,8 +8,9 @@ require 'base64'
 # TODO: Can we avoid writing to disk completely and instead pipe in raw json?
 module Seira
   class Secrets
-    VALID_ACTIONS = %w[get set unset list list-decoded create-pgbouncer-secret].freeze
+    VALID_ACTIONS = %w[help get set unset list list-decoded create-pgbouncer-secret].freeze
     PGBOUNCER_SECRETS_NAME = 'pgbouncer-secrets'.freeze
+    SUMMARY = "Manage your application's secrets and environment variables.".freeze
 
     attr_reader :app, :action, :args, :context
 
@@ -22,6 +23,8 @@ module Seira
 
     def run
       case action
+      when 'help'
+        run_help
       when 'get'
         validate_single_key
         run_get
@@ -64,6 +67,12 @@ module Seira
 
     private
 
+    def run_help
+      puts SUMMARY
+      puts "\n\n"
+      puts "TODO"
+    end
+
     def validate_single_key
       if key.nil? || key.strip == ""
         puts "Please specify a key in all caps and with underscores"
@@ -114,7 +123,7 @@ module Seira
     def run_create_pgbouncer_secret
       db_user = args[0]
       db_password = args[1]
-      write_secrets(secrets: { DB_USER: db_user, DB_PASSWORD: db_password }, secret_name: PGBOUNCER_SECRETS_NAME)
+      puts `kubectl create secret generic #{PGBOUNCER_SECRETS_NAME} --namespace #{app} --from-literal=DB_USER=#{db_user} --from-literal=DB_PASSWORD=#{db_password}`
     end
 
     # In the normal case the secret we are updating is just main_secret_name,

data/lib/seira/setup.rb

@@ -3,6 +3,8 @@ require 'json'
 
 module Seira
   class Setup
+    SUMMARY = "Set up your local CLI with the right project and cluster configuration.".freeze
+
     attr_reader :arg, :settings
 
     def initialize(arg:, settings:)

data/lib/seira/version.rb

@@ -1,3 +1,3 @@
 module Seira
-  VERSION = "0.1.2".freeze
+  VERSION = "0.1.3".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: seira
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Scott Ringwelski