skull_island 1.2.5 → 1.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4565e0bbd3195b9c1e5848b764328c26d73eb39ba48232327efcde01299c3ac2
-  data.tar.gz: 701f070d2538ab410ab0560e89b8c4171b0b4b893348fcfbd25d5650b6208fb0
+  metadata.gz: 2aee1d0a664e3a03c0ef1139816708264a40d39a324b7698cec10e5ebe303972
+  data.tar.gz: af415232480d26cce9582d68f9e8384dcf0e8027efb7371ad1f9341a5fbd065c
 SHA512:
-  metadata.gz: 75eaf53a4209cba8626f1f38a3729db5a3954ce4877a225dfa2c162d6763883d14be5d17a9e695561aa94feb82e3b03f1a243b3526b839d7d59ba537094f04d4
-  data.tar.gz: 91440fc0feac380f9a8d606a145adcfb1b58a467ad217680d548f8fa893e5b675652babb2341ac43356c57d3ea9650a47e63ca0dde8d0915305ab4714b5f3575
+  metadata.gz: cc1cdf72aee4a83b61284f12da0c80112d7fe66e2ddeeafdaadfe55758228c410a23b3f400e0e3bdb5d2e107f370e2c3766508bc99676f135e7aaefbb30db903
+  data.tar.gz: b119e25b9a1557f5faffb204da95e86a20800dfbe0baec31ecdc816a9d39bd40c795b9010f7c832c1255e6c8cb8266c4cbbb662360b0b1da37a4de9e776c5e58

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    skull_island (1.2.5)
+    skull_island (1.2.6)
       deepsort (~> 0.4)
       erubi (~> 1.8)
       json (~> 2.1)

data/README.md

@@ -37,6 +37,8 @@ Commands:
   skull_island help [COMMAND]                          # Describe available commands or one specific command
   skull_island import [OPTIONS] [INPUT|-]              # Import a configuration from INPUT
   skull_island migrate [OPTIONS] [INPUT|-] [OUTPUT|-]  # Migrate an older config from INPUT to OUTPUT
+  skull_island reset                                   # Fully reset a gateway (removing all config)
+  skull_island version                                 # Display the current installed version of skull_island
 
 Options:
   [--verbose], [--no-verbose]
@@ -138,6 +140,26 @@ If you don't have a previous export, you'll need to install an older version of
 
 While it would be possible to make migration _automatic_ for the `import` command, `skull_island` intentionally doesn't do this to avoid the appearance that the config is losslessly compatible across versions. In reality, the newer config version has additional features (like tagging) that will likely be used heavily. It makes sense to this author to maintain the migration component and the normal functionality as distinct features to encourage the use of the newer capabilities in 1.1+.
 
+### Reset A Gateway
+
+Skull Island can completely clear the configuration from a Kong instance using the `reset` command. **THIS COMMAND WILL COMPLETELY CLEAR YOUR CONFIGURATION!** Since this is a pretty serious command, it requires you to include `--force`, otherwise it simply exits with an error.
+
+Fully resetting a gateway looks like this:
+
+```
+skull_island reset --force
+```
+
+You can, of course, include `--verbose` to see `skull_island` do its work, though the output may be slightly misleading because of the cascading nature of deletions (e.g., deleting a Service will delete all Routes associated with it automatically).
+
+You can also restrict the reset to just resources associated with a particular project using the `--project` flag:
+
+```
+skull_island reset --force --project foo
+```
+
+This assumes the project is called `foo`.
+
 ### Check Installed Version
 
 If you're wondering what version of `skull_island` is installed, use:

data/lib/skull_island/cli.rb

@@ -102,6 +102,29 @@ module SkullIsland
       end
     end
 
+    desc('reset', 'Fully reset a gateway (removing all config)')
+    option :force, type: :boolean, desc: 'Force the reset (required)'
+    option :project, desc: 'Project identifier for metadata'
+    def reset
+      unless options['force']
+        puts '[ERR] Missing --force flag.'
+        exit 2
+      end
+
+      if options['project'] && options['verbose']
+        warn "[WARN] ! Resetting gateway for project '#{options['project']}'"
+      elsif options['verbose']
+        warn '[WARN] ! FULLY Resetting gateway'
+      end
+      [
+        Resources::Certificate,
+        Resources::Consumer,
+        Resources::Upstream,
+        Resources::Service,
+        Resources::Plugin
+      ].each { |clname| reset_class(clname, options['project']) }
+    end
+
     desc('version', 'Display the current installed version of skull_island')
     def version
       puts "SkullIsland Version: #{SkullIsland::VERSION}"
@@ -131,6 +154,16 @@ module SkullIsland
       )
     end
 
+    def reset_class(class_name, project)
+      warn "[WARN] ! Resetting #{class_name.route_key}" if options['verbose']
+      resources = project ? class_name.all.select { |r| r.project == project } : class_name.all
+
+      resources.each do |resource|
+        puts "[WARN] ! Removing #{class_name.name} (#{resource.id})"
+        resource.destroy
+      end
+    end
+
     # Used to pull input from either STDIN or the specified file
     def acquire_input(input_file, verbose = false)
       if input_file == '-'

data/lib/skull_island/version.rb

@@ -4,6 +4,6 @@ module SkullIsland
   VERSION = [
     1, # Major
     2, # Minor
-    5  # Patch
+    6  # Patch
   ].join('.')
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: skull_island
 version: !ruby/object:Gem::Version
-  version: 1.2.5
+  version: 1.2.6
 platform: ruby
 authors:
 - Jonathan Gnagy