f5-icontrol 0.3.1 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 67be269b116b38facac67624090cfbe091f282cd
-  data.tar.gz: 591e3403939a847a88cf58b7bc59449b1354f916
+SHA256:
+  metadata.gz: cbee28f646b9200087841aa35846106d4246bafecd3db0ce256d26dc0945f7fb
+  data.tar.gz: 527e6119839ee1891c3a696477e043eef9e63fadb7249d054252997d49b3c7b6
 SHA512:
-  metadata.gz: cb6cd282e3ab8cfc44094568c260dd767e0162c0a66e60d595d19eebc6cad170def76b6f05f041693b56963f0c312fb0c1c9e362aa71eebc4be82c92b316511b
-  data.tar.gz: 21109f36b56d2908bb6a5b2985d376b1ee9785cd97d687eb20ff2b324f51018371d8519936de704b07dbbac2d03655566fbd6f5c731b71df115649aca67ddb93
+  metadata.gz: 348e4ff11cf46ab6d756bb4b4fab8eecbe676a1a0947958f73f3aa3d9ad4cfc6764a56fa775a2129f760115a77a5c20b0e110b7c79563cf5bd842531ceb4ab80
+  data.tar.gz: 63a0f8df5e1b8624069bcab887ffa5b5cde4833d182a7bef28417b918d6763347de2c49a939a8689f9369899e46c7f3bd504545ab44d65b5b5452c1e621b0a13

data/CHANGELOG.md

@@ -1,4 +1,9 @@
 # Changelog
+
+## 0.3.6
+mattlqx - properly truncate hostname and scheme from reference links
+## 0.3.5
+mattlqx - prevent underscores in pool names
 ## 0.2.5
 swalberg - support setting pool member connection limits
 ## 0.2.4

data/f5-icontrol.gemspec

@@ -22,12 +22,13 @@ Gem::Specification.new do |spec|
   spec.add_dependency "rest-client"
   spec.add_dependency "thor"
   spec.add_dependency "json"
+  spec.add_dependency "wasabi", "<= 3.5.0"
 
   spec.add_development_dependency "awesome_print"
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "byebug"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
-  spec.add_development_dependency "webmock", "~> 2.1.0"
+  spec.add_development_dependency "webmock", "~> 3.7.0"
   spec.add_development_dependency "vcr"
 end

data/lib/f5/cli/application.rb

@@ -25,9 +25,9 @@ module F5
 
       def client
         return @client if @client
-        config = YAML.load_file("#{ENV['HOME']}/.f5.yml")
+        config = YAML.load_file(options[:config])
         if config.key?('username') && options[:lb] == 'default'
-          puts "Warning: credentials in .f5.yml should be put under a named load balancer."
+          puts "Warning: credentials in #{options[:config]} should be put under a named load balancer."
           configure_lb_as(config)
         else
           configure_lb_as config[options[:lb]]
@@ -360,9 +360,120 @@ module F5
 
     end
 
+    class Config < Subcommand
+      desc "list", "Lists the current configuration variables."
+      def list
+        response = client.Management.DBVariable.get_list
+
+        dbVariables = Array(response[:item])
+        if dbVariables.empty?
+          puts "No config variables found"
+        else
+          dbVariables.each do |p|
+            puts "#{p[:name]}: #{p[:value]}"
+          end
+        end
+      end
+    end
+
+    class Device < Subcommand
+      desc "list", "Lists the all devices regardless of device group."
+      def list
+        response = client.Management.Device.get_list
+
+        devices = Array(response[:item])
+        if devices.empty?
+          puts "No devices found"
+        else
+          devices.each do |p|
+            puts p
+          end
+        end
+      end
+    end
+
+    class DeviceGroup < Subcommand
+      desc "list", "Lists the all device groups."
+      def list
+        response = client.Management.DeviceGroup.get_list
+
+        devices = Array(response[:item])
+        if devices.empty?
+          puts "No devices found"
+        else
+          devices.each do |p|
+            puts p
+          end
+        end
+      end
+
+      desc "status DEVICE_GROUP", "Shows the sync status between devices in the specified device group. (Shows status of all device groups of one is not specified.)"
+      def status(device_group=nil)
+        response = client.Management.DeviceGroup.get_sync_status(device_groups: { item: [ device_group ] })
+        puts "STATUS: #{response[:item][:status]}";
+        puts "STATUS COLOR: #{response[:item][:color]}";
+        puts "STATUS DESCRIPTION: #{response[:item][:member_state]}";
+        puts "STATUS SUMMARY: #{response[:item][:summary]}";
+        puts "STATUS DETAILS:"
+        puts response[:item][:details][:item].nil? ? "No further details." : response[:item][:details][:item]
+      end
+
+      desc "sync DEVICE_GROUP DEVICE_WITH_CHANGES_PENDING", "This will sync configs between devices in the specified device group."
+      def sync(device_group, device)
+        device = "#{device.gsub(%r{^/Common/}, '')}"
+        response = client.System.ConfigSync.synchronize_to_group_v2(group: device_group, device: "/Common/#{device}", force: false)
+        if response.nil? || response.empty?
+          puts "Sync completed."
+        else
+          puts "Sync did not complete."
+        end
+      end
+    end
+
+    class VirtualServer < Subcommand
+
+      desc "list", "Lists all the virtual servers"
+      def list
+        response = client.LocalLB.VirtualServer.get_list
+
+        virtualservers = Array(response[:item])
+        if virtualservers.empty?
+          puts "No virtual servers found"
+        else
+          virtualservers.each do |p|
+            puts p
+          end
+        end
+      end
+
+      desc "show VSERVER_NAME", "Shows information about a virtual server"
+      def show(vserver)
+        destination = extract_items client.LocalLB.VirtualServer.get_destination(virtual_servers: { item: [vserver] } )
+        protocol = extract_items client.LocalLB.VirtualServer.get_protocol(virtual_servers: { item: [vserver] } )
+        default_pool = extract_items client.LocalLB.VirtualServer.get_default_pool_name(virtual_servers: { item: [vserver] } )
+
+        puts "%-25s %-20s %-20s %-20s" % ["Destination Address", "Destination Port", "Protocol", "Default Pool"]
+        puts "%-25s %-20s %-20s %-20s" % [destination[:address], destination[:port], protocol.split('_').last, default_pool]
+      end
+
+      desc "status VSERVER_NAME", "Shows the status of the virtual server"
+      def status(vserver)
+        response = client.LocalLB.VirtualServer.get_object_status(virtual_servers: { item: [vserver] } )
+
+        availability = response[:item][:availability_status].split('_').last
+        enabled = response[:item][:enabled_status].split('_').last
+        status_description = response[:item][:status_description]
+
+        puts "%-40s %-20s %-20s %-20s" % ["Name", "Availability", "Enabled", "Status Description"]
+        puts "%-40s %-20s %-20s %-20s" % [vserver, availability, enabled, status_description]
+      end
+    end
+
     class Application < Thor
       class_option :lb, default: 'default'
 
