knife-ionoscloud 5.0.0 → 6.0.0.beta.1

data/lib/chef/knife/ionoscloud_server_upgrade.rb

@@ -0,0 +1,45 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudServerUpgrade < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud server upgrade (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'The ID of the Datacenter.'
+
+      option :server_id,
+              short: '-S SERVER_ID',
+              long: '--server-id SERVER_ID',
+              description: 'The ID of the Server.'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        "This will upgrade the version of the server, if needed. To verify if there is an upgrade available for a server, "\
+        "call '/datacenters/{datacenterId}/servers?upgradeNeeded=true'."
+        @required_options = [:datacenter_id, :server_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        begin
+          _, _, headers = Ionoscloud::ServersApi.new(api_client).datacenters_servers_upgrade_post(config[:datacenter_id], config[:server_id])
+          ui.info("Server #{config[:server_id]} is being upgraded. Request ID: #{get_request_id headers}")
+        rescue Ionoscloud::ApiError => err
+          raise err unless err.code == 404
+          ui.error("Server ID #{config[:server_id]} not found.")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_share_create.rb

@@ -40,6 +40,7 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         print "#{ui.color('Sharing Resource...', :magenta)}"

data/lib/chef/knife/ionoscloud_share_delete.rb

@@ -23,6 +23,7 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         user_management_api = Ionoscloud::UserManagementApi.new(api_client)

data/lib/chef/knife/ionoscloud_share_list.rb

@@ -24,6 +24,7 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         share_list = [

data/lib/chef/knife/ionoscloud_snapshot_create.rb

@@ -17,6 +17,24 @@ class Chef
               long: '--volume VOLUME_ID',
               description: 'ID of the Volume'
 
+      option :name,
+              short: '-n SNAPSHOT_NAME',
+              long: '--name SNAPSHOT_NAME',
+              description: 'Name of the snapshot'
+
+      option :description,
+              long: '--description SNAPSHOT_DESCRIPTION',
+              description: 'Description of the snapshot'
+
+      option :sec_auth_protection,
+              long: '--sec-auth',
+              description: 'Flag representing if extra protection is enabled on snapshot e.g. Two Factor protection etc.'
+
+      option :licence_type,
+              short: '-l LICENCE_TYPE',
+              long: '--licence LICENCE_TYPE',
+              description: 'The OS type of this Snapshot'
+
       attr_reader :description, :required_options
 
       def initialize(args = [])
@@ -29,21 +47,28 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         print "#{ui.color('Creating Snapshot...', :magenta)}"
 
-        volume_api = Ionoscloud::VolumeApi.new(api_client)
+        volume_api = Ionoscloud::VolumesApi.new(api_client)
 
         snapshot, _, headers  = volume_api.datacenters_volumes_create_snapshot_post_with_http_info(
           config[:datacenter_id],
           config[:volume_id],
+          {
+            name: config[:name],
+            description: config[:description],
+            sec_auth_protection: config[:sec_auth_protection],
+            licence_type: config[:licence_type],
+          }.compact,
         )
 
         dot = ui.color('.', :magenta)
         api_client.wait_for { print dot; is_done? get_request_id headers }
 
-        snapshot = Ionoscloud::SnapshotApi.new(api_client).snapshots_find_by_id(snapshot.id)
+        snapshot = Ionoscloud::SnapshotsApi.new(api_client).snapshots_find_by_id(snapshot.id)
 
         puts "\n"
         puts "#{ui.color('ID', :cyan)}: #{snapshot.id}"

data/lib/chef/knife/ionoscloud_snapshot_delete.rb

@@ -18,9 +18,10 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
-        snapshot_api = Ionoscloud::SnapshotApi.new(api_client)
+        snapshot_api = Ionoscloud::SnapshotsApi.new(api_client)
 
         @name_args.each do |snapshot_id|
           begin

data/lib/chef/knife/ionoscloud_snapshot_list.rb

@@ -18,6 +18,7 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         snapshot_list = [
@@ -28,7 +29,7 @@ class Chef
           ui.color('Size', :bold)
         ]
 
-        snapshot_api = Ionoscloud::SnapshotApi.new(api_client)
+        snapshot_api = Ionoscloud::SnapshotsApi.new(api_client)
 
         snapshot_api.snapshots_get({ depth: 1 }).items.each do |snapshot|
           snapshot_list << snapshot.id

data/lib/chef/knife/ionoscloud_snapshot_restore.rb

@@ -34,11 +34,12 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         print "#{ui.color('Restoring Snapshot...', :magenta)}"
 
-        volume_api = Ionoscloud::VolumeApi.new(api_client)
+        volume_api = Ionoscloud::VolumesApi.new(api_client)
 
         _, _, headers  = volume_api.datacenters_volumes_restore_snapshot_post_with_http_info(
           config[:datacenter_id],
@@ -49,7 +50,7 @@ class Chef
         dot = ui.color('.', :magenta)
         api_client.wait_for { print dot; is_done? get_request_id headers }
 
-        volume_api = Ionoscloud::VolumeApi.new(api_client)
+        volume_api = Ionoscloud::VolumesApi.new(api_client)
 
         volume = volume_api.datacenters_volumes_find_by_id(config[:datacenter_id], config[:volume_id])
 

data/lib/chef/knife/ionoscloud_template_list.rb

@@ -0,0 +1,47 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudTemplateList < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud template list'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Retrieve a list of available templates. Templates can be used on specific server types only (CUBE at the moment)'
+        @required_options = [:ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        handle_extra_config
+        validate_required_params(@required_options, config)
+
+        template_list = [
+          ui.color('ID', :bold),
+          ui.color('Name', :bold),
+          ui.color('Cores', :bold),
+          ui.color('RAM', :bold),
+          ui.color('Storage Size', :bold),
+        ]
+        templates_api = Ionoscloud::TemplatesApi.new(api_client)
+
+        templates_api.templates_get({ depth: 1 }).items.sort do |a, b|
+          a.properties.cores != b.properties.cores ? a.properties.cores <=> b.properties.cores : a.properties.ram <=> b.properties.ram
+        end.each do |template|
+          template_list << template.id
+          template_list << template.properties.name
+          template_list << Integer(template.properties.cores)
+          template_list << Integer(template.properties.ram)
+          template_list << Integer(template.properties.storage_size)
+        end
+
+        puts ui.list(template_list, :uneven_columns_across, 5)
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_user_create.rb

@@ -33,7 +33,7 @@ class Chef
               description: 'Assigns the user have administrative rights.'
 
       option :force_sec_auth,
-              long: '--sec-auth SEC_AUTH',
+              long: '--sec-auth',
               description: 'Indicates if secure (two-factor) authentication should be forced for the user.'
 
       attr_reader :description, :required_options
@@ -41,14 +41,15 @@ class Chef
       def initialize(args = [])
         super(args)
         @description =
-        "Creates a new user under a particular contract.\n**Please Note**: The password set "\
-        "here cannot be updated through the API currently. It is recommended that a new user "\
-        "log into the DCD and change their password."
+        'Creates a new user under a particular contract. **Please Note**: The password set '\
+        'here cannot be updated through the API currently. It is recommended that a new user '\
+        'log into the DCD and change their password.'
         @required_options = [:firstname, :lastname, :email, :password, :ionoscloud_username, :ionoscloud_password]
       end
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         print "#{ui.color('Creating user...', :magenta)}"

data/lib/chef/knife/ionoscloud_user_delete.rb

@@ -20,6 +20,7 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         user_management_api = Ionoscloud::UserManagementApi.new(api_client)

data/lib/chef/knife/ionoscloud_user_list.rb

@@ -19,12 +19,13 @@ class Chef
         @description =
         'Retrieve a list of all the users that have been created under a contract. '\
         'You can retrieve a list of users who are members of the group by passing the '\
-        '*group_id* option.'
+        '_group\_id_ option.'
         @required_options = [:ionoscloud_username, :ionoscloud_password]
       end
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         user_list = [

data/lib/chef/knife/ionoscloud_user_ssourl.rb

@@ -23,10 +23,11 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         begin
-          puts Ionoscloud::UserManagementApi.new(api_client).um_users_s3ssourl_get(config[:user_id]).sso_url
+          puts Ionoscloud::UserS3KeysApi.new(api_client).um_users_s3ssourl_get(config[:user_id]).sso_url
         rescue Ionoscloud::ApiError => err
           raise err unless err.code == 404
           ui.error("User ID #{config[:user_id]} not found.")

data/lib/chef/knife/ionoscloud_volume_attach.rb

@@ -28,9 +28,10 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
-        server_api = Ionoscloud::ServerApi.new(api_client)
+        server_api = Ionoscloud::ServersApi.new(api_client)
 
         @name_args.each do |volume_id|
           begin

data/lib/chef/knife/ionoscloud_volume_create.rb

@@ -32,10 +32,6 @@ class Chef
               long: '--image ID',
               description: 'The image or snapshot ID'
 
-      option :image_alias,
-              long: '--image-alias IMAGE_ALIAS',
-              description: '(required) The image alias'
-
       option :image_password,
               short: '-P PASSWORD',
               long: '--image-password PASSWORD',
@@ -44,7 +40,7 @@ class Chef
       option :type,
               short: '-t TYPE',
               long: '--type TYPE',
-              description: 'The disk type (HDD OR SSD)'
+              description: 'The disk type (HDD, SSD, SSD Standard, SSD Premium, DAS)'
 
       option :licence_type,
               short: '-l LICENCE',
@@ -59,8 +55,21 @@ class Chef
       option :availability_zone,
               short: '-Z AVAILABILITY_ZONE',
               long: '--availability-zone AVAILABILITY_ZONE',
-              description: 'The volume availability zone of the server',
-              required: false
+              description: 'The volume availability zone of the server'
+
+      option :backupunit_id,
+              short: '-B BACKUPUNIT_ID',
+              long: '--backupunit BACKUPUNIT_ID',
+              description: 'The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed '\
+              'to be set on a new volume creation. It is mandatory to provide either \'public image\' or \'imageAlias\' in '\
+              'conjunction with this property.'
+
+      option :user_data,
+              short: '-u USER_DATA',
+              long: '--user-data USER_DATA',
+              description: 'The cloud-init configuration for the volume as base64 encoded string. The property is '\
+              'immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either \'public image\' '\
+              'or \'imageAlias\' that has cloud-init compatibility in conjunction with this property.'
 
       attr_reader :description, :required_options
 
@@ -74,42 +83,32 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
-        if !config[:image] && !config[:image_alias]
-          ui.error('Either \'--image\' or \'--image-alias\' parameter must be provided')
-          exit(1)
-        end
-
-        if !config[:ssh_keys] && !config[:image_password]
-          ui.error('Either \'--image-password\' or \'--ssh-keys\' parameter must be provided')
-          exit(1)
-        end
-
-        if config[:ssh_keys]
-          config[:ssh_keys] = config[:ssh_keys].split(',')
-        end
+        config[:ssh_keys] = config[:ssh_keys].split(',') if config[:ssh_keys] && config[:ssh_keys].instance_of?(String)
 
         print "#{ui.color('Creating volume...', :magenta)}"
 
-        volume_api = Ionoscloud::VolumeApi.new(api_client)
+        volume_api = Ionoscloud::VolumesApi.new(api_client)
+
+        volume_properties = {
+          name: config[:name],
+          size: config[:size],
+          bus: config[:bus] || 'VIRTIO',
+          type: config[:type],
+          licence_type: config[:licence_type],
+          image: config[:image],
+          ssh_keys: config[:ssh_keys],
+          image_password: config[:image_password],
+          availability_zone: config[:availability_zone],
+          backupunit_id: config[:backupunit_id],
+          user_data: config[:user_data],
+        }.compact
 
         volume, _, headers = volume_api.datacenters_volumes_post_with_http_info(
           config[:datacenter_id],
-          {
-            properties: {
-              name: config[:name],
-              size: config[:size],
-              bus: config[:bus] || 'VIRTIO',
-              type: config[:type],
-              licenceType: config[:licence_type],
-              image: config[:image],
-              imageAlias: config[:image_alias],
-              sshKeys: config[:sshKeys],
-              imagePassword: config[:image_password],
-              availabilityZone: config[:availability_zone],
-            }.compact
-          },
+          Ionoscloud::Volume.new(properties: Ionoscloud::VolumeProperties.new(**volume_properties)),
         )
 
         dot = ui.color('.', :magenta)

data/lib/chef/knife/ionoscloud_volume_delete.rb

@@ -24,9 +24,10 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
-        volume_api = Ionoscloud::VolumeApi.new(api_client)
+        volume_api = Ionoscloud::VolumesApi.new(api_client)
 
         @name_args.each do |volume_id|
           begin

data/lib/chef/knife/ionoscloud_volume_detach.rb

@@ -31,9 +31,10 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
-        server_api = Ionoscloud::ServerApi.new(api_client)
+        server_api = Ionoscloud::ServersApi.new(api_client)
 
         @name_args.each do |volume_id|
           begin

data/lib/chef/knife/ionoscloud_volume_list.rb

@@ -29,6 +29,7 @@ class Chef
 
       def run
         $stdout.sync = true
+        handle_extra_config
         validate_required_params(@required_options, config)
 
         volume_list = [
@@ -39,16 +40,16 @@ class Chef
           ui.color('Image', :bold),
           ui.color('Type', :bold),
           ui.color('Zone', :bold),
-          ui.color('Device Number', :bold)
+          ui.color('Device Number', :bold),
         ]
 
         opts = { depth: 1 }
 
         if config[:server_id]
-          server_api = Ionoscloud::ServerApi.new(api_client)
+          server_api = Ionoscloud::ServersApi.new(api_client)
           volumes = server_api.datacenters_servers_volumes_get(config[:datacenter_id], config[:server_id], opts)
         else
-          volume_api = Ionoscloud::VolumeApi.new(api_client)
+          volume_api = Ionoscloud::VolumesApi.new(api_client)
           volumes = volume_api.datacenters_volumes_get(config[:datacenter_id], opts)
         end