knife-ionoscloud 6.1.0 → 6.2.0

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

data/lib/chef/knife/ionoscloud_targetgroup_target_remove.rb

@@ -0,0 +1,66 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupTargetRemove < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup target remove (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)'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Removes a Target from a Target Group if it exists.'
+        @directory = 'application-loadbalancer'
+        @required_options = [:target_group_id, :ip, :port]
+      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
+          target_group.properties.targets = target_group.properties.targets.reject do |target|
+            target.ip == config[:ip] && target.port == Integer(config[:port])
+          end
+
+          _, _, headers = target_groups_api.targetgroups_patch_with_http_info(config[:target_group_id], target_group.properties)
+          print "#{ui.color('Removing the Target from the Target Group...', :magenta)}"
+          dot = ui.color('.', :magenta)
+          api_client.wait_for { print dot; is_done? get_request_id headers }
+
+          target_group = target_groups_api.targetgroups_find_by_target_group_id(config[:target_group_id])
+        else
+          ui.warn("Specified target does not exist (#{config[:ip]}:#{config[:port]}).")
+        end
+
+        print_target_group(target_group)
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_targetgroup_update.rb

@@ -0,0 +1,151 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTargetgroupUpdate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud targetgroup update (options)'
+
+      option :target_group_id,
+              short: '-T TARGET_GROUP_ID',
+              long: '--target-group-id TARGET_GROUP_ID',
+              description: 'ID of the Target Group'
+
+      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 =
+        'Updates information about a Ionoscloud Application LoadBalancer.'
+        @directory = 'application-loadbalancer'
+        @required_options = [:target_group_id]
+        @updatable_fields = [
+          :name, :algorithm, :protocol, :check_timeout, :connect_timeout, :target_timeout,
+          :retries, :path, :method, :match_type, :response, :regex, :negate, :targets,
+        ]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        target_groups_api = Ionoscloud::TargetGroupsApi.new(api_client)
+
+        if @updatable_fields.map { |el| config[el] }.any?
+          print "#{ui.color('Updating Target Group...', :magenta)}"
+
+          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,
+          }
+
+          _, _, headers  = target_groups_api.targetgroups_patch_with_http_info(
+            config[:target_group_id],
+            Ionoscloud::TargetGroupProperties.new(**target_group_properties.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_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_template_list.rb

@@ -12,7 +12,6 @@ class Chef
         @description =
         'Retrieve a list of available templates. Templates can be used on specific server types only (CUBE at the moment)'
         @directory = 'compute-engine'
-        @required_options = [:ionoscloud_username, :ionoscloud_password]
       end
 
       def run

data/lib/chef/knife/ionoscloud_user_create.rb

@@ -43,7 +43,7 @@ class Chef
         'here cannot be updated through the API currently. It is recommended that a new user '\
         'log into the DCD and change their password.'
         @directory = 'user'
-        @required_options = [:firstname, :lastname, :email, :password, :ionoscloud_username, :ionoscloud_password]
+        @required_options = [:firstname, :lastname, :email, :password]
       end
 
       def run

data/lib/chef/knife/ionoscloud_user_delete.rb

@@ -14,7 +14,6 @@ class Chef
         'therefore if you anticipate needing to create a user with the same name '\
         'in the future, we suggest renaming the user before you delete it.'
         @directory = 'user'
-        @required_options = [:ionoscloud_username, :ionoscloud_password]
       end
 
       def run
@@ -38,7 +37,7 @@ class Chef
 
           begin
             confirm('Do you really want to delete this User')
-          rescue SystemExit => exc
+          rescue SystemExit
             next
           end
 

data/lib/chef/knife/ionoscloud_user_get.rb

@@ -17,7 +17,7 @@ class Chef
         @description =
         'Retrieves the attributes of a given Ionoscloud User.'
         @directory = 'user'
-        @required_options = [:user_id, :ionoscloud_username, :ionoscloud_password]
+        @required_options = [:user_id]
       end
 
       def run

data/lib/chef/knife/ionoscloud_user_list.rb

@@ -19,7 +19,6 @@ class Chef
         'You can retrieve a list of users who are members of the group by passing the '\
         '_group\_id_ option.'
         @directory = 'user'
-        @required_options = [:ionoscloud_username, :ionoscloud_password]
       end
 
       def run

data/lib/chef/knife/ionoscloud_user_ssourl.rb

@@ -17,7 +17,7 @@ class Chef
         @description =
         'Retrieve S3 object storage single signon URL for the given user.'
         @directory = 'user'
-        @required_options = [:user_id, :ionoscloud_username, :ionoscloud_password]
+        @required_options = [:user_id]
       end
 
       def run

data/lib/chef/knife/ionoscloud_user_update.rb

@@ -48,7 +48,7 @@ class Chef
         @description =
         'Updates information about a Ionoscloud User.'
         @directory = 'user'
-        @required_options = [:user_id, :ionoscloud_username, :ionoscloud_password]
+        @required_options = [:user_id]
         @updatable_fields = [:firstname, :lastname, :email, :administrator, :force_sec_auth, :sec_auth_active, :active]
       end
 

data/lib/chef/knife/ionoscloud_volume_attach.rb

@@ -22,7 +22,7 @@ class Chef
         @description =
         'This will attach a pre-existing storage volume to the server.'
         @directory = 'compute-engine'
-        @required_options = [:datacenter_id, :server_id, :ionoscloud_username, :ionoscloud_password]
+        @required_options = [:datacenter_id, :server_id]
       end
 
       def run

data/lib/chef/knife/ionoscloud_volume_create.rb

@@ -77,7 +77,7 @@ class Chef
         'Creates a volume within the data center. This will NOT attach the volume to a server. '\
         'Please see the Servers section for details on how to attach storage volumes.'
         @directory = 'compute-engine'
-        @required_options = [:datacenter_id, :name, :type, :size, :ionoscloud_username, :ionoscloud_password]
+        @required_options = [:datacenter_id, :name, :type, :size]
       end
 
       def run