knife-ionoscloud 5.0.0.beta.1

data/lib/chef/knife/ionoscloud_snapshot_restore.rb

@@ -0,0 +1,69 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudSnapshotRestore < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud snapshot restore (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter DATACENTER_ID',
+              description: 'ID of the Datacenter'
+
+      option :volume_id,
+              short: '-V VOLUME_ID',
+              long: '--volume VOLUME_ID',
+              description: 'ID of the Volume'
+
+      option :snapshot_id,
+              short: '-S SNAPSHOT_ID',
+              long: '--snapshot SNAPSHOT_ID',
+              description: 'ID of the Snapshot'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'This will restore a snapshot onto a volume. A snapshot is created as just another image that '\
+        'can be used to create new volumes or to restore an existing volume.'
+        @required_options = [:datacenter_id, :volume_id, :snapshot_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        print "#{ui.color('Restoring Snapshot...', :magenta)}"
+
+        volume_api = Ionoscloud::VolumeApi.new(api_client)
+
+        _, _, headers  = volume_api.datacenters_volumes_restore_snapshot_post_with_http_info(
+          config[:datacenter_id],
+          config[:volume_id],
+          { snapshot_id: config[:snapshot_id] },
+        )
+
+        dot = ui.color('.', :magenta)
+        api_client.wait_for { print dot; is_done? get_request_id headers }
+
+        volume_api = Ionoscloud::VolumeApi.new(api_client)
+
+        volume = volume_api.datacenters_volumes_find_by_id(config[:datacenter_id], config[:volume_id])
+
+        puts "\n"
+        puts "#{ui.color('ID', :cyan)}: #{volume.id}"
+        puts "#{ui.color('Name', :cyan)}: #{volume.properties.name}"
+        puts "#{ui.color('Size', :cyan)}: #{volume.properties.size}"
+        puts "#{ui.color('Bus', :cyan)}: #{volume.properties.bus}"
+        puts "#{ui.color('Image', :cyan)}: #{volume.properties.image}"
+        puts "#{ui.color('Type', :cyan)}: #{volume.properties.type}"
+        puts "#{ui.color('Licence Type', :cyan)}: #{volume.properties.licence_type}"
+        puts "#{ui.color('Zone', :cyan)}: #{volume.properties.availability_zone}"
+        puts 'done'
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_user_create.rb

@@ -0,0 +1,83 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudUserCreate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud user create (options)'
+
+      option :firstname,
+              short: '-f FIRSTNAME',
+              long: '--firstname FIRSTNAME',
+              description: 'Firstname of the user.'
+
+      option :lastname,
+              short: '-l LASTNAME',
+              long: '--lastname LASTNAME',
+              description: 'Lastname of the user.'
+
+      option :email,
+              short: '-e EMAIL',
+              long: '--email EMAIL',
+              description: 'An e-mail address for the user.'
+
+      option :password,
+              short: '-p PASSWORD',
+              long: '--password PASSWORD',
+              description: 'A password for the user.'
+
+      option :administrator,
+              short: '-a ADMIN',
+              long: '--admin ADMIN',
+              description: 'Assigns the user have administrative rights.'
+
+      option :force_sec_auth,
+              long: '--sec-auth SEC_AUTH',
+              description: 'Indicates if secure (two-factor) authentication should be forced for the user.'
+
+      attr_reader :description, :required_options
+
+      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."
+        @required_options = [:firstname, :lastname, :email, :password, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        print "#{ui.color('Creating user...', :magenta)}"
+
+        user_management_api = Ionoscloud::UserManagementApi.new(api_client)
+
+        user, _, headers  = user_management_api.um_users_post_with_http_info({
+          properties: {
+            firstname: config[:firstname],
+            lastname: config[:lastname],
+            email: config[:email],
+            password: config[:password],
+            administrator: config[:administrator],
+            forceSecAuth: config[:force_sec_auth],
+          }.compact,
+        })
+
+        dot = ui.color('.', :magenta)
+        api_client.wait_for { print dot; is_done? get_request_id headers }
+
+        puts "\n"
+        puts "#{ui.color('ID', :cyan)}: #{user.id}"
+        puts "#{ui.color('Firstname', :cyan)}: #{user.properties.firstname}"
+        puts "#{ui.color('Lastname', :cyan)}: #{user.properties.lastname}"
+        puts "#{ui.color('Email', :cyan)}: #{user.properties.email}"
+        puts "#{ui.color('Administrator', :cyan)}: #{user.properties.administrator.to_s}"
+        puts "#{ui.color('2-Factor Auth', :cyan)}: #{user.properties.force_sec_auth.to_s}"
+        puts 'done'
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_user_delete.rb

@@ -0,0 +1,56 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudUserDelete < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud user delete USER_ID [USER_ID]'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Blacklists the user, disabling them. The user is not completely purged, '\
+        '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.'
+        @required_options = [:ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        user_management_api = Ionoscloud::UserManagementApi.new(api_client)
+
+        @name_args.each do |user_id|
+          begin
+            user = user_management_api.um_users_find_by_id(user_id)
+          rescue Ionoscloud::ApiError => err
+            raise err unless err.code == 404
+            ui.error("User ID #{user_id} not found. Skipping.")
+            next
+          end
+
+          msg_pair('ID', user.id)
+          msg_pair('Firstname', user.properties.firstname)
+          msg_pair('Lastname', user.properties.lastname)
+          msg_pair('Email', user.properties.email)
+          msg_pair('Administrator', user.properties.administrator.to_s)
+          msg_pair('2-Factor Auth', user.properties.force_sec_auth.to_s)
+          puts "\n"
+
+          begin
+            confirm('Do you really want to delete this User')
+          rescue SystemExit => exc
+            next
+          end
+
+          _, _, headers = user_management_api.um_users_delete_with_http_info(user_id)
+          ui.warn("Deleted User #{user.id}. Request ID: #{get_request_id headers}")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_user_list.rb

@@ -0,0 +1,60 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudUserList < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud user list (options)'
+
+      option :group_id,
+              short: '-g GROUP_ID',
+              long: '--group-id GROUP_ID',
+              description: 'ID of the group.'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @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.'
+        @required_options = [:ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        user_list = [
+          ui.color('ID', :bold),
+          ui.color('Firstname', :bold),
+          ui.color('Lastname', :bold),
+          ui.color('Email', :bold),
+          ui.color('Administrator', :bold),
+          ui.color('2-Factor Auth', :bold),
+        ]
+
+        user_management_api = Ionoscloud::UserManagementApi.new(api_client)
+
+        if config[:group_id]
+          users = user_management_api.um_groups_users_get(config[:group_id], { depth: 1 }).items
+        else
+          users = user_management_api.um_users_get({ depth: 1 }).items
+        end
+
+        users.each do |user|
+          user_list << user.id
+          user_list << user.properties.firstname
+          user_list << user.properties.lastname
+          user_list << user.properties.email
+          user_list << user.properties.administrator.to_s
+          user_list << user.properties.force_sec_auth.to_s
+        end
+
+        puts ui.list(user_list, :uneven_columns_across, 6)
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_user_ssourl.rb

@@ -0,0 +1,37 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudUserSsourl < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud user ssourl (options)'
+
+      option :user_id,
+              short: '-U USER_ID',
+              long: '--user-id USER_ID',
+              description: 'The ID of the Backup unit.'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Retrieve S3 object storage single signon URL for the given user.'
+        @required_options = [:user_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        begin
+          puts Ionoscloud::UserManagementApi.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.")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_volume_attach.rb

@@ -0,0 +1,52 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudVolumeAttach < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud volume attach VOLUME_ID [VOLUME_ID] (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'The ID of the data center'
+
+      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 attach a pre-existing storage volume to the server.'
+        @required_options = [:datacenter_id, :server_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        server_api = Ionoscloud::ServerApi.new(api_client)
+
+        @name_args.each do |volume_id|
+          begin
+            _, _, headers = server_api.datacenters_servers_volumes_post_with_http_info(
+              config[:datacenter_id],
+              config[:server_id],
+              { id: volume_id },
+            )
+          rescue Ionoscloud::ApiError => err
+            raise err unless err.code == 404
+            ui.error("Volume ID #{volume_id} not found. Skipping.")
+            next
+          end
+          ui.msg("Volume #{volume_id} attached to server. Request ID: #{get_request_id headers}")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_volume_create.rb

@@ -0,0 +1,133 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudVolumeCreate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud volume create (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'Name of the data center'
+
+      option :name,
+              short: '-n NAME',
+              long: '--name NAME',
+              description: 'Name of the volume'
+
+      option :size,
+              short: '-S SIZE',
+              long: '--size SIZE',
+              description: 'The size of the volume in GB'
+
+      option :bus,
+              short: '-b BUS',
+              long: '--bus BUS',
+              description: 'The bus type of the volume (VIRTIO or IDE)'
+
+      option :image,
+              short: '-N ID',
+              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',
+              description: 'The password set on the image for the "root" or "Administrator" user'
+
+      option :type,
+              short: '-t TYPE',
+              long: '--type TYPE',
+              description: 'The disk type (HDD OR SSD)'
+
+      option :licence_type,
+              short: '-l LICENCE',
+              long: '--licence-type LICENCE',
+              description: 'The licence type of the volume (LINUX, WINDOWS, UNKNOWN, OTHER)'
+
+      option :ssh_keys,
+              short: '-K SSHKEY[,SSHKEY,...]',
+              long: '--ssh-keys SSHKEY1,SSHKEY2,...',
+              description: 'A list of public SSH keys to include'
+
+      option :availability_zone,
+              short: '-Z AVAILABILITY_ZONE',
+              long: '--availability-zone AVAILABILITY_ZONE',
+              description: 'The volume availability zone of the server',
+              required: false
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        '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.'
+        @required_options = [:datacenter_id, :name, :type, :size, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        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
+
+        print "#{ui.color('Creating volume...', :magenta)}"
+
+        volume_api = Ionoscloud::VolumeApi.new(api_client)
+
+        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
+          },
+        )
+
+        dot = ui.color('.', :magenta)
+        api_client.wait_for(300) { print dot; is_done? get_request_id headers }
+
+        volume = volume_api.datacenters_volumes_find_by_id(config[:datacenter_id], volume.id)
+
+        puts "\n"
+        puts "#{ui.color('ID', :cyan)}: #{volume.id}"
+        puts "#{ui.color('Name', :cyan)}: #{volume.properties.name}"
+        puts "#{ui.color('Size', :cyan)}: #{volume.properties.size}"
+        puts "#{ui.color('Bus', :cyan)}: #{volume.properties.bus}"
+        puts "#{ui.color('Image', :cyan)}: #{volume.properties.image}"
+        puts "#{ui.color('Type', :cyan)}: #{volume.properties.type}"
+        puts "#{ui.color('Licence Type', :cyan)}: #{volume.properties.licence_type}"
+        puts "#{ui.color('Zone', :cyan)}: #{volume.properties.availability_zone}"
+        puts 'done'
+      end
+    end
+  end
+end