knife-ionoscloud 6.1.2 → 6.2.0

data/lib/chef/knife/ionoscloud_applicationloadbalancer_update.rb

@@ -0,0 +1,96 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudApplicationloadbalancerUpdate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud applicationloadbalancer update (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'ID of the data center'
+
+      option :application_loadbalancer_id,
+              short: '-L APPLICATION_LOADBALANCER_ID',
+              long: '--application-loadbalancer APPLICATION_LOADBALANCER_ID',
+              description: 'ID of the Application Loadbalancer'
+
+      option :name,
+              short: '-n NAME',
+              long: '--name NAME',
+              description: 'Name of the Application Load Balancer'
+
+      option :listener_lan,
+              short: '-l LISTENER_LAN_ID',
+              long: '--listener-lan LISTENER_LAN_ID',
+              description: 'Id of the listening LAN. (inbound)'
+
+      option :target_lan,
+              short: '-t TARGET_LAN_ID',
+              long: '--target-lan TARGET_LAN_ID',
+              description: 'Id of the balanced private target LAN. (outbound)'
+
+      option :ips,
+              short: '-i IP[,IP,...]',
+              long: '--ips IP[,IP,...]',
+              description: 'Collection of IP addresses of the Application Load Balancer. (inbound and outbound) IP of the '\
+              'listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.'
+
+      option :lb_private_ips,
+              long: '--private-ips IP[,IP,...]',
+              description: 'Collection of private IP addresses with subnet mask of the Application Load Balancer. '\
+              'IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Updates information about a Ionoscloud Application LoadBalancer.'
+        @directory = 'application-loadbalancer'
+        @required_options = [:datacenter_id, :application_loadbalancer_id]
+        @updatable_fields = [:name, :listener_lan, :target_lan, :ips, :lb_private_ips]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        application_load_balancers_api = Ionoscloud::ApplicationLoadBalancersApi.new(api_client)
+
+        if @updatable_fields.map { |el| config[el] }.any?
+          print "#{ui.color('Updating Application LoadBalancer...', :magenta)}"
+
+          config[:ips] = config[:ips].split(',') if config[:ips] && config[:ips].instance_of?(String)
+          config[:lb_private_ips] = config[:lb_private_ips].split(',') if config[:lb_private_ips] && config[:lb_private_ips].instance_of?(String)
+
+          _, _, headers  = application_load_balancers_api.datacenters_applicationloadbalancers_patch_with_http_info(
+            config[:datacenter_id],
+            config[:application_loadbalancer_id],
+            Ionoscloud::ApplicationLoadBalancerProperties.new({
+              name: config[:name],
+              ips: config[:ips],
+              listener_lan: config[:listener_lan],
+              target_lan: config[:target_lan],
+              lb_private_ips: config[:lb_private_ips],
+            }.compact),
+          )
+
+          dot = ui.color('.', :magenta)
+          api_client.wait_for { print dot; is_done? get_request_id headers }
+        else
+          ui.warn("Nothing to update, please set one of the attributes #{@updatable_fields}.")
+        end
+
+        print_application_loadbalancer(
+          application_load_balancers_api.datacenters_applicationloadbalancers_find_by_application_load_balancer_id(
+            config[:datacenter_id], config[:application_loadbalancer_id], depth: 2,
+          ),
+        )
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_base.rb

@@ -53,9 +53,7 @@ class Chef
       end
 
       def msg_pair(label, value, color = :cyan)
-        if !value.nil? && !value.to_s.empty?
-          puts "#{ui.color(label, color)}: #{value}"
-        end
+        puts "#{ui.color(label, color)}: #{value}" if !value.nil? && !value.to_s.empty?
       end
 
       def validate_required_params(required_params, params)
@@ -84,7 +82,7 @@ class Chef
           if config.key?(key) || !ionoscloud_options.include?(key)
             ignored_options << key
           else
-            config[key] = value 
+            config[key] = value
           end
         end
 
@@ -116,7 +114,7 @@ class Chef
 
         @api_client = Ionoscloud::ApiClient.new(api_config)
 
-        @api_client.user_agent =  [
+        @api_client.user_agent = [
           'knife/v' + MODULE_VERSION,
           @api_client.default_headers['User-Agent'],
           'chef/' + Chef::VERSION,
@@ -141,7 +139,7 @@ class Chef
 
         @api_client_dbaas = IonoscloudDbaasPostgres::ApiClient.new(api_config_dbaas)
 
-        @api_client_dbaas.user_agent =  [
+        @api_client_dbaas.user_agent = [
           'knife/v' + MODULE_VERSION,
           @api_client_dbaas.default_headers['User-Agent'],
           'chef/' + Chef::VERSION,
@@ -167,6 +165,51 @@ class Chef
         response.metadata.status == 'DONE'
       end
 
+      def get_target_group_extended_properties(target_group)
+        health_check = target_group.properties.health_check.nil? ? nil : {
+          check_timeout: target_group.properties.health_check.check_timeout,
+          connect_timeout: target_group.properties.health_check.connect_timeout,
+          target_timeout: target_group.properties.health_check.target_timeout,
+          retries: target_group.properties.health_check.retries,
+        }
+        http_health_check = target_group.properties.http_health_check.nil? ? nil : {
+          path: target_group.properties.http_health_check.path,
+          method: target_group.properties.http_health_check.method,
+          match_type: target_group.properties.http_health_check.match_type,
+          response: target_group.properties.http_health_check.response,
+          regex: target_group.properties.http_health_check.regex,
+          negate: target_group.properties.http_health_check.negate,
+        }
+        targets = target_group.properties.targets.nil? ? [] : target_group.properties.targets.map do |target|
+          {
+            ip: target.ip,
+            port: target.port,
+            weight: target.weight,
+            health_check: target.health_check.nil? ? nil : {
+              check: target.health_check.check,
+              check_interval: target.health_check.check_interval,
+              maintenance: target.health_check.maintenance,
+            },
+          }
+        end
+
+        return health_check, http_health_check, targets
+      end
+
+      def print_target_group(target_group)
+        health_check, http_health_check, targets = get_target_group_extended_properties(target_group)
+
+        puts "\n"
+        puts "#{ui.color('ID', :cyan)}: #{target_group.id}"
+        puts "#{ui.color('Name', :cyan)}: #{target_group.properties.name}"
+        puts "#{ui.color('Algorithm', :cyan)}: #{target_group.properties.algorithm}"
+        puts "#{ui.color('Protocol', :cyan)}: #{target_group.properties.protocol}"
+        puts "#{ui.color('Health Check', :cyan)}: #{health_check}"
+        puts "#{ui.color('HTTP Health Check', :cyan)}: #{http_health_check}"
+        puts "#{ui.color('Targets', :cyan)}: #{targets}"
+        puts 'done'
+      end
+
       def print_datacenter(datacenter)
         print "\n"
         cpu_architecture = datacenter.properties.cpu_architecture.nil? ? [] : datacenter.properties.cpu_architecture.map { |arch| arch.to_hash }
@@ -469,9 +512,98 @@ class Chef
         puts "#{ui.color('Flowlogs', :cyan)}: #{natgateway.entities.flowlogs.items.map { |flowlog| flowlog.id }}"
       end
 
+      def get_application_loadbalancer_extended_properties(application_loadbalancer)
+        fw_rules = application_loadbalancer.entities.forwardingrules.items
+        fw_rules.nil? ? [] : fw_rules.map do |rule|
+          {
+            id: rule.id,
+            name: rule.properties.name,
+            protocol: rule.properties.protocol,
+            listener_ip: rule.properties.listener_ip,
+            listener_port: rule.properties.listener_port,
+            client_timeout: rule.properties.client_timeout,
+            server_certificates: rule.properties.server_certificates,
+            http_rules: rule.properties.http_rules.nil? ? [] : rule.properties.http_rules.map do |http_rule|
+              {
+                name: http_rule.name,
+                type: http_rule.type,
+                target_group: http_rule.target_group,
+                drop_query: http_rule.drop_query,
+                location: http_rule.location,
+                status_code: http_rule.status_code,
+                response_message: http_rule.response_message,
+                content_type: http_rule.content_type,
+                conditions: http_rule.conditions.nil? ? [] : http_rule.conditions.map do |condition|
+                  {
+                    type: condition.type,
+                    condition: condition.condition,
+                    negate: condition.negate,
+                    key: condition.key,
+                    value: condition.value,
+                  }
+                end,
+              }
+            end,
+          }
+        end
+      end
+
+      def print_application_loadbalancer(application_loadbalancer)
+        rules = get_application_loadbalancer_extended_properties(application_loadbalancer)
+
+        print "\n"
+        puts "#{ui.color('ID', :cyan)}: #{application_loadbalancer.id}"
+        puts "#{ui.color('Name', :cyan)}: #{application_loadbalancer.properties.name}"
+        puts "#{ui.color('Listener LAN', :cyan)}: #{application_loadbalancer.properties.listener_lan}"
+        puts "#{ui.color('Target LAN', :cyan)}: #{application_loadbalancer.properties.target_lan}"
+        puts "#{ui.color('IPS', :cyan)}: #{application_loadbalancer.properties.ips}"
+        puts "#{ui.color('Lb Private IPS', :cyan)}: #{application_loadbalancer.properties.lb_private_ips}"
+        puts "#{ui.color('Rules', :cyan)}: #{rules}"
+      end
+
+      def get_target_group_extended_properties(target_group)
+        health_check = target_group.properties.health_check.nil? ? nil : {
+          check_timeout: target_group.properties.health_check.check_timeout,
+          check_interval: target_group.properties.health_check.check_interval,
+          retries: target_group.properties.health_check.retries,
+        }
+        http_health_check = target_group.properties.http_health_check.nil? ? nil : {
+          path: target_group.properties.http_health_check.path,
+          method: target_group.properties.http_health_check.method,
+          match_type: target_group.properties.http_health_check.match_type,
+          response: target_group.properties.http_health_check.response,
+          regex: target_group.properties.http_health_check.regex,
+          negate: target_group.properties.http_health_check.negate,
+        }
+        targets = target_group.properties.targets.nil? ? [] : target_group.properties.targets.map do |target|
+          {
+            ip: target.ip,
+            port: target.port,
+            weight: target.weight,
+            health_check_enabled: target.health_check_enabled,
+            maintenance_enabled: target.maintenance_enabled,
+          }
+        end
+
+        return health_check, http_health_check, targets
+      end
+
+      def print_target_group(target_group)
+        health_check, http_health_check, targets = get_target_group_extended_properties(target_group)
+        print "\n"
+        puts "#{ui.color('ID', :cyan)}: #{target_group.id}"
+        puts "#{ui.color('Name', :cyan)}: #{target_group.properties.name}"
+        puts "#{ui.color('Algorithm', :cyan)}: #{target_group.properties.algorithm}"
+        puts "#{ui.color('Protocol', :cyan)}: #{target_group.properties.protocol}"
+        puts "#{ui.color('Health Check', :cyan)}: #{health_check}"
+        puts "#{ui.color('HTTP Health Check', :cyan)}: #{http_health_check}"
+        puts "#{ui.color('Targets', :cyan)}: #{targets}"
+        puts 'done'
+      end
+
       def print_cluster(cluster)
         connections = cluster.properties.connections.map { |connection| connection.to_hash }
-        
+
         print "\n"
         puts "#{ui.color('ID', :cyan)}: #{cluster.id}"
         puts "#{ui.color('Display Name', :cyan)}: #{cluster.properties.display_name}"

data/lib/chef/knife/ionoscloud_targetgroup_create.rb

@@ -0,0 +1,140 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupCreate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup create (options)'
+
+      option :name,
+              short: '-n NAME',
+              long: '--name NAME',
+              description: 'Name of the server'
+
+      option :algorithm,
+              short: '-a ALGORITHM',
+              long: '--algorithm ALGORITHM',
+              description: 'Algorithm for the balancing. One of ["ROUND_ROBIN", "LEAST_CONNECTION", "RANDOM", "SOURCE_IP"]'
+
+      option :protocol,
+              short: '-p PROTOCOL',
+              long: '--protocol PROTOCOL',
+              description: 'Protocol of the balancing. One of ["HTTP"]'
+
+      option :check_timeout,
+              long: '--check-timeout CHECK_TIMEOUT',
+              description: 'It specifies the time (in milliseconds) for a target VM in this pool to answer the check. If '\
+              'a target VM has CheckInterval set and CheckTimeout is set too, then the smaller value of the two is used '\
+              'after the TCP connection is established.'
+
+      option :check_interval,
+              long: '--check-interval check_interval',
+              description: 'It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target '\
+              'VM to succeed. If unset, the default of 5 seconds will be used.'
+
+      option :retries,
+              short: '-r RETRIES',
+              long: '--retries RETRIES',
+              description: 'Retries specifies the number of retries to perform on a target VM after a connection failure. '\
+              'If unset, the default value of 3 will be used. (valid range: [0, 65535])'
+
+      option :path,
+              long: '--path PATH',
+              description: 'The path for the HTTP health check; default: /.'
+
+      option :method,
+              short: '-m METHOD',
+              long: '--method METHOD',
+              description: 'The method for the HTTP health check.'
+
+      option :match_type,
+              long: '--match-type MATCH_TYPE',
+              description: 'The method for the HTTP health check. One of ["STATUS_CODE", "RESPONSE_BODY"].'
+
+      option :response,
+              long: '--response RESPONSE',
+              description: 'The response returned by the request.'
+
+      option :regex,
+              long: '--regex REGEX',
+              description: 'The regex used.'
+
+      option :negate,
+              long: '--negate',
+              description: 'Whether to negate or not.'
+
+      option :targets,
+              long: '--targets',
+              description: 'Array of TargetGroup targets.'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Creates a new Target Group.'
+        @directory = 'application-loadbalancer'
+        @required_options = [:name, :algorithm, :protocol]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        target_groups_api = Ionoscloud::TargetGroupsApi.new(api_client)
+
+        unless config[:targets].nil?
+          config[:targets] = JSON[config[:targets]] if config[:targets].instance_of?(String)
+
+          config[:targets].map! do |target|
+            Ionoscloud::TargetGroupTarget.new(
+              ip: target['ip'],
+              port: Integer(target['port']),
+              weight: Integer(target['weight']),
+              health_check_enabled: target['health_check_enabled'],
+              maintenance_enabled: target['maintenance_enabled'],
+            )
+          end
+        end
+
+        send_http_health_check = config[:path] || config[:method] || config[:match_type] || config[:response] || config[:regex] || config[:negate]
+
+        target_group_properties = {
+          name: config[:name],
+          algorithm: config[:algorithm],
+          protocol: config[:protocol],
+          targets: config[:targets],
+          health_check: Ionoscloud::TargetGroupHealthCheck.new(
+            check_timeout: config[:check_timeout],
+            check_interval: config[:check_interval],
+            retries: config[:retries],
+          ),
+          http_health_check: send_http_health_check ? Ionoscloud::TargetGroupHttpHealthCheck.new(
+            path: config[:path],
+            method: config[:method],
+            match_type: config[:match_type],
+            response: config[:response],
+            regex: config[:regex],
+            negate: config[:negate],
+          ) : nil,
+        }
+
+        target_group = Ionoscloud::TargetGroup.new(
+          properties: Ionoscloud::TargetGroupProperties.new(
+            **target_group_properties.compact,
+          ),
+        )
+
+        target_group, _, headers = target_groups_api.targetgroups_post_with_http_info(target_group)
+
+        print "#{ui.color('Creating Target Group...', :magenta)}"
+        dot = ui.color('.', :magenta)
+        api_client.wait_for { print dot; is_done? get_request_id headers }
+
+        print_target_group(target_groups_api.targetgroups_find_by_target_group_id(target_group.id))
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_targetgroup_delete.rb

@@ -0,0 +1,50 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupDelete < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup delete TARGET_GROUP_ID [TARGET_GROUP_ID]'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Deletes a Target Group'
+        @directory = 'application-loadbalancer'
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        target_group_api = Ionoscloud::TargetGroupsApi.new(api_client)
+
+        @name_args.each do |target_group_id|
+          begin
+            target_group = target_group_api.targetgroups_find_by_target_group_id(target_group_id)
+          rescue Ionoscloud::ApiError => err
+            raise err unless err.code == 404
+            ui.error("Target Group ID #{target_group_id} not found. Skipping.")
+            next
+          end
+
+          print_target_group(target_group)
+          puts "\n"
+
+          begin
+            confirm('Do you really want to delete this Target Group')
+          rescue SystemExit
+            next
+          end
+
+          _, _, headers = target_group_api.target_groups_delete_with_http_info(target_group_id)
+          ui.warn("Deleted Target Group #{target_group.id}. Request ID: #{get_request_id headers}")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_targetgroup_get.rb

@@ -0,0 +1,34 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupGet < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup get (options)'
+
+      option :target_group_id,
+              short: '-T TARGET_GROUP_ID',
+              long: '--target-group-id TARGET_GROUP_ID',
+              description: 'ID of the Target Group'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Gets information about a Target Group.'
+        @directory = 'application-loadbalancer'
+        @required_options = [:target_group_id]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        print_target_group(Ionoscloud::TargetGroupsApi.new(api_client).targetgroups_find_by_target_group_id(config[:target_group_id]))
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_targetgroup_list.rb

@@ -0,0 +1,45 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupList < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup list'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description = 'Lists all available Target Groups.'
+        @directory = 'application-loadbalancer'
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        target_group_list = [
+          ui.color('ID', :bold),
+          ui.color('Name', :bold),
+          ui.color('Algorithm', :bold),
+          ui.color('Protocol', :bold),
+          ui.color('Targets', :bold),
+        ]
+
+        target_group_api = Ionoscloud::TargetGroupsApi.new(api_client)
+
+        target_group_api.targetgroups_get({ depth: 1 }).items.each do |target_group|
+          target_group_list << target_group.id
+          target_group_list << target_group.properties.name
+          target_group_list << target_group.properties.algorithm
+          target_group_list << target_group.properties.protocol
+          target_group_list << target_group.properties.targets.nil? ? 0 : target_group.properties.targets.length
+        end
+
+        puts ui.list(target_group_list, :uneven_columns_across, 5)
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_targetgroup_target_add.rb

@@ -0,0 +1,93 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupTargetAdd < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup target add (options)'
+
+      option :target_group_id,
+              short: '-T TARGET_GROUP_ID',
+              long: '--target-group-id TARGET_GROUP_ID',
+              description: 'ID of the Target Group'
+
+      option :ip,
+              long: '--ip IP',
+              description: 'IP of a balanced target VM'
+
+      option :port,
+              short: '-p PORT',
+              long: '--port PORT',
+              description: 'Port of the balanced target service. (range: 1 to 65535)'
+
+      option :weight,
+              short: '-w WEIGHT',
+              long: '--weight WEIGHT',
+              description: 'Weight parameter is used to adjust the target VM\'s weight relative to other target VMs. '\
+              'All target VMs will receive a load proportional to their weight relative to the sum of all weights, '\
+              'so the higher the weight, the higher the load. The default weight is 1, and the maximal value is 256. '\
+              'A value of 0 means the target VM will not participate in load-balancing but will still accept persistent '\
+              'connections. If this parameter is used to distribute the load according to target VM\'s capacity, it is '\
+              'recommended to start with values which can both grow and shrink, for instance between 10 and 100 to leave '\
+              'enough room above and below for later adjustments.'
+
+      option :health_check_disable,
+              long: '--health-check-disable',
+              description: 'Enabling the health check makes the target available only if it accepts periodic health check '\
+              'TCP connection attempts; when turned off, the target is considered always available. The health check only '\
+              'consists of a connection attempt to the address and port of the target. Default is having the health check enabled.',
+              boolean: true
+
+      option :maintenance_enabled,
+              long: '--maintenance',
+              description: 'Maintenance mode prevents the target from receiving balanced traffic.',
+              boolean: true
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Adds a Target to a Target Group.'
+        @directory = 'application-loadbalancer'
+        @required_options = [:target_group_id, :ip, :port, :weight]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        target_groups_api = Ionoscloud::TargetGroupsApi.new(api_client)
+
+        target_group = target_groups_api.targetgroups_find_by_target_group_id(config[:target_group_id])
+
+        existing_target = target_group.properties.targets.find do |target|
+          target.ip == config[:ip] && target.port == Integer(config[:port])
+        end
+
+        if existing_target
+          ui.warn("Specified target already exists (#{existing_target}).")
+        else
+          target_group.properties.targets.append(
+            Ionoscloud::TargetGroupTarget.new(
+              ip: config[:ip],
+              port: Integer(config[:port]),
+              weight: Integer(config[:weight]),
+              health_check_enabled: !config[:health_check_disable],
+              maintenance_enabled: config[:maintenance_enabled],
+            ),
+          )
+
+          _, _, headers = target_groups_api.targetgroups_patch_with_http_info(config[:target_group_id], target_group.properties)
+          print "#{ui.color('Adding the Target to the Target Group...', :magenta)}"
+          dot = ui.color('.', :magenta)
+          api_client.wait_for { print dot; is_done? get_request_id headers }
+        end
+
+        print_target_group(target_groups_api.targetgroups_find_by_target_group_id(config[:target_group_id]))
+      end
+    end
+  end
+end