]> git.proxmox.com Git - pve-container.git/blame - src/PVE/API2/LXC.pm
use copy_volume for full clones
[pve-container.git] / src / PVE / API2 / LXC.pm
CommitLineData
f76a2828
DM
1package PVE::API2::LXC;
2
3use strict;
4use warnings;
5
6use PVE::SafeSyslog;
7use PVE::Tools qw(extract_param run_command);
8use PVE::Exception qw(raise raise_param_exc);
9use PVE::INotify;
9c2d4ce9 10use PVE::Cluster qw(cfs_read_file);
f76a2828 11use PVE::AccessControl;
2f9b5ead 12use PVE::Firewall;
f76a2828
DM
13use PVE::Storage;
14use PVE::RESTHandler;
15use PVE::RPCEnvironment;
c5a8e04f 16use PVE::ReplicationConfig;
f76a2828 17use PVE::LXC;
7af97ad5 18use PVE::LXC::Create;
6f42807e 19use PVE::LXC::Migrate;
56462053 20use PVE::GuestHelpers;
52389a07
DM
21use PVE::API2::LXC::Config;
22use PVE::API2::LXC::Status;
23use PVE::API2::LXC::Snapshot;
f76a2828
DM
24use PVE::JSONSchema qw(get_standard_option);
25use base qw(PVE::RESTHandler);
26
6c2e9377
WB
27BEGIN {
28 if (!$ENV{PVE_GENERATING_DOCS}) {
29 require PVE::HA::Env::PVE2;
30 import PVE::HA::Env::PVE2;
31 require PVE::HA::Config;
32 import PVE::HA::Config;
33 }
34}
f76a2828 35
52389a07
DM
36__PACKAGE__->register_method ({
37 subclass => "PVE::API2::LXC::Config",
38 path => '{vmid}/config',
39});
f76a2828 40
52389a07
DM
41__PACKAGE__->register_method ({
42 subclass => "PVE::API2::LXC::Status",
43 path => '{vmid}/status',
44});
f76a2828 45
52389a07
DM
46__PACKAGE__->register_method ({
47 subclass => "PVE::API2::LXC::Snapshot",
48 path => '{vmid}/snapshot',
49});
f76a2828 50
52389a07
DM
51__PACKAGE__->register_method ({
52 subclass => "PVE::API2::Firewall::CT",
53 path => '{vmid}/firewall',
54});
1e6c8d5b 55
f76a2828 56__PACKAGE__->register_method({
5c752bbf
DM
57 name => 'vmlist',
58 path => '',
f76a2828
DM
59 method => 'GET',
60 description => "LXC container index (per node).",
61 permissions => {
62 description => "Only list CTs where you have VM.Audit permissons on /vms/<vmid>.",
63 user => 'all',
64 },
65 proxyto => 'node',
66 protected => 1, # /proc files are only readable by root
67 parameters => {
68 additionalProperties => 0,
69 properties => {
70 node => get_standard_option('pve-node'),
71 },
72 },
73 returns => {
74 type => 'array',
75 items => {
76 type => "object",
77 properties => {},
78 },
79 links => [ { rel => 'child', href => "{vmid}" } ],
80 },
81 code => sub {
82 my ($param) = @_;
83
84 my $rpcenv = PVE::RPCEnvironment::get();
85 my $authuser = $rpcenv->get_user();
86
87 my $vmstatus = PVE::LXC::vmstatus();
88
89 my $res = [];
90 foreach my $vmid (keys %$vmstatus) {
91 next if !$rpcenv->check($authuser, "/vms/$vmid", [ 'VM.Audit' ], 1);
92
93 my $data = $vmstatus->{$vmid};
94 $data->{vmid} = $vmid;
95 push @$res, $data;
96 }
97
98 return $res;
5c752bbf 99
f76a2828
DM
100 }});
101
9c2d4ce9 102__PACKAGE__->register_method({
5c752bbf
DM
103 name => 'create_vm',
104 path => '',
9c2d4ce9
DM
105 method => 'POST',
106 description => "Create or restore a container.",
107 permissions => {
108 user => 'all', # check inside
109 description => "You need 'VM.Allocate' permissions on /vms/{vmid} or on the VM pool /pool/{pool}. " .
110 "For restore, it is enough if the user has 'VM.Backup' permission and the VM already exists. " .
111 "You also need 'Datastore.AllocateSpace' permissions on the storage.",
112 },
113 protected => 1,
114 proxyto => 'node',
115 parameters => {
116 additionalProperties => 0,
1b4cf758 117 properties => PVE::LXC::Config->json_config_properties({
9c2d4ce9 118 node => get_standard_option('pve-node'),
781e26b2 119 vmid => get_standard_option('pve-vmid', { completion => \&PVE::Cluster::complete_next_vmid }),
9c2d4ce9
DM
120 ostemplate => {
121 description => "The OS template or backup file.",
5c752bbf 122 type => 'string',
9c2d4ce9 123 maxLength => 255,
68e8f3c5 124 completion => \&PVE::LXC::complete_os_templates,
9c2d4ce9 125 },
5c752bbf
DM
126 password => {
127 optional => 1,
9c2d4ce9
DM
128 type => 'string',
129 description => "Sets root password inside container.",
168d6b07 130 minLength => 5,
9c2d4ce9
DM
131 },
132 storage => get_standard_option('pve-storage-id', {
eb35f9c0 133 description => "Default Storage.",
9c2d4ce9
DM
134 default => 'local',
135 optional => 1,
c5362cda 136 completion => \&PVE::Storage::complete_storage_enabled,
9c2d4ce9
DM
137 }),
138 force => {
5c752bbf 139 optional => 1,
9c2d4ce9
DM
140 type => 'boolean',
141 description => "Allow to overwrite existing container.",
142 },
143 restore => {
5c752bbf 144 optional => 1,
9c2d4ce9
DM
145 type => 'boolean',
146 description => "Mark this as restore task.",
147 },
5c752bbf 148 pool => {
9c2d4ce9
DM
149 optional => 1,
150 type => 'string', format => 'pve-poolid',
151 description => "Add the VM to the specified pool.",
152 },
7c78b6cc
WB
153 'ignore-unpack-errors' => {
154 optional => 1,
155 type => 'boolean',
156 description => "Ignore errors when extracting the template.",
157 },
34ddbf08
FG
158 'ssh-public-keys' => {
159 optional => 1,
160 type => 'string',
161 description => "Setup public SSH keys (one key per line, " .
162 "OpenSSH format).",
163 },
9c2d4ce9
DM
164 }),
165 },
5c752bbf 166 returns => {
9c2d4ce9
DM
167 type => 'string',
168 },
169 code => sub {
170 my ($param) = @_;
171
172 my $rpcenv = PVE::RPCEnvironment::get();
173
174 my $authuser = $rpcenv->get_user();
175
176 my $node = extract_param($param, 'node');
177
178 my $vmid = extract_param($param, 'vmid');
179
7c78b6cc
WB
180 my $ignore_unpack_errors = extract_param($param, 'ignore-unpack-errors');
181
67afe46e 182 my $basecfg_fn = PVE::LXC::Config->config_file($vmid);
9c2d4ce9
DM
183
184 my $same_container_exists = -f $basecfg_fn;
185
425b62cb
WB
186 # 'unprivileged' is read-only, so we can't pass it to update_pct_config
187 my $unprivileged = extract_param($param, 'unprivileged');
188
9c2d4ce9
DM
189 my $restore = extract_param($param, 'restore');
190
148d1cb4
DM
191 if ($restore) {
192 # fixme: limit allowed parameters
193
194 }
195
9c2d4ce9
DM
196 my $force = extract_param($param, 'force');
197
198 if (!($same_container_exists && $restore && $force)) {
199 PVE::Cluster::check_vmid_unused($vmid);
e22af68f 200 } else {
67afe46e
FG
201 my $conf = PVE::LXC::Config->load_config($vmid);
202 PVE::LXC::Config->check_protection($conf, "unable to restore CT $vmid");
9c2d4ce9 203 }
5c752bbf 204
9c2d4ce9
DM
205 my $password = extract_param($param, 'password');
206
34ddbf08 207 my $ssh_keys = extract_param($param, 'ssh-public-keys');
2130286f 208 PVE::Tools::validate_ssh_public_keys($ssh_keys) if defined($ssh_keys);
34ddbf08 209
27916659
DM
210 my $pool = extract_param($param, 'pool');
211
9c2d4ce9
DM
212 if (defined($pool)) {
213 $rpcenv->check_pool_exist($pool);
214 $rpcenv->check_perm_modify($authuser, "/pool/$pool");
5c752bbf 215 }
9c2d4ce9
DM
216
217 if ($rpcenv->check($authuser, "/vms/$vmid", ['VM.Allocate'], 1)) {
218 # OK
219 } elsif ($pool && $rpcenv->check($authuser, "/pool/$pool", ['VM.Allocate'], 1)) {
220 # OK
221 } elsif ($restore && $force && $same_container_exists &&
222 $rpcenv->check($authuser, "/vms/$vmid", ['VM.Backup'], 1)) {
223 # OK: user has VM.Backup permissions, and want to restore an existing VM
224 } else {
225 raise_perm_exc();
226 }
227
9eb69152 228 my $ostemplate = extract_param($param, 'ostemplate');
bb6afcb0
DM
229 my $storage = extract_param($param, 'storage') // 'local';
230
9eb69152
FG
231 PVE::LXC::check_ct_modify_config_perm($rpcenv, $authuser, $vmid, $pool, $param, []);
232
bb6afcb0 233 my $storage_cfg = cfs_read_file("storage.cfg");
9c2d4ce9 234
5c752bbf 235
9c2d4ce9
DM
236 my $archive;
237
238 if ($ostemplate eq '-') {
148d1cb4
DM
239 die "pipe requires cli environment\n"
240 if $rpcenv->{type} ne 'cli';
241 die "pipe can only be used with restore tasks\n"
242 if !$restore;
243 $archive = '-';
b51a98d4 244 die "restore from pipe requires rootfs parameter\n" if !defined($param->{rootfs});
9c2d4ce9 245 } else {
f26c66e0 246 PVE::Storage::check_volume_access($rpcenv, $authuser, $storage_cfg, $vmid, $ostemplate);
9c2d4ce9
DM
247 $archive = PVE::Storage::abs_filesystem_path($storage_cfg, $ostemplate);
248 }
249
bb6afcb0
DM
250 my $check_and_activate_storage = sub {
251 my ($sid) = @_;
252
253 my $scfg = PVE::Storage::storage_check_node($storage_cfg, $sid, $node);
254
255 raise_param_exc({ storage => "storage '$sid' does not support container directories"})
256 if !$scfg->{content}->{rootdir};
257
258 $rpcenv->check($authuser, "/storage/$sid", ['Datastore.AllocateSpace']);
259
260 PVE::Storage::activate_storage($storage_cfg, $sid);
261 };
262
9c2d4ce9 263 my $conf = {};
5b4657d0 264
b51a98d4 265 my $no_disk_param = {};
db18c1e4
FG
266 my $mp_param = {};
267 my $storage_only_mode = 1;
b51a98d4 268 foreach my $opt (keys %$param) {
78ccc99b
DM
269 my $value = $param->{$opt};
270 if ($opt eq 'rootfs' || $opt =~ m/^mp\d+$/) {
271 # allow to use simple numbers (add default storage in that case)
db18c1e4
FG
272 if ($value =~ m/^\d+(\.\d+)?$/) {
273 $mp_param->{$opt} = "$storage:$value";
274 } else {
275 $mp_param->{$opt} = $value;
276 }
277 $storage_only_mode = 0;
a9dd8015
FG
278 } elsif ($opt =~ m/^unused\d+$/) {
279 warn "ignoring '$opt', cannot create/restore with unused volume\n";
280 delete $param->{$opt};
78ccc99b
DM
281 } else {
282 $no_disk_param->{$opt} = $value;
283 }
b51a98d4 284 }
bb6afcb0 285
235dbdf3 286 die "mount points configured, but 'rootfs' not set - aborting\n"
db18c1e4
FG
287 if !$storage_only_mode && !defined($mp_param->{rootfs});
288
bb6afcb0 289 # check storage access, activate storage
db18c1e4
FG
290 my $delayed_mp_param = {};
291 PVE::LXC::Config->foreach_mountpoint($mp_param, sub {
bb6afcb0
DM
292 my ($ms, $mountpoint) = @_;
293
294 my $volid = $mountpoint->{volume};
295 my $mp = $mountpoint->{mp};
296
e2007ac2
DM
297 if ($mountpoint->{type} ne 'volume') { # bind or device
298 die "Only root can pass arbitrary filesystem paths.\n"
299 if $authuser ne 'root@pam';
300 } else {
301 my ($sid, $volname) = PVE::Storage::parse_volume_id($volid);
302 &$check_and_activate_storage($sid);
303 }
bb6afcb0
DM
304 });
305
306 # check/activate default storage
db18c1e4 307 &$check_and_activate_storage($storage) if !defined($mp_param->{rootfs});
bb6afcb0 308
1b4cf758 309 PVE::LXC::Config->update_pct_config($vmid, $conf, 0, $no_disk_param);
9c2d4ce9 310
425b62cb
WB
311 $conf->{unprivileged} = 1 if $unprivileged;
312
148d1cb4
DM
313 my $check_vmid_usage = sub {
314 if ($force) {
5c45496e 315 die "can't overwrite running container\n"
148d1cb4
DM
316 if PVE::LXC::check_running($vmid);
317 } else {
318 PVE::Cluster::check_vmid_unused($vmid);
319 }
320 };
f507c3a7 321
5b4657d0 322 my $code = sub {
148d1cb4 323 &$check_vmid_usage(); # final check after locking
bccaa371
FG
324 my $old_conf;
325
326 my $config_fn = PVE::LXC::Config->config_file($vmid);
327 if (-f $config_fn) {
328 die "container exists" if !$restore; # just to be sure
329 $old_conf = PVE::LXC::Config->load_config($vmid);
330 } else {
331 eval {
332 # try to create empty config on local node, we have an flock
333 PVE::LXC::Config->write_config($vmid, {});
334 };
335
336 # another node was faster, abort
337 die "Could not reserve ID $vmid, already taken\n" if $@;
338 }
339
148d1cb4 340 PVE::Cluster::check_cfs_quorum();
eb35f9c0 341 my $vollist = [];
27916659
DM
342
343 eval {
db18c1e4 344 if ($storage_only_mode) {
b51a98d4 345 if ($restore) {
db18c1e4
FG
346 (undef, $mp_param) = PVE::LXC::Create::recover_config($archive);
347 die "rootfs configuration could not be recovered, please check and specify manually!\n"
348 if !defined($mp_param->{rootfs});
349 PVE::LXC::Config->foreach_mountpoint($mp_param, sub {
350 my ($ms, $mountpoint) = @_;
351 my $type = $mountpoint->{type};
352 if ($type eq 'volume') {
353 die "unable to detect disk size - please specify $ms (size)\n"
354 if !defined($mountpoint->{size});
355 my $disksize = $mountpoint->{size} / (1024 * 1024 * 1024); # create_disks expects GB as unit size
356 delete $mountpoint->{size};
357 $mountpoint->{volume} = "$storage:$disksize";
358 $mp_param->{$ms} = PVE::LXC::Config->print_ct_mountpoint($mountpoint, $ms eq 'rootfs');
359 } else {
15e4d443 360 my $type = $mountpoint->{type};
7e0e7f38
FG
361 die "restoring rootfs to $type mount is only possible by specifying -rootfs manually!\n"
362 if ($ms eq 'rootfs');
20f9339d
FG
363 die "restoring '$ms' to $type mount is only possible for root\n"
364 if $authuser ne 'root@pam';
7e0e7f38 365
15e4d443
FG
366 if ($mountpoint->{backup}) {
367 warn "WARNING - unsupported configuration!\n";
235dbdf3
FG
368 warn "backup was enabled for $type mount point $ms ('$mountpoint->{mp}')\n";
369 warn "mount point configuration will be restored after archive extraction!\n";
15e4d443
FG
370 warn "contained files will be restored to wrong directory!\n";
371 }
136040f4 372 delete $mp_param->{$ms}; # actually delay bind/dev mps
db18c1e4
FG
373 $delayed_mp_param->{$ms} = PVE::LXC::Config->print_ct_mountpoint($mountpoint, $ms eq 'rootfs');
374 }
375 });
b51a98d4 376 } else {
db18c1e4 377 $mp_param->{rootfs} = "$storage:4"; # defaults to 4GB
b51a98d4
DM
378 }
379 }
380
db18c1e4
FG
381 $vollist = PVE::LXC::create_disks($storage_cfg, $vmid, $mp_param, $conf);
382
bccaa371 383 if (defined($old_conf)) {
51665c2d 384 # destroy old container volumes
bccaa371 385 PVE::LXC::destroy_lxc_container($storage_cfg, $vmid, $old_conf, {});
51665c2d 386 }
51665c2d
FG
387
388 eval {
389 my $rootdir = PVE::LXC::mount_all($vmid, $storage_cfg, $conf, 1);
390 PVE::LXC::Create::restore_archive($archive, $rootdir, $conf, $ignore_unpack_errors);
391
392 if ($restore) {
ba0e2930 393 PVE::LXC::Create::restore_configuration($vmid, $rootdir, $conf, $authuser ne 'root@pam');
51665c2d
FG
394 } else {
395 my $lxc_setup = PVE::LXC::Setup->new($conf, $rootdir); # detect OS
396 PVE::LXC::Config->write_config($vmid, $conf); # safe config (after OS detection)
397 $lxc_setup->post_create_hook($password, $ssh_keys);
398 }
399 };
400 my $err = $@;
401 PVE::LXC::umount_all($vmid, $storage_cfg, $conf, $err ? 1 : 0);
402 PVE::Storage::deactivate_volumes($storage_cfg, PVE::LXC::Config->get_vm_volumes($conf));
403 die $err if $err;
27916659
DM
404 # set some defaults
405 $conf->{hostname} ||= "CT$vmid";
406 $conf->{memory} ||= 512;
407 $conf->{swap} //= 512;
db18c1e4
FG
408 foreach my $mp (keys %$delayed_mp_param) {
409 $conf->{$mp} = $delayed_mp_param->{$mp};
410 }
67afe46e 411 PVE::LXC::Config->write_config($vmid, $conf);
27916659
DM
412 };
413 if (my $err = $@) {
6c871c36 414 PVE::LXC::destroy_disks($storage_cfg, $vollist);
27916659
DM
415 PVE::LXC::destroy_config($vmid);
416 die $err;
6d098bf4 417 }
87273b2b 418 PVE::AccessControl::add_vm_to_pool($vmid, $pool) if $pool;
9c2d4ce9 419 };
5c752bbf 420
67afe46e 421 my $realcmd = sub { PVE::LXC::Config->lock_config($vmid, $code); };
9c2d4ce9 422
148d1cb4
DM
423 &$check_vmid_usage(); # first check before locking
424
425 return $rpcenv->fork_worker($restore ? 'vzrestore' : 'vzcreate',
9c2d4ce9 426 $vmid, $authuser, $realcmd);
5c752bbf 427
9c2d4ce9
DM
428 }});
429
f76a2828
DM
430__PACKAGE__->register_method({
431 name => 'vmdiridx',
5c752bbf 432 path => '{vmid}',
f76a2828
DM
433 method => 'GET',
434 proxyto => 'node',
435 description => "Directory index",
436 permissions => {
437 user => 'all',
438 },
439 parameters => {
440 additionalProperties => 0,
441 properties => {
442 node => get_standard_option('pve-node'),
443 vmid => get_standard_option('pve-vmid'),
444 },
445 },
446 returns => {
447 type => 'array',
448 items => {
449 type => "object",
450 properties => {
451 subdir => { type => 'string' },
452 },
453 },
454 links => [ { rel => 'child', href => "{subdir}" } ],
455 },
456 code => sub {
457 my ($param) = @_;
458
459 # test if VM exists
67afe46e 460 my $conf = PVE::LXC::Config->load_config($param->{vmid});
f76a2828
DM
461
462 my $res = [
463 { subdir => 'config' },
fff3a342
DM
464 { subdir => 'status' },
465 { subdir => 'vncproxy' },
a0226a00 466 { subdir => 'termproxy' },
fff3a342
DM
467 { subdir => 'vncwebsocket' },
468 { subdir => 'spiceproxy' },
469 { subdir => 'migrate' },
c4a33727 470 { subdir => 'clone' },
f76a2828
DM
471# { subdir => 'initlog' },
472 { subdir => 'rrd' },
473 { subdir => 'rrddata' },
474 { subdir => 'firewall' },
cc5392c8 475 { subdir => 'snapshot' },
985b18ed 476 { subdir => 'resize' },
f76a2828 477 ];
5c752bbf 478
f76a2828
DM
479 return $res;
480 }});
481
c4a33727 482
f76a2828 483__PACKAGE__->register_method({
5c752bbf
DM
484 name => 'rrd',
485 path => '{vmid}/rrd',
f76a2828
DM
486 method => 'GET',
487 protected => 1, # fixme: can we avoid that?
488 permissions => {
489 check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
490 },
491 description => "Read VM RRD statistics (returns PNG)",
492 parameters => {
493 additionalProperties => 0,
494 properties => {
495 node => get_standard_option('pve-node'),
496 vmid => get_standard_option('pve-vmid'),
497 timeframe => {
498 description => "Specify the time frame you are interested in.",
499 type => 'string',
500 enum => [ 'hour', 'day', 'week', 'month', 'year' ],
501 },
502 ds => {
503 description => "The list of datasources you want to display.",
504 type => 'string', format => 'pve-configid-list',
505 },
506 cf => {
507 description => "The RRD consolidation function",
508 type => 'string',
509 enum => [ 'AVERAGE', 'MAX' ],
510 optional => 1,
511 },
512 },
513 },
514 returns => {
515 type => "object",
516 properties => {
517 filename => { type => 'string' },
518 },
519 },
520 code => sub {
521 my ($param) = @_;
522
523 return PVE::Cluster::create_rrd_graph(
5c752bbf 524 "pve2-vm/$param->{vmid}", $param->{timeframe},
f76a2828 525 $param->{ds}, $param->{cf});
5c752bbf 526
f76a2828
DM
527 }});
528
529__PACKAGE__->register_method({
5c752bbf
DM
530 name => 'rrddata',
531 path => '{vmid}/rrddata',
f76a2828
DM
532 method => 'GET',
533 protected => 1, # fixme: can we avoid that?
534 permissions => {
535 check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
536 },
537 description => "Read VM RRD statistics",
538 parameters => {
539 additionalProperties => 0,
540 properties => {
541 node => get_standard_option('pve-node'),
542 vmid => get_standard_option('pve-vmid'),
543 timeframe => {
544 description => "Specify the time frame you are interested in.",
545 type => 'string',
546 enum => [ 'hour', 'day', 'week', 'month', 'year' ],
547 },
548 cf => {
549 description => "The RRD consolidation function",
550 type => 'string',
551 enum => [ 'AVERAGE', 'MAX' ],
552 optional => 1,
553 },
554 },
555 },
556 returns => {
557 type => "array",
558 items => {
559 type => "object",
560 properties => {},
561 },
562 },
563 code => sub {
564 my ($param) = @_;
565
566 return PVE::Cluster::create_rrd_data(
567 "pve2-vm/$param->{vmid}", $param->{timeframe}, $param->{cf});
568 }});
569
f76a2828 570__PACKAGE__->register_method({
5c752bbf
DM
571 name => 'destroy_vm',
572 path => '{vmid}',
f76a2828
DM
573 method => 'DELETE',
574 protected => 1,
575 proxyto => 'node',
576 description => "Destroy the container (also delete all uses files).",
577 permissions => {
578 check => [ 'perm', '/vms/{vmid}', ['VM.Allocate']],
579 },
580 parameters => {
581 additionalProperties => 0,
582 properties => {
583 node => get_standard_option('pve-node'),
68e8f3c5 584 vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid_stopped }),
f76a2828
DM
585 },
586 },
5c752bbf 587 returns => {
f76a2828
DM
588 type => 'string',
589 },
590 code => sub {
591 my ($param) = @_;
592
593 my $rpcenv = PVE::RPCEnvironment::get();
594
595 my $authuser = $rpcenv->get_user();
596
597 my $vmid = $param->{vmid};
598
599 # test if container exists
67afe46e 600 my $conf = PVE::LXC::Config->load_config($vmid);
f76a2828 601
611fe3aa
DM
602 my $storage_cfg = cfs_read_file("storage.cfg");
603
67afe46e 604 PVE::LXC::Config->check_protection($conf, "can't remove CT $vmid");
7e806596 605
9d87e069 606 die "unable to remove CT $vmid - used in HA resources\n"
b6e0b774
AG
607 if PVE::HA::Config::vm_is_ha_managed($vmid);
608
c5a8e04f
DM
609 # do not allow destroy if there are replication jobs
610 my $repl_conf = PVE::ReplicationConfig->new();
611 $repl_conf->check_for_existing_jobs($vmid);
612
d607c17d
DM
613 my $running_error_msg = "unable to destroy CT $vmid - container is running\n";
614
615 die $running_error_msg if PVE::LXC::check_running($vmid); # check early
616
611fe3aa 617 my $code = sub {
673cf209 618 # reload config after lock
67afe46e
FG
619 $conf = PVE::LXC::Config->load_config($vmid);
620 PVE::LXC::Config->check_lock($conf);
673cf209 621
d607c17d
DM
622 die $running_error_msg if PVE::LXC::check_running($vmid);
623
27916659 624 PVE::LXC::destroy_lxc_container($storage_cfg, $vmid, $conf);
be5fc936 625 PVE::AccessControl::remove_vm_access($vmid);
2f9b5ead 626 PVE::Firewall::remove_vmfw_conf($vmid);
f76a2828
DM
627 };
628
67afe46e 629 my $realcmd = sub { PVE::LXC::Config->lock_config($vmid, $code); };
611fe3aa 630
f76a2828
DM
631 return $rpcenv->fork_worker('vzdestroy', $vmid, $authuser, $realcmd);
632 }});
633
fff3a342
DM
634my $sslcert;
635
636__PACKAGE__->register_method ({
5b4657d0
DM
637 name => 'vncproxy',
638 path => '{vmid}/vncproxy',
fff3a342
DM
639 method => 'POST',
640 protected => 1,
641 permissions => {
642 check => ['perm', '/vms/{vmid}', [ 'VM.Console' ]],
643 },
644 description => "Creates a TCP VNC proxy connections.",
645 parameters => {
646 additionalProperties => 0,
647 properties => {
648 node => get_standard_option('pve-node'),
649 vmid => get_standard_option('pve-vmid'),
650 websocket => {
651 optional => 1,
652 type => 'boolean',
653 description => "use websocket instead of standard VNC.",
654 },
bd0f4d6d
DC
655 width => {
656 optional => 1,
657 description => "sets the width of the console in pixels.",
658 type => 'integer',
659 minimum => 16,
660 maximum => 4096,
661 },
662 height => {
663 optional => 1,
664 description => "sets the height of the console in pixels.",
665 type => 'integer',
666 minimum => 16,
667 maximum => 2160,
668 },
fff3a342
DM
669 },
670 },
5b4657d0 671 returns => {
fff3a342
DM
672 additionalProperties => 0,
673 properties => {
674 user => { type => 'string' },
675 ticket => { type => 'string' },
676 cert => { type => 'string' },
677 port => { type => 'integer' },
678 upid => { type => 'string' },
679 },
680 },
681 code => sub {
682 my ($param) = @_;
683
684 my $rpcenv = PVE::RPCEnvironment::get();
685
686 my $authuser = $rpcenv->get_user();
687
688 my $vmid = $param->{vmid};
689 my $node = $param->{node};
690
691 my $authpath = "/vms/$vmid";
692
693 my $ticket = PVE::AccessControl::assemble_vnc_ticket($authuser, $authpath);
694
695 $sslcert = PVE::Tools::file_get_contents("/etc/pve/pve-root-ca.pem", 8192)
696 if !$sslcert;
697
ec2c57eb 698 my ($remip, $family);
5b4657d0 699
fff3a342 700 if ($node ne PVE::INotify::nodename()) {
85ae6211 701 ($remip, $family) = PVE::Cluster::remote_node_ip($node);
ec2c57eb
WB
702 } else {
703 $family = PVE::Tools::get_host_address_family($node);
fff3a342
DM
704 }
705
ec2c57eb
WB
706 my $port = PVE::Tools::next_vnc_port($family);
707
fff3a342
DM
708 # NOTE: vncterm VNC traffic is already TLS encrypted,
709 # so we select the fastest chipher here (or 'none'?)
5b4657d0 710 my $remcmd = $remip ?
806eae70 711 ['/usr/bin/ssh', '-e', 'none', '-t', $remip] : [];
fff3a342 712
67afe46e 713 my $conf = PVE::LXC::Config->load_config($vmid, $node);
4d494664 714 my $concmd = PVE::LXC::get_console_command($vmid, $conf, 1);
aca816ad 715
5b4657d0
DM
716 my $shcmd = [ '/usr/bin/dtach', '-A',
717 "/var/run/dtach/vzctlconsole$vmid",
aca816ad 718 '-r', 'winch', '-z', @$concmd];
fff3a342
DM
719
720 my $realcmd = sub {
721 my $upid = shift;
722
5b4657d0 723 syslog ('info', "starting lxc vnc proxy $upid\n");
fff3a342 724
5b4657d0 725 my $timeout = 10;
fff3a342
DM
726
727 my $cmd = ['/usr/bin/vncterm', '-rfbport', $port,
5b4657d0 728 '-timeout', $timeout, '-authpath', $authpath,
fff3a342
DM
729 '-perm', 'VM.Console'];
730
bd0f4d6d
DC
731 if ($param->{width}) {
732 push @$cmd, '-width', $param->{width};
733 }
734
735 if ($param->{height}) {
736 push @$cmd, '-height', $param->{height};
737 }
738
fff3a342 739 if ($param->{websocket}) {
5b4657d0 740 $ENV{PVE_VNC_TICKET} = $ticket; # pass ticket to vncterm
fff3a342
DM
741 push @$cmd, '-notls', '-listen', 'localhost';
742 }
743
744 push @$cmd, '-c', @$remcmd, @$shcmd;
745
37634d3d 746 run_command($cmd, keeplocale => 1);
fff3a342
DM
747
748 return;
749 };
750
751 my $upid = $rpcenv->fork_worker('vncproxy', $vmid, $authuser, $realcmd);
752
753 PVE::Tools::wait_for_vnc_port($port);
754
755 return {
756 user => $authuser,
757 ticket => $ticket,
5b4657d0
DM
758 port => $port,
759 upid => $upid,
760 cert => $sslcert,
fff3a342
DM
761 };
762 }});
763
a0226a00
DC
764__PACKAGE__->register_method ({
765 name => 'termproxy',
766 path => '{vmid}/termproxy',
767 method => 'POST',
768 protected => 1,
769 permissions => {
770 check => ['perm', '/vms/{vmid}', [ 'VM.Console' ]],
771 },
772 description => "Creates a TCP proxy connection.",
773 parameters => {
774 additionalProperties => 0,
775 properties => {
776 node => get_standard_option('pve-node'),
777 vmid => get_standard_option('pve-vmid'),
778 },
779 },
780 returns => {
781 additionalProperties => 0,
782 properties => {
783 user => { type => 'string' },
784 ticket => { type => 'string' },
785 port => { type => 'integer' },
786 upid => { type => 'string' },
787 },
788 },
789 code => sub {
790 my ($param) = @_;
791
792 my $rpcenv = PVE::RPCEnvironment::get();
793
794 my $authuser = $rpcenv->get_user();
795
796 my $vmid = $param->{vmid};
797 my $node = $param->{node};
798
799 my $authpath = "/vms/$vmid";
800
801 my $ticket = PVE::AccessControl::assemble_vnc_ticket($authuser, $authpath);
802
803 my ($remip, $family);
804
805 if ($node ne 'localhost' && $node ne PVE::INotify::nodename()) {
806 ($remip, $family) = PVE::Cluster::remote_node_ip($node);
807 } else {
808 $family = PVE::Tools::get_host_address_family($node);
809 }
810
811 my $port = PVE::Tools::next_vnc_port($family);
812
813 my $remcmd = $remip ?
814 ['/usr/bin/ssh', '-e', 'none', '-t', $remip, '--'] : [];
815
816 my $conf = PVE::LXC::Config->load_config($vmid, $node);
817 my $concmd = PVE::LXC::get_console_command($vmid, $conf, 1);
818
819 my $shcmd = [ '/usr/bin/dtach', '-A',
820 "/var/run/dtach/vzctlconsole$vmid",
821 '-r', 'winch', '-z', @$concmd];
822
823 my $realcmd = sub {
824 my $upid = shift;
825
826 syslog ('info', "starting lxc termproxy $upid\n");
827
828 my $cmd = ['/usr/bin/termproxy', $port, '--path', $authpath,
829 '--perm', 'VM.Console', '--'];
830 push @$cmd, @$remcmd, @$shcmd;
831
832 PVE::Tools::run_command($cmd);
833 };
834
835 my $upid = $rpcenv->fork_worker('vncproxy', $vmid, $authuser, $realcmd, 1);
836
837 PVE::Tools::wait_for_vnc_port($port);
838
839 return {
840 user => $authuser,
841 ticket => $ticket,
842 port => $port,
843 upid => $upid,
844 };
845 }});
846
fff3a342
DM
847__PACKAGE__->register_method({
848 name => 'vncwebsocket',
849 path => '{vmid}/vncwebsocket',
850 method => 'GET',
5b4657d0 851 permissions => {
fff3a342
DM
852 description => "You also need to pass a valid ticket (vncticket).",
853 check => ['perm', '/vms/{vmid}', [ 'VM.Console' ]],
854 },
855 description => "Opens a weksocket for VNC traffic.",
856 parameters => {
857 additionalProperties => 0,
858 properties => {
859 node => get_standard_option('pve-node'),
860 vmid => get_standard_option('pve-vmid'),
861 vncticket => {
862 description => "Ticket from previous call to vncproxy.",
863 type => 'string',
864 maxLength => 512,
865 },
866 port => {
867 description => "Port number returned by previous vncproxy call.",
868 type => 'integer',
869 minimum => 5900,
870 maximum => 5999,
871 },
872 },
873 },
874 returns => {
875 type => "object",
876 properties => {
877 port => { type => 'string' },
878 },
879 },
880 code => sub {
881 my ($param) = @_;
882
883 my $rpcenv = PVE::RPCEnvironment::get();
884
885 my $authuser = $rpcenv->get_user();
886
887 my $authpath = "/vms/$param->{vmid}";
888
889 PVE::AccessControl::verify_vnc_ticket($param->{vncticket}, $authuser, $authpath);
890
891 my $port = $param->{port};
5b4657d0 892
fff3a342
DM
893 return { port => $port };
894 }});
895
896__PACKAGE__->register_method ({
5b4657d0
DM
897 name => 'spiceproxy',
898 path => '{vmid}/spiceproxy',
fff3a342
DM
899 method => 'POST',
900 protected => 1,
901 proxyto => 'node',
902 permissions => {
903 check => ['perm', '/vms/{vmid}', [ 'VM.Console' ]],
904 },
905 description => "Returns a SPICE configuration to connect to the CT.",
906 parameters => {
907 additionalProperties => 0,
908 properties => {
909 node => get_standard_option('pve-node'),
910 vmid => get_standard_option('pve-vmid'),
911 proxy => get_standard_option('spice-proxy', { optional => 1 }),
912 },
913 },
914 returns => get_standard_option('remote-viewer-config'),
915 code => sub {
916 my ($param) = @_;
917
918 my $vmid = $param->{vmid};
919 my $node = $param->{node};
920 my $proxy = $param->{proxy};
921
922 my $authpath = "/vms/$vmid";
923 my $permissions = 'VM.Console';
924
67afe46e 925 my $conf = PVE::LXC::Config->load_config($vmid);
da4db334
TL
926
927 die "CT $vmid not running\n" if !PVE::LXC::check_running($vmid);
928
aca816ad
DM
929 my $concmd = PVE::LXC::get_console_command($vmid, $conf);
930
5b4657d0
DM
931 my $shcmd = ['/usr/bin/dtach', '-A',
932 "/var/run/dtach/vzctlconsole$vmid",
aca816ad 933 '-r', 'winch', '-z', @$concmd];
fff3a342
DM
934
935 my $title = "CT $vmid";
936
937 return PVE::API2Tools::run_spiceterm($authpath, $permissions, $vmid, $node, $proxy, $title, $shcmd);
938 }});
5c752bbf 939
5c752bbf
DM
940
941__PACKAGE__->register_method({
52389a07
DM
942 name => 'migrate_vm',
943 path => '{vmid}/migrate',
5c752bbf
DM
944 method => 'POST',
945 protected => 1,
946 proxyto => 'node',
52389a07 947 description => "Migrate the container to another node. Creates a new migration task.",
5c752bbf 948 permissions => {
52389a07 949 check => ['perm', '/vms/{vmid}', [ 'VM.Migrate' ]],
5c752bbf
DM
950 },
951 parameters => {
952 additionalProperties => 0,
953 properties => {
954 node => get_standard_option('pve-node'),
68e8f3c5
DM
955 vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid }),
956 target => get_standard_option('pve-node', {
957 description => "Target node.",
39bb88df 958 completion => \&PVE::Cluster::complete_migration_target,
68e8f3c5 959 }),
52389a07
DM
960 online => {
961 type => 'boolean',
962 description => "Use online/live migration.",
963 optional => 1,
964 },
00d8cdc0
DC
965 restart => {
966 type => 'boolean',
967 description => "Use restart migration",
968 optional => 1,
969 },
970 timeout => {
971 type => 'integer',
972 description => "Timeout in seconds for shutdown for restart migration",
973 optional => 1,
974 default => 180,
975 },
9746c095
FG
976 force => {
977 type => 'boolean',
978 description => "Force migration despite local bind / device" .
552e168f 979 " mounts. NOTE: deprecated, use 'shared' property of mount point instead.",
9746c095
FG
980 optional => 1,
981 },
5c752bbf
DM
982 },
983 },
984 returns => {
985 type => 'string',
52389a07 986 description => "the task ID.",
5c752bbf
DM
987 },
988 code => sub {
989 my ($param) = @_;
990
991 my $rpcenv = PVE::RPCEnvironment::get();
992
993 my $authuser = $rpcenv->get_user();
994
52389a07 995 my $target = extract_param($param, 'target');
bb1ac2de 996
52389a07
DM
997 my $localnode = PVE::INotify::nodename();
998 raise_param_exc({ target => "target is local node."}) if $target eq $localnode;
bb1ac2de 999
52389a07 1000 PVE::Cluster::check_cfs_quorum();
5c752bbf 1001
52389a07 1002 PVE::Cluster::check_node_exists($target);
27916659 1003
52389a07 1004 my $targetip = PVE::Cluster::remote_node_ip($target);
5c752bbf 1005
52389a07 1006 my $vmid = extract_param($param, 'vmid');
5c752bbf 1007
52389a07 1008 # test if VM exists
67afe46e 1009 PVE::LXC::Config->load_config($vmid);
5c752bbf 1010
52389a07
DM
1011 # try to detect errors early
1012 if (PVE::LXC::check_running($vmid)) {
00d8cdc0
DC
1013 die "can't migrate running container without --online or --restart\n"
1014 if !$param->{online} && !$param->{restart};
5c752bbf 1015 }
5c752bbf
DM
1016
1017 if (PVE::HA::Config::vm_is_ha_managed($vmid) && $rpcenv->{type} ne 'ha') {
1018
1019 my $hacmd = sub {
1020 my $upid = shift;
1021
1022 my $service = "ct:$vmid";
1023
52389a07 1024 my $cmd = ['ha-manager', 'migrate', $service, $target];
5c752bbf 1025
545dd4e1 1026 print "Requesting HA migration for CT $vmid to node $target\n";
5c752bbf
DM
1027
1028 PVE::Tools::run_command($cmd);
1029
1030 return;
1031 };
1032
52389a07 1033 return $rpcenv->fork_worker('hamigrate', $vmid, $authuser, $hacmd);
5c752bbf
DM
1034
1035 } else {
1036
22557519
DM
1037 my $realcmd = sub {
1038 PVE::LXC::Migrate->migrate($target, $targetip, $vmid, $param);
1039 };
56462053 1040
22557519
DM
1041 my $worker = sub {
1042 return PVE::GuestHelpers::guest_migration_lock($vmid, 10, $realcmd);
5c752bbf
DM
1043 };
1044
22557519 1045 return $rpcenv->fork_worker('vzmigrate', $vmid, $authuser, $worker);
5c752bbf
DM
1046 }
1047 }});
1048
cc5392c8
WL
1049__PACKAGE__->register_method({
1050 name => 'vm_feature',
1051 path => '{vmid}/feature',
1052 method => 'GET',
1053 proxyto => 'node',
1054 protected => 1,
1055 description => "Check if feature for virtual machine is available.",
1056 permissions => {
1057 check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
1058 },
1059 parameters => {
1060 additionalProperties => 0,
1061 properties => {
1062 node => get_standard_option('pve-node'),
1063 vmid => get_standard_option('pve-vmid'),
1064 feature => {
1065 description => "Feature to check.",
1066 type => 'string',
1067 enum => [ 'snapshot' ],
1068 },
1069 snapname => get_standard_option('pve-lxc-snapshot-name', {
1070 optional => 1,
1071 }),
1072 },
1073 },
1074 returns => {
1075 type => "object",
1076 properties => {
1077 hasFeature => { type => 'boolean' },
1078 #nodes => {
1079 #type => 'array',
1080 #items => { type => 'string' },
1081 #}
1082 },
1083 },
1084 code => sub {
1085 my ($param) = @_;
1086
1087 my $node = extract_param($param, 'node');
1088
1089 my $vmid = extract_param($param, 'vmid');
1090
1091 my $snapname = extract_param($param, 'snapname');
1092
1093 my $feature = extract_param($param, 'feature');
1094
67afe46e 1095 my $conf = PVE::LXC::Config->load_config($vmid);
cc5392c8
WL
1096
1097 if($snapname){
1098 my $snap = $conf->{snapshots}->{$snapname};
1099 die "snapshot '$snapname' does not exist\n" if !defined($snap);
1100 $conf = $snap;
1101 }
ef241384 1102 my $storage_cfg = PVE::Storage::config();
cc5392c8 1103 #Maybe include later
ef241384 1104 #my $nodelist = PVE::LXC::shared_nodes($conf, $storage_cfg);
4518000b 1105 my $hasFeature = PVE::LXC::Config->has_feature($feature, $conf, $storage_cfg, $snapname);
cc5392c8
WL
1106
1107 return {
1108 hasFeature => $hasFeature,
1109 #nodes => [ keys %$nodelist ],
1110 };
1111 }});
bb1ac2de
DM
1112
1113__PACKAGE__->register_method({
1114 name => 'template',
1115 path => '{vmid}/template',
1116 method => 'POST',
1117 protected => 1,
1118 proxyto => 'node',
1119 description => "Create a Template.",
1120 permissions => {
1121 description => "You need 'VM.Allocate' permissions on /vms/{vmid}",
1122 check => [ 'perm', '/vms/{vmid}', ['VM.Allocate']],
1123 },
1124 parameters => {
1125 additionalProperties => 0,
1126 properties => {
1127 node => get_standard_option('pve-node'),
68e8f3c5 1128 vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid_stopped }),
6e0d6b54
FG
1129 experimental => {
1130 type => 'boolean',
1131 description => "The template feature is experimental, set this " .
1132 "flag if you know what you are doing.",
1133 default => 0,
1134 },
bb1ac2de
DM
1135 },
1136 },
1137 returns => { type => 'null'},
1138 code => sub {
1139 my ($param) = @_;
1140
1141 my $rpcenv = PVE::RPCEnvironment::get();
1142
1143 my $authuser = $rpcenv->get_user();
1144
1145 my $node = extract_param($param, 'node');
1146
1147 my $vmid = extract_param($param, 'vmid');
1148
1149 my $updatefn = sub {
1150
67afe46e
FG
1151 my $conf = PVE::LXC::Config->load_config($vmid);
1152 PVE::LXC::Config->check_lock($conf);
bb1ac2de
DM
1153
1154 die "unable to create template, because CT contains snapshots\n"
1155 if $conf->{snapshots} && scalar(keys %{$conf->{snapshots}});
1156
1157 die "you can't convert a template to a template\n"
67afe46e 1158 if PVE::LXC::Config->is_template($conf);
bb1ac2de
DM
1159
1160 die "you can't convert a CT to template if the CT is running\n"
1161 if PVE::LXC::check_running($vmid);
1162
1163 my $realcmd = sub {
1164 PVE::LXC::template_create($vmid, $conf);
1165 };
1166
1167 $conf->{template} = 1;
1168
67afe46e 1169 PVE::LXC::Config->write_config($vmid, $conf);
bb1ac2de 1170 # and remove lxc config
f91f3669 1171 PVE::LXC::update_lxc_config($vmid, $conf);
bb1ac2de
DM
1172
1173 return $rpcenv->fork_worker('vztemplate', $vmid, $authuser, $realcmd);
1174 };
1175
67afe46e 1176 PVE::LXC::Config->lock_config($vmid, $updatefn);
bb1ac2de
DM
1177
1178 return undef;
1179 }});
1180
c4a33727
DM
1181__PACKAGE__->register_method({
1182 name => 'clone_vm',
1183 path => '{vmid}/clone',
1184 method => 'POST',
1185 protected => 1,
1186 proxyto => 'node',
1187 description => "Create a container clone/copy",
1188 permissions => {
1189 description => "You need 'VM.Clone' permissions on /vms/{vmid}, " .
1190 "and 'VM.Allocate' permissions " .
1191 "on /vms/{newid} (or on the VM pool /pool/{pool}). You also need " .
1192 "'Datastore.AllocateSpace' on any used storage.",
1193 check =>
1194 [ 'and',
1195 ['perm', '/vms/{vmid}', [ 'VM.Clone' ]],
1196 [ 'or',
1197 [ 'perm', '/vms/{newid}', ['VM.Allocate']],
1198 [ 'perm', '/pool/{pool}', ['VM.Allocate'], require_param => 'pool'],
1199 ],
1200 ]
1201 },
1202 parameters => {
1203 additionalProperties => 0,
1204 properties => {
1205 node => get_standard_option('pve-node'),
1206 vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid }),
1207 newid => get_standard_option('pve-vmid', {
1208 completion => \&PVE::Cluster::complete_next_vmid,
1209 description => 'VMID for the clone.' }),
1210 hostname => {
1211 optional => 1,
1212 type => 'string', format => 'dns-name',
1213 description => "Set a hostname for the new CT.",
1214 },
1215 description => {
1216 optional => 1,
1217 type => 'string',
1218 description => "Description for the new CT.",
1219 },
1220 pool => {
1221 optional => 1,
1222 type => 'string', format => 'pve-poolid',
1223 description => "Add the new CT to the specified pool.",
1224 },
1225 snapname => get_standard_option('pve-lxc-snapshot-name', {
1226 optional => 1,
1227 }),
1228 storage => get_standard_option('pve-storage-id', {
1229 description => "Target storage for full clone.",
1230 requires => 'full',
1231 optional => 1,
1232 }),
1233 full => {
1234 optional => 1,
1235 type => 'boolean',
1236 description => "Create a full copy of all disk. This is always done when " .
1237 "you clone a normal CT. For CT templates, we try to create a linked clone by default.",
1238 default => 0,
1239 },
6e0d6b54
FG
1240 experimental => {
1241 type => 'boolean',
1242 description => "The clone feature is experimental, set this " .
1243 "flag if you know what you are doing.",
1244 default => 0,
1245 },
c4a33727
DM
1246# target => get_standard_option('pve-node', {
1247# description => "Target node. Only allowed if the original VM is on shared storage.",
1248# optional => 1,
1249# }),
1250 },
1251 },
1252 returns => {
1253 type => 'string',
1254 },
1255 code => sub {
1256 my ($param) = @_;
1257
1258 my $rpcenv = PVE::RPCEnvironment::get();
1259
1260 my $authuser = $rpcenv->get_user();
1261
1262 my $node = extract_param($param, 'node');
1263
1264 my $vmid = extract_param($param, 'vmid');
1265
1266 my $newid = extract_param($param, 'newid');
1267
1268 my $pool = extract_param($param, 'pool');
1269
1270 if (defined($pool)) {
1271 $rpcenv->check_pool_exist($pool);
1272 }
1273
1274 my $snapname = extract_param($param, 'snapname');
1275
1276 my $storage = extract_param($param, 'storage');
1277
db01d674
WB
1278 die "Full clone requires a target storage.\n"
1279 if $param->{full} && !$storage;
1280
c4a33727
DM
1281 my $localnode = PVE::INotify::nodename();
1282
1283 my $storecfg = PVE::Storage::config();
1284
1285 if ($storage) {
1286 # check if storage is enabled on local node
1287 PVE::Storage::storage_check_enabled($storecfg, $storage);
1288 }
1289
1290 PVE::Cluster::check_cfs_quorum();
1291
db01d674
WB
1292 my $conffile;
1293 my $newconf = {};
1294 my $mountpoints = {};
1295 my $fullclone = {};
1296 my $vollist = [];
c4a33727 1297
db01d674
WB
1298 PVE::LXC::Config->lock_config($vmid, sub {
1299 my $src_conf = PVE::LXC::Config->set_lock($vmid, 'disk');
1300 eval {
1301 die "snapshot '$snapname' does not exist\n"
1302 if $snapname && !defined($src_conf->{snapshots}->{$snapname});
c4a33727 1303
db01d674 1304 my $running = PVE::LXC::check_running($vmid) || 0;
c4a33727 1305
db01d674 1306 my $src_conf = $snapname ? $src_conf->{snapshots}->{$snapname} : $src_conf;
c4a33727 1307
db01d674
WB
1308 $conffile = PVE::LXC::Config->config_file($newid);
1309 die "unable to create CT $newid: config file already exists\n"
1310 if -f $conffile;
c4a33727 1311
db01d674
WB
1312 foreach my $opt (keys %$src_conf) {
1313 next if $opt =~ m/^unused\d+$/;
c4a33727 1314
db01d674 1315 my $value = $src_conf->{$opt};
c4a33727 1316
db01d674
WB
1317 if (($opt eq 'rootfs') || ($opt =~ m/^mp\d+$/)) {
1318 my $mp = $opt eq 'rootfs' ?
1319 PVE::LXC::Config->parse_ct_rootfs($value) :
1320 PVE::LXC::Config->parse_ct_mountpoint($value);
c4a33727 1321
db01d674
WB
1322 if ($mp->{type} eq 'volume') {
1323 my $volid = $mp->{volume};
1324 if ($param->{full}) {
1325 die "Cannot do full clones on a running container without snapshots\n"
1326 if $running && !defined($snapname);
1327 $fullclone->{$opt} = 1;
1328 } else {
1329 # not full means clone instead of copy
1330 die "Linked clone feature for '$volid' is not available\n"
1331 if !PVE::Storage::volume_has_feature($storecfg, 'clone', $volid, $snapname, $running);
1332 }
c4a33727 1333
db01d674
WB
1334 $mountpoints->{$opt} = $mp;
1335 push @$vollist, $volid;
c4a33727 1336
c4a33727 1337 } else {
db01d674
WB
1338 # TODO: allow bind mounts?
1339 die "unable to clone mountpint '$opt' (type $mp->{type})\n";
c4a33727 1340 }
c4a33727 1341 } else {
db01d674
WB
1342 # copy everything else
1343 $newconf->{$opt} = $value;
c4a33727 1344 }
db01d674 1345 }
c4a33727 1346
db01d674
WB
1347 # Replace the 'disk' lock with a 'create' lock.
1348 $newconf->{lock} = 'create';
1349
1350 delete $newconf->{template};
1351 if ($param->{hostname}) {
1352 $newconf->{hostname} = $param->{hostname};
c4a33727 1353 }
c4a33727 1354
db01d674
WB
1355 if ($param->{description}) {
1356 $newconf->{description} = $param->{description};
1357 }
c4a33727 1358
db01d674
WB
1359 # create empty/temp config - this fails if CT already exists on other node
1360 PVE::LXC::Config->write_config($newid, $newconf);
1361 };
1362 if (my $err = $@) {
1363 eval { PVE::LXC::Config->remove_lock($vmid, 'disk') };
1364 warn $@ if $@;
1365 die $err;
c4a33727 1366 }
db01d674 1367 });
c4a33727 1368
db01d674
WB
1369 my $update_conf = sub {
1370 my ($key, $value) = @_;
1371 return PVE::LXC::Config->lock_config($newid, sub {
1372 my $conf = PVE::LXC::Config->load_config($newid);
1373 die "Lost 'create' config lock, aborting.\n"
1374 if !PVE::LXC::Config->has_lock($conf, 'create');
1375 $conf->{$key} = $value;
1376 PVE::LXC::Config->write_config($newid, $conf);
1377 });
1378 };
c4a33727 1379
db01d674
WB
1380 my $realcmd = sub {
1381 my ($upid) = @_;
c4a33727 1382
db01d674 1383 my $newvollist = [];
c4a33727 1384
db01d674
WB
1385 eval {
1386 local $SIG{INT} =
1387 local $SIG{TERM} =
1388 local $SIG{QUIT} =
1389 local $SIG{HUP} = sub { die "interrupted by signal\n"; };
c4a33727 1390
db01d674 1391 PVE::Storage::activate_volumes($storecfg, $vollist, $snapname);
c4a33727 1392
db01d674
WB
1393 foreach my $opt (keys %$mountpoints) {
1394 my $mp = $mountpoints->{$opt};
1395 my $volid = $mp->{volume};
c4a33727 1396
db01d674
WB
1397 my $newvolid;
1398 if ($fullclone->{$opt}) {
1399 print "create full clone of mountpoint $opt ($volid)\n";
1400 $newvolid = PVE::LXC::copy_volume($mp, $newid, $storage, $storecfg, $newconf, $snapname);
1401 } else {
1402 print "create linked clone of mount point $opt ($volid)\n";
1403 $newvolid = PVE::Storage::vdisk_clone($storecfg, $volid, $newid, $snapname);
c4a33727
DM
1404 }
1405
db01d674
WB
1406 push @$newvollist, $newvolid;
1407 $mp->{volume} = $newvolid;
c4a33727 1408
db01d674 1409 $update_conf->($opt, PVE::LXC::Config->print_ct_mountpoint($mp, $opt eq 'rootfs'));
c4a33727
DM
1410 }
1411
db01d674
WB
1412 PVE::AccessControl::add_vm_to_pool($newid, $pool) if $pool;
1413 PVE::LXC::Config->remove_lock($newid, 'create');
c4a33727 1414 };
db01d674 1415 my $err = $@;
c4a33727 1416
db01d674
WB
1417 # Unlock the source config in any case:
1418 eval { PVE::LXC::Config->remove_lock($vmid, 'disk') };
1419 warn $@ if $@;
c4a33727 1420
db01d674
WB
1421 if ($err) {
1422 # Now cleanup the config & disks:
1423 unlink $conffile;
c4a33727 1424
db01d674
WB
1425 sleep 1; # some storages like rbd need to wait before release volume - really?
1426
1427 foreach my $volid (@$newvollist) {
1428 eval { PVE::Storage::vdisk_free($storecfg, $volid); };
1429 warn $@ if $@;
1430 }
1431 die "clone failed: $err";
1432 }
1433
1434 return;
c4a33727
DM
1435 };
1436
db01d674
WB
1437 PVE::Firewall::clone_vmfw_conf($vmid, $newid);
1438 return $rpcenv->fork_worker('vzclone', $vmid, $authuser, $realcmd);
c4a33727
DM
1439 }});
1440
1441
985b18ed
WL
1442__PACKAGE__->register_method({
1443 name => 'resize_vm',
1444 path => '{vmid}/resize',
1445 method => 'PUT',
1446 protected => 1,
1447 proxyto => 'node',
235dbdf3 1448 description => "Resize a container mount point.",
985b18ed
WL
1449 permissions => {
1450 check => ['perm', '/vms/{vmid}', ['VM.Config.Disk'], any => 1],
1451 },
1452 parameters => {
1453 additionalProperties => 0,
b8c5a95f
WB
1454 properties => {
1455 node => get_standard_option('pve-node'),
1456 vmid => get_standard_option('pve-vmid', { completion => \&PVE::LXC::complete_ctid }),
1457 disk => {
1458 type => 'string',
1459 description => "The disk you want to resize.",
d250604f 1460 enum => [PVE::LXC::Config->mountpoint_names()],
b8c5a95f
WB
1461 },
1462 size => {
1463 type => 'string',
1464 pattern => '\+?\d+(\.\d+)?[KMGT]?',
1465 description => "The new size. With the '+' sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported.",
1466 },
1467 digest => {
1468 type => 'string',
1469 description => 'Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.',
1470 maxLength => 40,
1471 optional => 1,
1472 }
1473 },
985b18ed 1474 },
9f3f7963
WL
1475 returns => {
1476 type => 'string',
1477 description => "the task ID.",
1478 },
985b18ed
WL
1479 code => sub {
1480 my ($param) = @_;
1481
1482 my $rpcenv = PVE::RPCEnvironment::get();
1483
1484 my $authuser = $rpcenv->get_user();
1485
1486 my $node = extract_param($param, 'node');
1487
1488 my $vmid = extract_param($param, 'vmid');
1489
1490 my $digest = extract_param($param, 'digest');
1491
1492 my $sizestr = extract_param($param, 'size');
1493 my $ext = ($sizestr =~ s/^\+//);
1494 my $newsize = PVE::JSONSchema::parse_size($sizestr);
1495 die "invalid size string" if !defined($newsize);
1496
1497 die "no options specified\n" if !scalar(keys %$param);
1498
f1ba1a4b 1499 PVE::LXC::check_ct_modify_config_perm($rpcenv, $authuser, $vmid, undef, $param, []);
985b18ed
WL
1500
1501 my $storage_cfg = cfs_read_file("storage.cfg");
1502
985b18ed
WL
1503 my $code = sub {
1504
67afe46e
FG
1505 my $conf = PVE::LXC::Config->load_config($vmid);
1506 PVE::LXC::Config->check_lock($conf);
985b18ed
WL
1507
1508 PVE::Tools::assert_if_modified($digest, $conf->{digest});
1509
1510 my $running = PVE::LXC::check_running($vmid);
1511
1512 my $disk = $param->{disk};
1b4cf758
FG
1513 my $mp = $disk eq 'rootfs' ? PVE::LXC::Config->parse_ct_rootfs($conf->{$disk}) :
1514 PVE::LXC::Config->parse_ct_mountpoint($conf->{$disk});
44a9face 1515
985b18ed
WL
1516 my $volid = $mp->{volume};
1517
1518 my (undef, undef, $owner, undef, undef, undef, $format) =
1519 PVE::Storage::parse_volname($storage_cfg, $volid);
1520
235dbdf3 1521 die "can't resize mount point owned by another container ($owner)"
985b18ed
WL
1522 if $vmid != $owner;
1523
1524 die "can't resize volume: $disk if snapshot exists\n"
1525 if %{$conf->{snapshots}} && $format eq 'qcow2';
1526
1527 my ($storeid, $volname) = PVE::Storage::parse_volume_id($volid);
1528
1529 $rpcenv->check($authuser, "/storage/$storeid", ['Datastore.AllocateSpace']);
1530
4e1e1791
WB
1531 PVE::Storage::activate_volumes($storage_cfg, [$volid]);
1532
985b18ed
WL
1533 my $size = PVE::Storage::volume_size_info($storage_cfg, $volid, 5);
1534 $newsize += $size if $ext;
1535 $newsize = int($newsize);
1536
1537 die "unable to shrink disk size\n" if $newsize < $size;
1538
1539 return if $size == $newsize;
1540
1541 PVE::Cluster::log_msg('info', $authuser, "update CT $vmid: resize --disk $disk --size $sizestr");
9f3f7963 1542 my $realcmd = sub {
e72c8b0e
DM
1543 # Note: PVE::Storage::volume_resize doesn't do anything if $running=1, so
1544 # we pass 0 here (parameter only makes sense for qemu)
9f3f7963
WL
1545 PVE::Storage::volume_resize($storage_cfg, $volid, $newsize, 0);
1546
1547 $mp->{size} = $newsize;
1b4cf758 1548 $conf->{$disk} = PVE::LXC::Config->print_ct_mountpoint($mp, $disk eq 'rootfs');
9f3f7963 1549
67afe46e 1550 PVE::LXC::Config->write_config($vmid, $conf);
9f3f7963
WL
1551
1552 if ($format eq 'raw') {
1553 my $path = PVE::Storage::path($storage_cfg, $volid, undef);
1554 if ($running) {
2a993004
WL
1555
1556 $mp->{mp} = '/';
1557 my $use_loopdev = (PVE::LXC::mountpoint_mount_path($mp, $storage_cfg))[1];
21f292ff 1558 $path = PVE::LXC::query_loopdev($path) if $use_loopdev;
235dbdf3 1559 die "internal error: CT running but mount point not attached to a loop device"
2a993004
WL
1560 if !$path;
1561 PVE::Tools::run_command(['losetup', '--set-capacity', $path]) if $use_loopdev;
9f3f7963
WL
1562
1563 # In order for resize2fs to know that we need online-resizing a mountpoint needs
1564 # to be visible to it in its namespace.
1565 # To not interfere with the rest of the system we unshare the current mount namespace,
1566 # mount over /tmp and then run resize2fs.
1567
1568 # interestingly we don't need to e2fsck on mounted systems...
1569 my $quoted = PVE::Tools::shellquote($path);
1570 my $cmd = "mount --make-rprivate / && mount $quoted /tmp && resize2fs $quoted";
ce9e6458
WB
1571 eval {
1572 PVE::Tools::run_command(['unshare', '-m', '--', 'sh', '-c', $cmd]);
1573 };
1574 warn "Failed to update the container's filesystem: $@\n" if $@;
9f3f7963 1575 } else {
ce9e6458
WB
1576 eval {
1577 PVE::Tools::run_command(['e2fsck', '-f', '-y', $path]);
1578 PVE::Tools::run_command(['resize2fs', $path]);
1579 };
1580 warn "Failed to update the container's filesystem: $@\n" if $@;
9f3f7963 1581 }
985b18ed 1582 }
9f3f7963 1583 };
985b18ed 1584
9f3f7963
WL
1585 return $rpcenv->fork_worker('resize', $vmid, $authuser, $realcmd);
1586 };
985b18ed 1587
67afe46e 1588 return PVE::LXC::Config->lock_config($vmid, $code);;
985b18ed
WL
1589 }});
1590
f76a2828 15911;