knife-ionoscloud 5.0.0.beta.1

data/lib/chef/knife/ionoscloud_resource_list.rb

@@ -0,0 +1,81 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudResourceList < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud resource list (options)'
+
+      option :resource_type,
+              short: '-t RESOURCE_TYPE',
+              long: '--resource-type RESOURCE_TYPE',
+              description: 'The specific type of resources to retrieve information about.'
+
+      option :resource_id,
+              short: '-R RESOURCE_ID',
+              long: '--resource-id RESOURCE_ID',
+              description: 'The ID of the specific resource to retrieve information about.'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        "No option: Retrieves a list of all resources and optionally their group associations. "\
+        "Please Note: This API call can take a significant amount of time to return when there "\
+        "are a large number of provisioned resources. You may wish to consult the next section "\
+        "on how to list resources of a particular type.\n\n"
+        "resource_type specified: Lists all shareable resources of a specific type. Optionally include their "\
+        "association with groups, permissions that a group has for the resource, and "\
+        "users that are members of the group. Because you are scoping your request to "\
+        "a specific resource type, this API will likely return faster than querying */um/resources*.\n\n"\
+        "The values available for resourceType are listed in this table:\n\n"\
+        "| ResourceType | Description |\n"\
+        "| datacenter | A virtual data center. |\n"\
+        "| image | A private image that has been uploaded. |\n"\
+        "| snapshot | A snapshot of a storage volume. |\n"\
+        "| ipblock | An IP block that has been reserved. |\n"\
+        "| k8s | A Kubernetes cluster. |\n\n"\
+        "resource_type and resource_id specified: Retrieves a specific resource."\
+        "**NOTE:** if you pass the *resource_id* option it is necessary to also pass the "\
+        "*resource_type* option or a list of all resources will be returned."
+        @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)
+
+        resource_list = [
+          ui.color('ID', :bold),
+          ui.color('Type', :bold),
+          ui.color('Name', :bold),
+        ]
+
+        if config[:resource_id] && !config[:resource_type]
+          ui.warn('Ignoring resource_id because no resource_type was specified.')
+        end
+
+        opts = { depth: 1 }
+
+        if config[:resource_type] && config[:resource_id]
+          resources = user_management_api.um_resources_find_by_type_and_id(config[:resource_type], config[:resource_id], opts)
+        elsif config[:resource_type]
+          resources = user_management_api.um_resources_find_by_type(config[:resource_type], opts)
+        else
+          resources = user_management_api.um_resources_get(opts)
+        end
+
+        resources.items.each do |resource|
+          resource_list << resource.id
+          resource_list << resource.type
+          resource_list << (resource.properties.respond_to?(:name) ? resource.properties.name : '')
+        end
+        puts ui.list(resource_list, :uneven_columns_across, 3)
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_s3key_create.rb

@@ -0,0 +1,45 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudS3keyCreate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud s3key create (options)'
+
+      option :user_id,
+              short: '-u USER_ID',
+              long: '--user USER_ID',
+              description: 'The ID of the user'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Creates a new S3 key for a particular user.'
+        @required_options = [:user_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        print "#{ui.color('Creating S3key...', :magenta)}"
+
+        user_management_api = Ionoscloud::UserManagementApi.new(api_client)
+
+        s3_key, _, headers  = user_management_api.um_users_s3keys_post_with_http_info(config[:user_id])
+
+        dot = ui.color('.', :magenta)
+        api_client.wait_for { print dot; is_done? get_request_id headers }
+
+        puts "\n"
+        puts "#{ui.color('ID', :cyan)}: #{s3_key.id}"
+        puts "#{ui.color('Secret Key', :cyan)}: #{s3_key.properties.secret_key}"
+        puts "#{ui.color('Active', :cyan)}: #{s3_key.properties.active}"
+        puts 'done'
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_s3key_delete.rb

@@ -0,0 +1,57 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudS3keyDelete < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud s3key delete S3KEY_ID [S3KEY_ID] (options)'
+
+      option :user_id,
+              short: '-u USER_ID',
+              long: '--user USER_ID',
+              description: 'The ID of the user'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'This operation deletes a specific S3 key.'
+        @required_options = [:user_id, :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 |s3key_id|
+          begin
+            s3_key = user_management_api.um_users_s3keys_find_by_key_id(config[:user_id], s3key_id)
+          rescue Ionoscloud::ApiError => err
+            raise err unless err.code == 404
+            ui.error("S3 key ID #{s3key_id} not found. Skipping.")
+            next
+          end
+
+          msg_pair('ID', s3_key.id)
+          msg_pair('Secret Key', s3_key.properties.secret_key)
+          msg_pair('Active', s3_key.properties.active.to_s)
+
+          puts "\n"
+
+          begin
+            confirm('Do you really want to delete this S3 key')
+          rescue SystemExit => exc
+            next
+          end
+
+          _, _, headers = user_management_api.um_users_s3keys_delete_with_http_info(config[:user_id], s3key_id)
+          ui.warn("Deleted S3 key #{s3_key.id}. Request ID: #{get_request_id headers}")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_s3key_list.rb

@@ -0,0 +1,46 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudS3keyList < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud s3key list (options)'
+
+      option :user_id,
+              short: '-u USER_ID',
+              long: '--user USER_ID',
+              description: 'The ID of the user'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'Retrieve a list of all the S3 keys for a specific user.'
+        @required_options = [:user_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        s3key_list = [
+          ui.color('ID', :bold),
+          ui.color('Secret Key', :bold),
+          ui.color('Active', :bold),
+        ]
+
+        user_management_api = Ionoscloud::UserManagementApi.new(api_client)
+
+        user_management_api.um_users_s3keys_get(config[:user_id], { depth: 1 }).items.each do |s3_key|
+          s3key_list << s3_key.id
+          s3key_list << s3_key.properties.secret_key
+          s3key_list << s3_key.properties.active.to_s
+        end
+
+        puts ui.list(s3key_list, :uneven_columns_across, 3)
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_server_create.rb

@@ -0,0 +1,104 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudServerCreate < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud server create (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'Name of the virtual datacenter'
+
+      option :name,
+              short: '-n NAME',
+              long: '--name NAME',
+              description: 'Name of the server'
+
+      option :cores,
+              short: '-C CORES',
+              long: '--cores CORES',
+              description: 'The number of processor cores'
+
+      option :cpu_family,
+              short: '-f CPU_FAMILY',
+              long: '--cpu-family CPU_FAMILY',
+              description: 'The family of the CPU (INTEL_XEON or AMD_OPTERON)',
+              default: 'INTEL_SKYLAKE'
+
+      option :ram,
+              short: '-r RAM',
+              long: '--ram RAM',
+              description: 'The amount of RAM in MB'
+
+      option :availability_zone,
+              short: '-a AVAILABILITY_ZONE',
+              long: '--availability-zone AVAILABILITY_ZONE',
+              description: 'The availability zone of the server',
+              default: 'AUTO'
+
+      option :boot_volume,
+              long: '--boot-volume VOLUME_ID',
+              description: 'Reference to a volume used for booting'
+
+      option :boot_cdrom,
+              long: '--boot-cdrom CDROM_ID',
+              description: 'Reference to a CD-ROM used for booting'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        "One of the unique features of the Ionoscloud platform when compared "\
+        "with the other providers is that they allow you to define your own settings "\
+        "for cores, memory, and disk size without being tied to a particular size or flavor.\n\n"\
+        "Note: *The memory parameter value must be a multiple of 256, e.g. 256, 512, 768, 1024, and so forth.*"
+        @required_options = [:datacenter_id, :cores, :ram, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        print "#{ui.color('Creating server...', :magenta)}"
+        params = {
+          name: config[:name],
+          cores: config[:cores],
+          cpuFamily: config[:cpu_family],
+          ram: config[:ram],
+          availabilityZone: config[:availability_zone]
+        }
+
+        params[:bootCdrom] = { id: config[:boot_cdrom] } unless config[:boot_cdrom].nil?
+        params[:bootVolume] = { id: config[:boot_volume] } unless config[:boot_volume].nil?
+
+        server_api = Ionoscloud::ServerApi.new(api_client)
+
+        server, _, headers = server_api.datacenters_servers_post_with_http_info(
+          config[:datacenter_id],
+          { properties: params.compact },
+        )
+
+        dot = ui.color('.', :magenta)
+        api_client.wait_for { print dot; is_done? get_request_id headers }
+
+        server = server_api.datacenters_servers_find_by_id(config[:datacenter_id], server.id)
+
+        puts "\n"
+        puts "#{ui.color('ID', :cyan)}: #{server.id}"
+        puts "#{ui.color('Name', :cyan)}: #{server.properties.name}"
+        puts "#{ui.color('Cores', :cyan)}: #{server.properties.cores}"
+        puts "#{ui.color('CPU Family', :cyan)}: #{server.properties.cpu_family}"
+        puts "#{ui.color('Ram', :cyan)}: #{server.properties.ram}"
+        puts "#{ui.color('Availability Zone', :cyan)}: #{server.properties.availability_zone}"
+        puts "#{ui.color('Boot Volume', :cyan)}: #{server.properties.boot_volume ? server.properties.boot_volume.id : ''}"
+        puts "#{ui.color('Boot CDROM', :cyan)}: #{server.properties.boot_cdrom ? server.properties.boot_cdrom.id : ''}"
+
+        puts 'done'
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_server_delete.rb

@@ -0,0 +1,62 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudServerDelete < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud server delete SERVER_ID [SERVER_ID] (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'Name of the data center'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        "This will remove a server from a VDC.\n\n"\
+        "**NOTE**: This will not automatically remove the storage volume(s) "\
+        "attached to a server. A separate API call is required to perform that action."
+        @required_options = [:datacenter_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 |server_id|
+          begin
+            server = server_api.datacenters_servers_find_by_id(config[:datacenter_id], server_id)
+          rescue Ionoscloud::ApiError => err
+            raise err unless err.code == 404
+            ui.error("Server ID #{server_id} not found. Skipping.")
+            next
+          end
+
+          msg_pair('ID', server.id)
+          msg_pair('Name', server.properties.name)
+          msg_pair('Cores', server.properties.cores)
+          msg_pair('CPU Family', server.properties.cpu_family)
+          msg_pair('Ram', server.properties.ram)
+          msg_pair('Availability Zone', server.properties.availability_zone)
+          msg_pair('Boot Volume', server.properties.boot_volume.id)
+          msg_pair('Boot CDROM', server.properties.boot_cdrom.id)
+
+          begin
+            confirm('Do you really want to delete this server')
+          rescue SystemExit => exc
+            next
+          end
+
+          _, _, headers = server_api.datacenters_servers_delete_with_http_info(config[:datacenter_id], server_id)
+          ui.warn("Deleted Server #{server.id}. Request ID: #{get_request_id headers}")
+        end
+      end
+    end
+  end
+end

data/lib/chef/knife/ionoscloud_server_list.rb

@@ -0,0 +1,58 @@
+require_relative 'ionoscloud_base'
+
+class Chef
+  class Knife
+    class IonoscloudServerList < Knife
+      include Knife::IonoscloudBase
+
+      banner 'knife ionoscloud server list (options)'
+
+      option :datacenter_id,
+              short: '-D DATACENTER_ID',
+              long: '--datacenter-id DATACENTER_ID',
+              description: 'The ID of the datacenter containing the server'
+
+      attr_reader :description, :required_options
+
+      def initialize(args = [])
+        super(args)
+        @description =
+        'List all available servers under a specified data center.'
+        @required_options = [:datacenter_id, :ionoscloud_username, :ionoscloud_password]
+      end
+
+      def run
+        $stdout.sync = true
+        validate_required_params(@required_options, config)
+
+        server_list = [
+          ui.color('ID', :bold),
+          ui.color('Name', :bold),
+          ui.color('Cores', :bold),
+          ui.color('CPU Family', :bold),
+          ui.color('RAM', :bold),
+          ui.color('Availability Zone', :bold),
+          ui.color('VM State', :bold),
+          ui.color('Boot Volume', :bold),
+          ui.color('Boot CDROM', :bold),
+        ]
+
+        server_api = Ionoscloud::ServerApi.new(api_client)
+
+        server_api.datacenters_servers_get(config[:datacenter_id], { depth: 1 }).items.each do |server|
+          server_list << server.id
+          server_list << server.properties.name
+          server_list << server.properties.cores.to_s
+          server_list << server.properties.cpu_family
+          server_list << server.properties.ram.to_s
+          server_list << server.properties.availability_zone
+          server_list << server.properties.vm_state
+          server_list << server.properties.boot_volume || ''
+          server_list << server.properties.boot_cdrom || ''
+        end
+
+        puts ui.list(server_list, :uneven_columns_across, 9)
+      end
+    end
+  end
+end