f5-icontrol 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1e2ccf984f9aaa3d6645583ff75c3508be131820
-  data.tar.gz: 78529cded64b45df7353914bfe42559eaaff1903
+  metadata.gz: af1d81830bb6821e3a7ef6040d632673be052a82
+  data.tar.gz: 436e1982d1adc3b0354e93b9f436288f5c24609f
 SHA512:
-  metadata.gz: 86cee5bf0ba8c08134ffc063e25d35a15b942abd26890c3fd988d333b6ab970e8166fad09affe2f8bf4a2d75b36f2bd3a950c299a21f3595140e501c100ed762
-  data.tar.gz: 95fdc349be5609f6fedc0612a70745304636e12be1db3bf0bb328d8f30e694b2fde6e3d395f9e89280e846eb7b22c68b9997618af2bbdc990aa71ec1e7dec437
+  metadata.gz: fa4feeb14c8b10e1f04e17fdc285f40c1712483c937062d4d84baa1e7b365b0a10690c4c4fca87ed5d49165808f4a240a6e2ba30737cd65cd53b1b88316268e8
+  data.tar.gz: 61170981d9e12599418f8b55cef318467ba45fdc9517dc292b28605e250f7c05d6f449ff16510caf1b68225f4f06905c7e2875d37c00520335534513c5788478

data/README.md

@@ -55,9 +55,14 @@ See specs subdir for more examples, especially as it pertains to passing paramet
 There's a command line version that's still being roughed out. You'll need a `~/.f5.yml` file containing your login information:
 
 ```
-host: foo.bar.com
-username: admin
-password: abc123
+default:
+  host: foo.bar.com
+  username: admin
+  password: abc123
+lb2:
+  host: 1.2.3.4
+  username: admin
+  password: abc123
 ```
 
 Then run `f5` and it'll provide help

data/bin/f5

@@ -3,12 +3,4 @@
 require 'f5/cli/application'
 require 'f5/icontrol'
 
-config ||= YAML.load_file("#{ENV['HOME']}/.f5.yml")
-
-F5::Icontrol.configure do |f5|
-  f5.host = config['host']
-  f5.username = config['username']
-  f5.password = config['password']
-end
-
 F5::Cli::Application.start(ARGV)

data/lib/f5/cli/application.rb

@@ -2,7 +2,177 @@ require 'thor'
 
 module F5
   module Cli