+      class_option :config, :type => :string, :default => "#{ENV['HOME']}/.f5.yml", :desc => "Defines the location of the configuration file."
+
       desc "node SUBCOMMAND ...ARGS", "manage nodes"
       subcommand "node", Node
 
@@ -377,6 +488,18 @@ module F5
 
       desc "vlan SUBCOMMAND ...ARGS", "manage vlans"
       subcommand "vlan", VLAN
+
+      desc "config SUBCOMMAND ...ARGS", "view config values"
+      subcommand "config", Config
+
+      desc "device SUBCOMMAND ...ARGS", "manage devices"
+      subcommand "device", Device
+
+      desc "devicegroup SUBCOMMAND ...ARGS", "manage device groups"
+      subcommand "devicegroup", DeviceGroup
+
+      desc "vserver SUBCOMMAND ...ARGS", "manage virtual servers"
+      subcommand "vserver", VirtualServer
     end
   end
 end

data/lib/f5/icontrol/rapi.rb

@@ -63,7 +63,9 @@ module F5
 
       private
       def url
-        method_chain = @method_chain.gsub /_/, '-'
+        pool_match = @method_chain.match %r{(/pool/[A-Za-z0-9\-_~]+)}
+        method_chain = @method_chain.tr '_', '-'
+        method_chain = method_chain.sub %r{/pool/[A-Za-z0-9\-_~]+}, pool_match[1] unless pool_match.nil?
         method_chain.gsub! %r{^/}, ''
         "https://#{@args[:host]}/#{method_chain}"
       end

data/lib/f5/icontrol/rapi/resource.rb

@@ -15,7 +15,7 @@ module F5
           potential_collection = "#{method}Reference"
           if @args.key? potential_collection
             link = @args[potential_collection]["link"]
-            link.gsub! /^http?s:\/\/localhost\//, ""
+            link.sub! %r{^https?://[A-Za-z0-9\-._]+/}, ""
             return F5::Icontrol::RAPI.new(link, @credentials)
           end
         end

data/lib/f5/icontrol/version.rb

@@ -1,5 +1,5 @@
 module F5
   module Icontrol
-    VERSION = '0.3.1'
+    VERSION = '0.3.7'
   end
 end

data/spec/models/rapi_spec.rb

@@ -40,6 +40,15 @@ describe F5::Icontrol::RAPI do
         expect(WebMock).to have_requested(:get, "#{baseurl}/foo-bar/")
       end
 
+      it "preserves underscores in pool names" do
+        stub_request(:get, "#{baseurl}/pool/foo_bar").
+          to_return(body: pool_collection)
+
+        subject.pool.load('foo_bar')
+
+        expect(WebMock).to have_requested(:get, "#{baseurl}/pool/foo_bar")
+      end
+
       it "understands `each` implicitly calls `get_collection`" do
         stub_request(:get, "#{baseurl}/foo/bar/").
           to_return(body: pool_collection)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: f5-icontrol
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.7
 platform: ruby
 authors:
 - Sean Walberg
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-09-12 00:00:00.000000000 Z
+date: 2020-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: savon
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: wasabi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
 - !ruby/object:Gem::Dependency
   name: awesome_print
   requirement: !ruby/object:Gem::Requirement
@@ -142,14 +156,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: 3.7.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: 3.7.0
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
@@ -480,7 +494,7 @@ homepage: https://github.com/swalberg/f5-icontrol
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -495,9 +509,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: A gem to manage F5 BigIP devices using the iControl API
 test_files: