Class: Pvectl::Commands::FeatureVm

Inherits:
Object
  • Object
show all
Includes:
FeatureCommand
Defined in:
lib/pvectl/commands/feature_vm.rb,
sig/pvectl/commands/feature_vm.rbs

Overview

Handler for the pvectl feature vm command.

Queries whether a Proxmox feature (clone, snapshot, copy) is available for a virtual machine. Availability depends on storage type, snapshot state, and other server-side conditions.

Also registers the top-level feature GLI command and dispatches to FeatureVm or FeatureContainer based on the resource type.

Examples:

Check whether VM 100 can be cloned

pvectl feature vm 100 clone

Check snapshot feature against a specific snapshot

pvectl feature vm 100 snapshot --snapname pre-upgrade

Constant Summary collapse

RESOURCE_TYPE = 
:vm
SUPPORTED_RESOURCES = 
%w[vm].freeze

Constants included from FeatureCommand

Pvectl::Commands::FeatureCommand::VALID_FEATURES

Class Method Summary collapse

Methods included from FeatureCommand

#build_repository, #execute, #id_label, included, #initialize, #load_config, #output_result, #payload, #perform_operation, #resolve_resource, #resource_not_found, #resource_type_symbol, #stringify_keys, #type_name, #usage_error

Class Method Details

.register(cli) ⇒ void

This method returns an undefined value.

Registers the feature command with the CLI.



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/pvectl/commands/feature_vm.rb', line 27

def self.register(cli)
  cli.desc "Query whether a feature (clone/snapshot/copy) is available"
  cli.long_desc <<~HELP
    Check whether a Proxmox feature is available for a VM or container.
    Availability depends on the storage type backing the disks, current
    snapshot state, and other server-side conditions.

    Exit code is 0 when the feature is available, 1 when unavailable,
    5 when the resource is not found, and 2 on invalid usage.

    EXAMPLES
      Check whether VM 100 can be cloned:
        $ pvectl feature vm 100 clone

      Check snapshot feature on a container with a specific snapshot:
        $ pvectl feature ct 200 snapshot --snapname pre-upgrade

      Check copy feature for a VM:
        $ pvectl feature vm 100 copy

      JSON output (machine-readable):
        $ pvectl feature vm 100 clone -o json

    NOTES
      Supported features: clone, snapshot, copy.

      The Proxmox API returns the list of cluster nodes that can host
      the resource after the requested feature is applied. For VMs the
      list is printed under the "nodes:" line; for containers the LXC
      endpoint does not return this list.

      --snapname is required for some checks (e.g. checking whether a
      specific snapshot can be removed or cloned from).

    SEE ALSO
      pvectl help clone           Clone a VM or container
      pvectl help create snapshot Create a snapshot
      pvectl help get snapshots   List snapshots
  HELP
  cli.arg_name "RESOURCE_TYPE ID FEATURE"
  cli.command :feature do |c|
    c.desc "Snapshot name (optional, required for some checks)"
    c.flag [:snapname], arg_name: "NAME"

    c.action do |global_options, options, args|
      resource_type = args.shift

      exit_code = case resource_type
      when "vm"
        Commands::FeatureVm.execute(args, options, global_options)
      when "container", "ct"
        Commands::FeatureContainer.execute(args, options, global_options)
      else
        $stderr.puts "Error: Unknown resource type: #{resource_type}"
        $stderr.puts "Valid types: vm, container, ct"
        ExitCodes::USAGE_ERROR
      end

      exit exit_code if exit_code != 0
    end
  end
end