-    class Pool < Thor
+    class Subcommand < Thor
+
+      private
+
+      def extract_items(response, opts = nil)
+        items = response[:item]
+
+        if items.nil?
+          return opts == :as_array ? [] : nil
+        end
+
+        if items.is_a?(Hash) && items.has_key?(:item)
+          items = items[:item]
+        end
+        if opts == :as_array && items.is_a?(Hash)
+          [ items ]
+        else
+          items
+        end
+      end
+
+      def client
+        return @client if @client
+        config = YAML.load_file("#{ENV['HOME']}/.f5.yml")
+        if config.key?('username') && options[:lb] == 'default'
+          puts "Warning: credentials in .f5.yml should be put under a named load balancer."
+          configure_lb_as(config)
+        else
+          configure_lb_as config[options[:lb]]
+        end
+        F5::Icontrol::API.new
+      end
+
+      def configure_lb_as(config)
+        F5::Icontrol.configure do |f5|
+          f5.host = config['host']
+          f5.username = config['username']
+          f5.password = config['password']
+        end
+      end
+
+      def itemize(option)
+        {
+          item: [ option ]
+        }
+      end
+
+    end
+
+    class SelfIP < Subcommand
+      desc "list", "Lists all the self IPs"
+      def list
+        response = client.Networking.SelfIPV2.get_list
+
+        selfips = extract_items(response, :as_array)
+        if selfips.empty?
+          puts "No selfips found"
+        else
+          selfips.each do |selfip|
+            puts selfip
+          end
+        end
+      end
+
+      desc "show NAME", "Shows information about a self IP"
+      def show(name)
+        address = extract_items client.Networking.SelfIPV2.get_address(self_ips: { item: [ name ] })
+        netmask = extract_items client.Networking.SelfIPV2.get_netmask(self_ips: { item: [ name ] })
+        vlan = extract_items client.Networking.SelfIPV2.get_vlan(self_ips: { item: [ name ] })
+        trafficgroup = extract_items client.Networking.SelfIPV2.get_traffic_group(self_ips: { item: [ name ] })
+        floating = extract_items client.Networking.SelfIPV2.get_floating_state(self_ips: { item: [ name ] })
+
+        puts "#{address}/#{netmask}"
+        puts vlan
+        puts "#{trafficgroup} #{floating == 'STATE_ENABLED' ? 'FLOATING' : 'NONFLOATING'}"
+      end
+
+      desc "create NAME IP/NETMASK VLAN", "Creates a self IP"
+      option :floating, type: :boolean, default: false
+      option :traffic_group, default: 'traffic-group-local-only'
+      def create(name, address, vlan)
+        (ip, netmask) = address.split(/\//)
+        result = client.Networking.SelfIPV2.create(
+          self_ips: itemize(name),
+          vlan_names: itemize(vlan),
+          addresses: itemize(ip),
+          netmasks: itemize(netmask),
+          traffic_groups: itemize(options[:traffic_group]),
+          floating_states: itemize(options[:floating] ? 'STATE_ENABLED' : 'STATE_DISABLED')
+        )
+      end
+    end
+
+    class Interface < Subcommand
+
+      desc "list", "Lists all the interfaces"
+      def list
+        response = client.Networking.Interfaces.get_list
+
+        interfaces = extract_items(response, :as_array)
+        if interfaces.empty?
+          puts "No interfaces found"
+        else
+          interfaces.each do |interface|
+            puts interface
+          end
+        end
+      end
+    end
+
+    class VLAN < Subcommand
+
+      desc "list", "Lists all the vlans"
+      def list
+        response = client.Networking.VLAN.get_list
+
+        vlans = extract_items(response, :as_array)
+        if vlans.empty?
+          puts "No VLANs found"
+        else
+          vlans.each do |vlan|
+            puts vlan
+          end
+        end
+      end
+
+      desc "show VLAN_NAME", "Show a particular vlan"
+      def show(name)
+        members = extract_items client.Networking.VLAN.get_member(vlans: { item: [ name ] } ), :as_array
+
+        vid = extract_items client.Networking.VLAN.get_vlan_id(vlans: { item: [ name ] } )
+
+        failsafe_state = extract_items client.Networking.VLAN.get_failsafe_state(vlans: { item: [ name ] } )
+
+        puts "VLAN id #{vid} and failsafe is #{failsafe_state}"
+        members.each do |member|
+          puts "Interface %s is a %s and tag state is %s" % [ member[:member_name], member[:member_type], member[:tag_state] ]
+        end
+      end
+
+      desc "create VLAN_ID VLAN_NAME member1type:member1name ", "Create a vlan with the name and ID, attached to the given members"
+      def create(vid, name, *members)
+        if members.empty?
+          puts "I need at least one member interface"
+          exit
+        end
+
+        memberdata = members.map do |m|
+          (mtype, mname) = m.split /:/
+          if mname.nil?
+            puts "Each member must be in the form of interface/trunk:id"
+            exit
+          end
+          { member_name: mname,
+            member_type: (mtype == 'trunk' ? 'MEMBER_TRUNK' : 'MEMBER_INTERFACE'),
+            tag_state: 'MEMBER_TAGGED' }
+        end
+
+        response = client.Networking.VLAN.create_v2(
+          vlans: { item: [ name ] },
+          vlan_ids: { item: [ vid ] },
+          members: {  item: [ item: memberdata ] },
+          failsafe_states: {  item: [ 'STATE_DISABLED' ] },
+          timeouts: { item: [ 100 ] } #???
+        )
+        puts response
+
+      end
+    end
+
+    class Pool < Subcommand
 
       desc "list", "Lists all the pools"
       def list
@@ -103,7 +273,6 @@ module F5
       end
 
       private
-
       def pool_members(pool)
         response = client.LocalLB.Pool.get_member_v2(pool_names: { item: [ pool ] } )
 
@@ -113,17 +282,22 @@ module F5
         members.map { |m| { address: m[:address], port: m[:port] } }
       end
 
-      def client
-        @client || F5::Icontrol::API.new
-      end
-
     end
 
     class Application < Thor
+      class_option :lb, default: 'default'
 
       desc "pool SUBCOMMAND ...ARGS", "manage pools"
       subcommand "pool", Pool
 
+      desc "interface SUBCOMMAND ...ARGS", "manage interfaces"
+      subcommand "interface", Interface
+
+      desc "selfip SUBCOMMAND ...ARGS", "manage self IPs"
+      subcommand "selfip", SelfIP
+
+      desc "vlan SUBCOMMAND ...ARGS", "manage vlans"
+      subcommand "vlan", VLAN
     end
   end
 end

data/lib/f5/icontrol/version.rb

@@ -1,5 +1,5 @@
 module F5
   module Icontrol
-    VERSION = "0.1.4"
+    VERSION = "0.1.5"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: f5-icontrol
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Sean Walberg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-12 00:00:00.000000000 Z
+date: 2015-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: savon
@@ -411,3 +411,4 @@ test_files:
 - spec/cli/pool_spec.rb
 - spec/models/api_spec.rb
 - spec/spec_helper.rb
+has_rdoc: