use PVE::INotify;
use PVE::Cluster qw(cfs_read_file);
use PVE::AccessControl;
+use PVE::Firewall;
use PVE::Storage;
use PVE::RESTHandler;
use PVE::RPCEnvironment;
use PVE::LXC;
-use PVE::LXCCreate;
+use PVE::LXC::Create;
+use PVE::LXC::Migrate;
+use PVE::API2::LXC::Config;
+use PVE::API2::LXC::Status;
+use PVE::API2::LXC::Snapshot;
use PVE::HA::Config;
use PVE::JSONSchema qw(get_standard_option);
use base qw(PVE::RESTHandler);
use Data::Dumper; # fixme: remove
-my $get_container_storage = sub {
- my ($stcfg, $vmid, $lxc_conf) = @_;
-
- if (my $volid = $lxc_conf->{'pve.volid'}) {
- my ($sid, $volname) = PVE::Storage::parse_volume_id($volid);
- return wantarray ? ($sid, $volname) : $sid;
- } else {
- my $path = $lxc_conf->{'lxc.rootfs'};
- my ($vtype, $volid) = PVE::Storage::path_to_volume_id($stcfg, $path);
- my ($sid, $volname) = PVE::Storage::parse_volume_id($volid, 1) if $volid;
- return wantarray ? ($sid, $volname, $path) : $sid;
- }
-};
-
-my $check_ct_modify_config_perm = sub {
- my ($rpcenv, $authuser, $vmid, $pool, $key_list) = @_;
-
- return 1 if $authuser ne 'root@pam';
-
- foreach my $opt (@$key_list) {
-
- if ($opt eq 'cpus' || $opt eq 'cpuunits' || $opt eq 'cpulimit') {
- $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.CPU']);
- } elsif ($opt eq 'disk') {
- $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Disk']);
- } elsif ($opt eq 'memory' || $opt eq 'swap') {
- $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Memory']);
- } elsif ($opt =~ m/^net\d+$/ || $opt eq 'nameserver' ||
- $opt eq 'searchdomain' || $opt eq 'hostname') {
- $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Network']);
- } else {
- $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Options']);
- }
- }
+__PACKAGE__->register_method ({
+ subclass => "PVE::API2::LXC::Config",
+ path => '{vmid}/config',
+});
+
+__PACKAGE__->register_method ({
+ subclass => "PVE::API2::LXC::Status",
+ path => '{vmid}/status',
+});
- return 1;
-};
+__PACKAGE__->register_method ({
+ subclass => "PVE::API2::LXC::Snapshot",
+ path => '{vmid}/snapshot',
+});
-PVE::JSONSchema::register_standard_option('pve-lxc-snapshot-name', {
- description => "The name of the snapshot.",
- type => 'string', format => 'pve-configid',
- maxLength => 40,
+__PACKAGE__->register_method ({
+ subclass => "PVE::API2::Firewall::CT",
+ path => '{vmid}/firewall',
});
__PACKAGE__->register_method({
additionalProperties => 0,
properties => PVE::LXC::json_config_properties({
node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
+ vmid => get_standard_option('pve-vmid', { completion => \&PVE::Cluster::complete_next_vmid }),
ostemplate => {
description => "The OS template or backup file.",
type => 'string',
maxLength => 255,
+ completion => \&PVE::LXC::complete_os_templates,
},
password => {
optional => 1,
minLength => 5,
},
storage => get_standard_option('pve-storage-id', {
- description => "Target storage.",
+ description => "Default Storage.",
default => 'local',
optional => 1,
}),
if (!($same_container_exists && $restore && $force)) {
PVE::Cluster::check_vmid_unused($vmid);
+ } else {
+ my $conf = PVE::LXC::load_config($vmid);
+ PVE::LXC::check_protection($conf, "unable to restore CT $vmid");
}
my $password = extract_param($param, 'password');
- my $storage = extract_param($param, 'storage') || 'local';
-
- my $pool = extract_param($param, 'pool');
-
+ my $storage = extract_param($param, 'storage') // 'local';
+
my $storage_cfg = cfs_read_file("storage.cfg");
my $scfg = PVE::Storage::storage_check_node($storage_cfg, $storage, $node);
raise_param_exc({ storage => "storage '$storage' does not support container root directories"})
- if !$scfg->{content}->{rootdir};
+ if !($scfg->{content}->{images} || $scfg->{content}->{rootdir});
+
+ my $pool = extract_param($param, 'pool');
if (defined($pool)) {
$rpcenv->check_pool_exist($pool);
$rpcenv->check_perm_modify($authuser, "/pool/$pool");
}
+ $rpcenv->check($authuser, "/storage/$storage", ['Datastore.AllocateSpace']);
+
if ($rpcenv->check($authuser, "/vms/$vmid", ['VM.Allocate'], 1)) {
# OK
} elsif ($pool && $rpcenv->check($authuser, "/pool/$pool", ['VM.Allocate'], 1)) {
raise_perm_exc();
}
- &$check_ct_modify_config_perm($rpcenv, $authuser, $vmid, $pool, [ keys %$param]);
+ PVE::LXC::check_ct_modify_config_perm($rpcenv, $authuser, $vmid, $pool, [ keys %$param]);
PVE::Storage::activate_storage($storage_cfg, $storage);
die "pipe can only be used with restore tasks\n"
if !$restore;
$archive = '-';
+ die "restore from pipe requires rootfs parameter\n" if !defined($param->{rootfs});
} else {
$rpcenv->check_volume_access($authuser, $storage_cfg, $vmid, $ostemplate);
$archive = PVE::Storage::abs_filesystem_path($storage_cfg, $ostemplate);
}
my $conf = {};
-
- if ($restore) {
- $conf = PVE::LXCCreate::recover_config($archive, $conf);
- PVE::LXC::lxc_config_change_vmid($conf, $vmid);
- }
-
- $param->{hostname} ||= "CT$vmid" if !defined($conf->{'lxc.utsname'});
- $param->{memory} ||= 512 if !defined($conf->{'lxc.cgroup.memory.limit_in_bytes'});
- $param->{swap} //= 512 if !defined($conf->{'lxc.cgroup.memory.memsw.limit_in_bytes'});
- PVE::LXC::update_lxc_config($vmid, $conf, 0, $param);
-
- # assigng default names, so that we can configure network with LXCSetup
- foreach my $k (keys %$conf) {
- next if $k !~ m/^net(\d+)$/;
- my $d = $conf->{$k};
- my $ind = $1;
- $d->{name} = "eth$ind"; # fixme: do not overwrite settings!
+ my $no_disk_param = {};
+ foreach my $opt (keys %$param) {
+ my $value = $param->{$opt};
+ if ($opt eq 'rootfs' || $opt =~ m/^mp\d+$/) {
+ # allow to use simple numbers (add default storage in that case)
+ $param->{$opt} = "$storage:$value" if $value =~ m/^\d+(\.\d+)?$/;
+ } else {
+ $no_disk_param->{$opt} = $value;
+ }
}
-
- # use user namespace ?
- # disable for now, because kernel 3.10.0 does not support it
- #$conf->{'lxc.id_map'} = ["u 0 100000 65536", "g 0 100000 65536"];
+ PVE::LXC::update_pct_config($vmid, $conf, 0, $no_disk_param);
my $check_vmid_usage = sub {
if ($force) {
- die "cant overwrite running container\n"
+ die "can't overwrite running container\n"
if PVE::LXC::check_running($vmid);
} else {
PVE::Cluster::check_vmid_unused($vmid);
};
my $code = sub {
- if ($restore && ($ostemplate =~ m/openvz/) ) {
- print "###########################################################\n";
- print "Restore from OpenVZ please check the config and add network\n";
- print "###########################################################\n";
- }
-
&$check_vmid_usage(); # final check after locking
-
+
PVE::Cluster::check_cfs_quorum();
+ my $vollist = [];
+
+ eval {
+ if (!defined($param->{rootfs})) {
+ if ($restore) {
+ my (undef, $disksize) = PVE::LXC::Create::recover_config($archive);
+ $disksize /= 1024 * 1024 * 1024; # create_disks expects GB as unit size
+ die "unable to detect disk size - please specify rootfs (size)\n"
+ if !$disksize;
+ $param->{rootfs} = "$storage:$disksize";
+ } else {
+ $param->{rootfs} = "$storage:4"; # defaults to 4GB
+ }
+ }
- PVE::LXCCreate::create_rootfs($storage_cfg, $storage, $param->{disk}, $vmid, $conf,
- $archive, $password, $restore);
+ $vollist = PVE::LXC::create_disks($storage_cfg, $vmid, $param, $conf);
+
+ PVE::LXC::Create::create_rootfs($storage_cfg, $vmid, $conf, $archive, $password, $restore);
+ # set some defaults
+ $conf->{hostname} ||= "CT$vmid";
+ $conf->{memory} ||= 512;
+ $conf->{swap} //= 512;
+ PVE::LXC::create_config($vmid, $conf);
+ };
+ if (my $err = $@) {
+ PVE::LXC::destroy_disks($storage_cfg, $vollist);
+ PVE::LXC::destroy_config($vmid);
+ die $err;
+ }
+ PVE::AccessControl::add_vm_to_pool($vmid, $pool) if $pool;
};
my $realcmd = sub { PVE::LXC::lock_container($vmid, 1, $code); };
}});
-my $vm_config_perm_list = [
- 'VM.Config.Disk',
- 'VM.Config.CPU',
- 'VM.Config.Memory',
- 'VM.Config.Network',
- 'VM.Config.Options',
- ];
-
-__PACKAGE__->register_method({
- name => 'update_vm',
- path => '{vmid}/config',
- method => 'PUT',
- protected => 1,
- proxyto => 'node',
- description => "Set container options.",
- permissions => {
- check => ['perm', '/vms/{vmid}', $vm_config_perm_list, any => 1],
- },
- parameters => {
- additionalProperties => 0,
- properties => PVE::LXC::json_config_properties(
- {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- delete => {
- type => 'string', format => 'pve-configid-list',
- description => "A list of settings you want to delete.",
- optional => 1,
- },
- digest => {
- type => 'string',
- description => 'Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.',
- maxLength => 40,
- optional => 1,
- }
- }),
- },
- returns => { type => 'null'},
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $node = extract_param($param, 'node');
-
- my $vmid = extract_param($param, 'vmid');
-
- my $digest = extract_param($param, 'digest');
-
- die "no options specified\n" if !scalar(keys %$param);
-
- my $delete_str = extract_param($param, 'delete');
- my @delete = PVE::Tools::split_list($delete_str);
-
- &$check_ct_modify_config_perm($rpcenv, $authuser, $vmid, undef, [@delete]);
-
- foreach my $opt (@delete) {
- raise_param_exc({ delete => "you can't use '-$opt' and " .
- "-delete $opt' at the same time" })
- if defined($param->{$opt});
-
- if (!PVE::LXC::option_exists($opt)) {
- raise_param_exc({ delete => "unknown option '$opt'" });
- }
- }
-
- &$check_ct_modify_config_perm($rpcenv, $authuser, $vmid, undef, [keys %$param]);
-
- my $code = sub {
-
- my $conf = PVE::LXC::load_config($vmid);
- PVE::LXC::check_lock($conf);
-
- PVE::Tools::assert_if_modified($digest, $conf->{digest});
-
- my $running = PVE::LXC::check_running($vmid);
-
- PVE::LXC::update_lxc_config($vmid, $conf, $running, $param, \@delete);
-
- PVE::LXC::write_config($vmid, $conf);
- };
-
- PVE::LXC::lock_container($vmid, undef, $code);
-
- return undef;
- }});
-
-__PACKAGE__->register_method ({
- subclass => "PVE::API2::Firewall::CT",
- path => '{vmid}/firewall',
-});
-
__PACKAGE__->register_method({
name => 'vmdiridx',
path => '{vmid}',
"pve2-vm/$param->{vmid}", $param->{timeframe}, $param->{cf});
}});
-
-__PACKAGE__->register_method({
- name => 'vm_config',
- path => '{vmid}/config',
- method => 'GET',
- proxyto => 'node',
- description => "Get container configuration.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- },
- },
- returns => {
- type => "object",
- properties => {
- digest => {
- type => 'string',
- description => 'SHA1 digest of configuration file. This can be used to prevent concurrent modifications.',
- }
- },
- },
- code => sub {
- my ($param) = @_;
-
- my $lxc_conf = PVE::LXC::load_config($param->{vmid});
-
- # NOTE: we only return selected/converted values
-
- my $conf = PVE::LXC::lxc_conf_to_pve($param->{vmid}, $lxc_conf);
-
- my $stcfg = PVE::Cluster::cfs_read_file("storage.cfg");
-
- my ($sid, undef, $path) = &$get_container_storage($stcfg, $param->{vmid}, $lxc_conf);
- $conf->{storage} = $sid || $path;
-
- return $conf;
- }});
-
__PACKAGE__->register_method({
name => 'destroy_vm',
path => '{vmid}',
additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
+ vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid_stopped }),
},
},
returns => {
my $storage_cfg = cfs_read_file("storage.cfg");
+ PVE::LXC::check_protection($conf, "can't remove CT $vmid");
+
+ die "unable to remove CT $vmid - used in HA resources\n"
+ if PVE::HA::Config::vm_is_ha_managed($vmid);
+
my $code = sub {
# reload config after lock
$conf = PVE::LXC::load_config($vmid);
PVE::LXC::check_lock($conf);
- PVE::LXC::destory_lxc_container($storage_cfg, $vmid, $conf);
- PVE::AccessControl::remove_vm_from_pool($vmid);
+ PVE::LXC::destroy_lxc_container($storage_cfg, $vmid, $conf);
+ PVE::AccessControl::remove_vm_access($vmid);
+ PVE::Firewall::remove_vmfw_conf($vmid);
};
my $realcmd = sub { PVE::LXC::lock_container($vmid, 1, $code); };
my $remcmd = $remip ?
['/usr/bin/ssh', '-t', $remip] : [];
+ my $conf = PVE::LXC::load_config($vmid, $node);
+ my $concmd = PVE::LXC::get_console_command($vmid, $conf);
+
my $shcmd = [ '/usr/bin/dtach', '-A',
"/var/run/dtach/vzctlconsole$vmid",
- '-r', 'winch', '-z',
- 'lxc-console', '-n', $vmid ];
+ '-r', 'winch', '-z', @$concmd];
my $realcmd = sub {
my $upid = shift;
my $authpath = "/vms/$vmid";
my $permissions = 'VM.Console';
+ my $conf = PVE::LXC::load_config($vmid);
+
+ die "CT $vmid not running\n" if !PVE::LXC::check_running($vmid);
+
+ my $concmd = PVE::LXC::get_console_command($vmid, $conf);
+
my $shcmd = ['/usr/bin/dtach', '-A',
"/var/run/dtach/vzctlconsole$vmid",
- '-r', 'winch', '-z',
- 'lxc-console', '-n', $vmid];
+ '-r', 'winch', '-z', @$concmd];
my $title = "CT $vmid";
return PVE::API2Tools::run_spiceterm($authpath, $permissions, $vmid, $node, $proxy, $title, $shcmd);
}});
-__PACKAGE__->register_method({
- name => 'vmcmdidx',
- path => '{vmid}/status',
- method => 'GET',
- proxyto => 'node',
- description => "Directory index",
- permissions => {
- user => 'all',
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- },
- },
- returns => {
- type => 'array',
- items => {
- type => "object",
- properties => {
- subdir => { type => 'string' },
- },
- },
- links => [ { rel => 'child', href => "{subdir}" } ],
- },
- code => sub {
- my ($param) = @_;
-
- # test if VM exists
- my $conf = PVE::LXC::load_config($param->{vmid});
-
- my $res = [
- { subdir => 'current' },
- { subdir => 'start' },
- { subdir => 'stop' },
- { subdir => 'shutdown' },
- { subdir => 'migrate' },
- ];
-
- return $res;
- }});
-
-__PACKAGE__->register_method({
- name => 'vm_status',
- path => '{vmid}/status/current',
- method => 'GET',
- proxyto => 'node',
- protected => 1, # openvz /proc entries are only readable by root
- description => "Get virtual machine status.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- },
- },
- returns => { type => 'object' },
- code => sub {
- my ($param) = @_;
-
- # test if VM exists
- my $conf = PVE::LXC::load_config($param->{vmid});
-
- my $vmstatus = PVE::LXC::vmstatus($param->{vmid});
- my $status = $vmstatus->{$param->{vmid}};
-
- $status->{ha} = PVE::HA::Config::vm_is_ha_managed($param->{vmid}) ? 1 : 0;
-
- return $status;
- }});
__PACKAGE__->register_method({
- name => 'vm_start',
- path => '{vmid}/status/start',
+ name => 'migrate_vm',
+ path => '{vmid}/migrate',
method => 'POST',
protected => 1,
proxyto => 'node',
- description => "Start the container.",
+ description => "Migrate the container to another node. Creates a new migration task.",
permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ check => ['perm', '/vms/{vmid}', [ 'VM.Migrate' ]],
},
parameters => {
additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
+ vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid }),
+ target => get_standard_option('pve-node', {
+ description => "Target node.",
+ completion => \&PVE::Cluster::complete_migration_target,
+ }),
+ online => {
+ type => 'boolean',
+ description => "Use online/live migration.",
+ optional => 1,
+ },
},
},
returns => {
type => 'string',
+ description => "the task ID.",
},
code => sub {
my ($param) = @_;
my $authuser = $rpcenv->get_user();
- my $node = extract_param($param, 'node');
+ my $target = extract_param($param, 'target');
+
+ my $localnode = PVE::INotify::nodename();
+ raise_param_exc({ target => "target is local node."}) if $target eq $localnode;
+
+ PVE::Cluster::check_cfs_quorum();
+
+ PVE::Cluster::check_node_exists($target);
+
+ my $targetip = PVE::Cluster::remote_node_ip($target);
my $vmid = extract_param($param, 'vmid');
- die "CT $vmid already running\n" if PVE::LXC::check_running($vmid);
+ # test if VM exists
+ PVE::LXC::load_config($vmid);
+
+ # try to detect errors early
+ if (PVE::LXC::check_running($vmid)) {
+ die "can't migrate running container without --online\n"
+ if !$param->{online};
+ }
if (PVE::HA::Config::vm_is_ha_managed($vmid) && $rpcenv->{type} ne 'ha') {
my $service = "ct:$vmid";
- my $cmd = ['ha-manager', 'enable', $service];
+ my $cmd = ['ha-manager', 'migrate', $service, $target];
- print "Executing HA start for CT $vmid\n";
+ print "Executing HA migrate for CT $vmid to node $target\n";
PVE::Tools::run_command($cmd);
return;
};
- return $rpcenv->fork_worker('hastart', $vmid, $authuser, $hacmd);
+ return $rpcenv->fork_worker('hamigrate', $vmid, $authuser, $hacmd);
} else {
my $realcmd = sub {
my $upid = shift;
- syslog('info', "starting CT $vmid: $upid\n");
-
- my $conf = PVE::LXC::load_config($vmid);
- my $stcfg = cfs_read_file("storage.cfg");
- if (my $sid = &$get_container_storage($stcfg, $vmid, $conf)) {
- PVE::Storage::activate_storage($stcfg, $sid);
- }
-
- my $cmd = ['lxc-start', '-n', $vmid];
-
- run_command($cmd);
+ PVE::LXC::Migrate->migrate($target, $targetip, $vmid, $param);
return;
};
- return $rpcenv->fork_worker('vzstart', $vmid, $authuser, $realcmd);
+ return $rpcenv->fork_worker('vzmigrate', $vmid, $authuser, $realcmd);
}
}});
__PACKAGE__->register_method({
- name => 'vm_stop',
- path => '{vmid}/status/stop',
- method => 'POST',
- protected => 1,
+ name => 'vm_feature',
+ path => '{vmid}/feature',
+ method => 'GET',
proxyto => 'node',
- description => "Stop the container.",
+ protected => 1,
+ description => "Check if feature for virtual machine is available.",
permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
},
parameters => {
- additionalProperties => 0,
+ additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
vmid => get_standard_option('pve-vmid'),
+ feature => {
+ description => "Feature to check.",
+ type => 'string',
+ enum => [ 'snapshot' ],
+ },
+ snapname => get_standard_option('pve-lxc-snapshot-name', {
+ optional => 1,
+ }),
},
},
returns => {
- type => 'string',
+ type => "object",
+ properties => {
+ hasFeature => { type => 'boolean' },
+ #nodes => {
+ #type => 'array',
+ #items => { type => 'string' },
+ #}
+ },
},
code => sub {
my ($param) = @_;
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $node = extract_param($param, 'node');
-
- my $vmid = extract_param($param, 'vmid');
-
- die "CT $vmid not running\n" if !PVE::LXC::check_running($vmid);
-
- if (PVE::HA::Config::vm_is_ha_managed($vmid) && $rpcenv->{type} ne 'ha') {
-
- my $hacmd = sub {
- my $upid = shift;
-
- my $service = "ct:$vmid";
-
- my $cmd = ['ha-manager', 'disable', $service];
-
- print "Executing HA stop for CT $vmid\n";
-
- PVE::Tools::run_command($cmd);
-
- return;
- };
-
- return $rpcenv->fork_worker('hastop', $vmid, $authuser, $hacmd);
-
- } else {
-
- my $realcmd = sub {
- my $upid = shift;
-
- syslog('info', "stoping CT $vmid: $upid\n");
-
- my $cmd = ['lxc-stop', '-n', $vmid, '--kill'];
-
- run_command($cmd);
-
- return;
- };
-
- return $rpcenv->fork_worker('vzstop', $vmid, $authuser, $realcmd);
- }
- }});
-
-__PACKAGE__->register_method({
- name => 'vm_shutdown',
- path => '{vmid}/status/shutdown',
- method => 'POST',
- protected => 1,
- proxyto => 'node',
- description => "Shutdown the container.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- timeout => {
- description => "Wait maximal timeout seconds.",
- type => 'integer',
- minimum => 0,
- optional => 1,
- default => 60,
- },
- forceStop => {
- description => "Make sure the Container stops.",
- type => 'boolean',
- optional => 1,
- default => 0,
- }
- },
- },
- returns => {
- type => 'string',
- },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $node = extract_param($param, 'node');
-
- my $vmid = extract_param($param, 'vmid');
-
- my $timeout = extract_param($param, 'timeout');
-
- die "CT $vmid not running\n" if !PVE::LXC::check_running($vmid);
-
- my $realcmd = sub {
- my $upid = shift;
-
- syslog('info', "shutdown CT $vmid: $upid\n");
-
- my $cmd = ['lxc-stop', '-n', $vmid];
-
- $timeout = 60 if !defined($timeout);
-
- push @$cmd, '--timeout', $timeout;
-
- eval { run_command($cmd, timeout => $timeout+5); };
- my $err = $@;
- return if !$err;
-
- die $err if !$param->{forceStop};
-
- warn "shutdown failed - forcing stop now\n";
-
- push @$cmd, '--kill';
- run_command($cmd);
-
- return;
- };
-
- my $upid = $rpcenv->fork_worker('vzshutdown', $vmid, $authuser, $realcmd);
-
- return $upid;
- }});
-
-__PACKAGE__->register_method({
- name => 'vm_suspend',
- path => '{vmid}/status/suspend',
- method => 'POST',
- protected => 1,
- proxyto => 'node',
- description => "Suspend the container.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- },
- },
- returns => {
- type => 'string',
- },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $node = extract_param($param, 'node');
-
- my $vmid = extract_param($param, 'vmid');
-
- die "CT $vmid not running\n" if !PVE::LXC::check_running($vmid);
-
- my $realcmd = sub {
- my $upid = shift;
-
- syslog('info', "suspend CT $vmid: $upid\n");
-
- my $cmd = ['lxc-checkpoint', '-n', $vmid, '-s', '-D', '/var/liv/vz/dump'];
-
- run_command($cmd);
-
- return;
- };
-
- my $upid = $rpcenv->fork_worker('vzsuspend', $vmid, $authuser, $realcmd);
-
- return $upid;
- }});
-
-__PACKAGE__->register_method({
- name => 'vm_resume',
- path => '{vmid}/status/resume',
- method => 'POST',
- protected => 1,
- proxyto => 'node',
- description => "Resume the container.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- },
- },
- returns => {
- type => 'string',
- },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $node = extract_param($param, 'node');
-
- my $vmid = extract_param($param, 'vmid');
-
- die "CT $vmid already running\n" if PVE::LXC::check_running($vmid);
-
- my $realcmd = sub {
- my $upid = shift;
-
- syslog('info', "resume CT $vmid: $upid\n");
-
- my $cmd = ['lxc-checkpoint', '-n', $vmid, '-r', '--foreground',
- '-D', '/var/liv/vz/dump'];
-
- run_command($cmd);
-
- return;
- };
-
- my $upid = $rpcenv->fork_worker('vzresume', $vmid, $authuser, $realcmd);
-
- return $upid;
- }});
-
-__PACKAGE__->register_method({
- name => 'migrate_vm',
- path => '{vmid}/migrate',
- method => 'POST',
- protected => 1,
- proxyto => 'node',
- description => "Migrate the container to another node. Creates a new migration task.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Migrate' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- target => get_standard_option('pve-node', { description => "Target node." }),
- online => {
- type => 'boolean',
- description => "Use online/live migration.",
- optional => 1,
- },
- },
- },
- returns => {
- type => 'string',
- description => "the task ID.",
- },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $target = extract_param($param, 'target');
-
- my $localnode = PVE::INotify::nodename();
- raise_param_exc({ target => "target is local node."}) if $target eq $localnode;
-
- PVE::Cluster::check_cfs_quorum();
-
- PVE::Cluster::check_node_exists($target);
-
- my $targetip = PVE::Cluster::remote_node_ip($target);
-
- my $vmid = extract_param($param, 'vmid');
-
- # test if VM exists
- PVE::LXC::load_config($vmid);
-
- # try to detect errors early
- if (PVE::LXC::check_running($vmid)) {
- die "cant migrate running container without --online\n"
- if !$param->{online};
- }
-
- if (PVE::HA::Config::vm_is_ha_managed($vmid) && $rpcenv->{type} ne 'ha') {
-
- my $hacmd = sub {
- my $upid = shift;
-
- my $service = "ct:$vmid";
-
- my $cmd = ['ha-manager', 'migrate', $service, $target];
-
- print "Executing HA migrate for CT $vmid to node $target\n";
-
- PVE::Tools::run_command($cmd);
-
- return;
- };
-
- return $rpcenv->fork_worker('hamigrate', $vmid, $authuser, $hacmd);
-
- } else {
-
- my $realcmd = sub {
- my $upid = shift;
-
- # fixme: implement lxc container migration
- die "lxc container migration not implemented\n";
-
- return;
- };
-
- return $rpcenv->fork_worker('vzmigrate', $vmid, $authuser, $realcmd);
- }
- }});
-
-__PACKAGE__->register_method({
- name => 'snapshot',
- path => '{vmid}/snapshot',
- method => 'POST',
- protected => 1,
- proxyto => 'node',
- description => "Snapshot a container.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Snapshot' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- snapname => get_standard_option('pve-lxc-snapshot-name'),
- vmstate => {
- optional => 1,
- type => 'boolean',
- description => "Save the vmstate",
- },
- description => {
- optional => 1,
- type => 'string',
- description => "A textual description or comment.",
- },
- },
- },
- returns => {
- type => 'string',
- description => "the task ID.",
- },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
my $node = extract_param($param, 'node');
my $vmid = extract_param($param, 'vmid');
my $snapname = extract_param($param, 'snapname');
- die "unable to use snapshot name 'current' (reserved name)\n"
- if $snapname eq 'current';
-
- my $realcmd = sub {
- PVE::Cluster::log_msg('info', $authuser, "snapshot container $vmid: $snapname");
- PVE::LXC::snapshot_create($vmid, $snapname, $param->{description});
- };
-
- return $rpcenv->fork_worker('pctsnapshot', $vmid, $authuser, $realcmd);
- }});
-
-__PACKAGE__->register_method({
- name => 'delsnapshot',
- path => '{vmid}/snapshot/{snapname}',
- method => 'DELETE',
- protected => 1,
- proxyto => 'node',
- description => "Delete a LXC snapshot.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Snapshot' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- snapname => get_standard_option('pve-lxc-snapshot-name'),
- force => {
- optional => 1,
- type => 'boolean',
- description => "For removal from config file, even if removing disk snapshots fails.",
- },
- },
- },
- returns => {
- type => 'string',
- description => "the task ID.",
- },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $node = extract_param($param, 'node');
+ my $feature = extract_param($param, 'feature');
- my $vmid = extract_param($param, 'vmid');
+ my $conf = PVE::LXC::load_config($vmid);
- my $snapname = extract_param($param, 'snapname');
+ if($snapname){
+ my $snap = $conf->{snapshots}->{$snapname};
+ die "snapshot '$snapname' does not exist\n" if !defined($snap);
+ $conf = $snap;
+ }
+ my $storage_cfg = PVE::Storage::config();
+ #Maybe include later
+ #my $nodelist = PVE::LXC::shared_nodes($conf, $storage_cfg);
+ my $hasFeature = PVE::LXC::has_feature($feature, $conf, $storage_cfg, $snapname);
- my $realcmd = sub {
- PVE::Cluster::log_msg('info', $authuser, "delete snapshot VM $vmid: $snapname");
- PVE::LXC::snapshot_delete($vmid, $snapname, $param->{force});
+ return {
+ hasFeature => $hasFeature,
+ #nodes => [ keys %$nodelist ],
};
-
- return $rpcenv->fork_worker('lxcdelsnapshot', $vmid, $authuser, $realcmd);
}});
__PACKAGE__->register_method({
- name => 'rollback',
- path => '{vmid}/snapshot/{snapname}/rollback',
+ name => 'template',
+ path => '{vmid}/template',
method => 'POST',
protected => 1,
proxyto => 'node',
- description => "Rollback LXC state to specified snapshot.",
+ description => "Create a Template.",
permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Snapshot' ]],
+ description => "You need 'VM.Allocate' permissions on /vms/{vmid}",
+ check => [ 'perm', '/vms/{vmid}', ['VM.Allocate']],
},
parameters => {
additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- snapname => get_standard_option('pve-lxc-snapshot-name'),
+ vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid_stopped }),
},
},
- returns => {
- type => 'string',
- description => "the task ID.",
- },
+ returns => { type => 'null'},
code => sub {
my ($param) = @_;
my $vmid = extract_param($param, 'vmid');
- my $snapname = extract_param($param, 'snapname');
-
- my $realcmd = sub {
- PVE::Cluster::log_msg('info', $authuser, "rollback snapshot LXC $vmid: $snapname");
- PVE::LXC::snapshot_rollback($vmid, $snapname);
- };
-
- return $rpcenv->fork_worker('lxcrollback', $vmid, $authuser, $realcmd);
- }});
-
-__PACKAGE__->register_method({
- name => 'snapshot_list',
- path => '{vmid}/snapshot',
- method => 'GET',
- description => "List all snapshots.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
- },
- proxyto => 'node',
- protected => 1, # lxc pid files are only readable by root
- parameters => {
- additionalProperties => 0,
- properties => {
- vmid => get_standard_option('pve-vmid'),
- node => get_standard_option('pve-node'),
- },
- },
- returns => {
- type => 'array',
- items => {
- type => "object",
- properties => {},
- },
- links => [ { rel => 'child', href => "{name}" } ],
- },
- code => sub {
- my ($param) = @_;
-
- my $vmid = $param->{vmid};
-
- my $conf = PVE::LXC::load_config($vmid);
- my $snaphash = $conf->{snapshots} || {};
-
- my $res = [];
-
- foreach my $name (keys %$snaphash) {
- my $d = $snaphash->{$name};
- my $item = {
- name => $name,
- snaptime => $d->{'pve.snaptime'} || 0,
- description => $d->{'pve.snapcomment'} || '',
- };
- $item->{parent} = $d->{'pve.parent'} if $d->{'pve.parent'};
- $item->{snapstate} = $d->{'pve.snapstate'} if $d->{'pve.snapstate'};
- push @$res, $item;
- }
-
- my $running = PVE::LXC::check_running($vmid) ? 1 : 0;
- my $current = { name => 'current', digest => $conf->{digest}, running => $running };
- $current->{parent} = $conf->{'pve.parent'} if $conf->{'pve.parent'};
-
- push @$res, $current;
-
- return $res;
- }});
-
-__PACKAGE__->register_method({
- name => 'snapshot_cmd_idx',
- path => '{vmid}/snapshot/{snapname}',
- description => '',
- method => 'GET',
- permissions => {
- user => 'all',
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- vmid => get_standard_option('pve-vmid'),
- node => get_standard_option('pve-node'),
- snapname => get_standard_option('pve-lxc-snapshot-name'),
- },
- },
- returns => {
- type => 'array',
- items => {
- type => "object",
- properties => {},
- },
- links => [ { rel => 'child', href => "{cmd}" } ],
- },
- code => sub {
- my ($param) = @_;
-
- my $res = [];
-
- push @$res, { cmd => 'rollback' };
- push @$res, { cmd => 'config' };
-
- return $res;
- }});
-
-__PACKAGE__->register_method({
- name => 'update_snapshot_config',
- path => '{vmid}/snapshot/{snapname}/config',
- method => 'PUT',
- protected => 1,
- proxyto => 'node',
- description => "Update snapshot metadata.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Snapshot' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- snapname => get_standard_option('pve-lxc-snapshot-name'),
- description => {
- optional => 1,
- type => 'string',
- description => "A textual description or comment.",
- },
- },
- },
- returns => { type => 'null' },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
-
- my $authuser = $rpcenv->get_user();
-
- my $vmid = extract_param($param, 'vmid');
-
- my $snapname = extract_param($param, 'snapname');
-
- return undef if !defined($param->{description});
-
my $updatefn = sub {
my $conf = PVE::LXC::load_config($vmid);
PVE::LXC::check_lock($conf);
- my $snap = $conf->{snapshots}->{$snapname};
-
- die "snapshot '$snapname' does not exist\n" if !defined($snap);
-
- $snap->{'pve.snapcomment'} = $param->{description} if defined($param->{description});
-
- PVE::LXC::write_config($vmid, $conf, 1);
- };
-
- PVE::LXC::lock_container($vmid, 10, $updatefn);
-
- return undef;
- }});
-
-__PACKAGE__->register_method({
- name => 'get_snapshot_config',
- path => '{vmid}/snapshot/{snapname}/config',
- method => 'GET',
- proxyto => 'node',
- description => "Get snapshot configuration",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Snapshot' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- snapname => get_standard_option('pve-lxc-snapshot-name'),
- },
- },
- returns => { type => "object" },
- code => sub {
- my ($param) = @_;
-
- my $rpcenv = PVE::RPCEnvironment::get();
+ die "unable to create template, because CT contains snapshots\n"
+ if $conf->{snapshots} && scalar(keys %{$conf->{snapshots}});
- my $authuser = $rpcenv->get_user();
+ die "you can't convert a template to a template\n"
+ if PVE::LXC::is_template($conf);
- my $vmid = extract_param($param, 'vmid');
+ die "you can't convert a CT to template if the CT is running\n"
+ if PVE::LXC::check_running($vmid);
- my $snapname = extract_param($param, 'snapname');
+ my $realcmd = sub {
+ PVE::LXC::template_create($vmid, $conf);
+ };
- my $lxc_conf = PVE::LXC::load_config($vmid);
+ $conf->{template} = 1;
- my $snap = $lxc_conf->{snapshots}->{$snapname};
+ PVE::LXC::write_config($vmid, $conf);
+ # and remove lxc config
+ PVE::LXC::update_lxc_config(undef, $vmid, $conf);
- die "snapshot '$snapname' does not exist\n" if !defined($snap);
+ return $rpcenv->fork_worker('vztemplate', $vmid, $authuser, $realcmd);
+ };
- my $conf = PVE::LXC::lxc_conf_to_pve($param->{vmid}, $snap);
+ PVE::LXC::lock_container($vmid, undef, $updatefn);
- return $conf;
+ return undef;
}});
-__PACKAGE__->register_method({
- name => 'vm_feature',
- path => '{vmid}/feature',
- method => 'GET',
- proxyto => 'node',
- protected => 1,
- description => "Check if feature for virtual machine is available.",
- permissions => {
- check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
- },
- parameters => {
- additionalProperties => 0,
- properties => {
- node => get_standard_option('pve-node'),
- vmid => get_standard_option('pve-vmid'),
- feature => {
- description => "Feature to check.",
- type => 'string',
- enum => [ 'snapshot' ],
- },
- snapname => get_standard_option('pve-lxc-snapshot-name', {
- optional => 1,
- }),
- },
- },
- returns => {
- type => "object",
- properties => {
- hasFeature => { type => 'boolean' },
- #nodes => {
- #type => 'array',
- #items => { type => 'string' },
- #}
- },
- },
- code => sub {
- my ($param) = @_;
-
- my $node = extract_param($param, 'node');
-
- my $vmid = extract_param($param, 'vmid');
-
- my $snapname = extract_param($param, 'snapname');
-
- my $feature = extract_param($param, 'feature');
-
- my $conf = PVE::LXC::load_config($vmid);
-
- if($snapname){
- my $snap = $conf->{snapshots}->{$snapname};
- die "snapshot '$snapname' does not exist\n" if !defined($snap);
- $conf = $snap;
- }
- my $storecfg = PVE::Storage::config();
- #Maybe include later
- #my $nodelist = PVE::LXC::shared_nodes($conf, $storecfg);
- my $hasFeature = PVE::LXC::has_feature($feature, $conf, $storecfg, $snapname);
-
- return {
- hasFeature => $hasFeature,
- #nodes => [ keys %$nodelist ],
- };
- }});
1;