From: Fiona Ebner <f.ebner@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH container v7 30/37] backup: implement backup for external providers
Date: Tue, 1 Apr 2025 19:34:28 +0200 [thread overview]
Message-ID: <20250401173435.221892-31-f.ebner@proxmox.com> (raw)
In-Reply-To: <20250401173435.221892-1-f.ebner@proxmox.com>
The filesystem structure is made available as a directory in a
consistent manner (with details depending on the vzdump backup mode)
just like for regular backup via tar.
The backup_container() method of the backup provider is executed in
a user namespace with the container's ID mapping applied. This allows
the backup provider to see the container's filesystem from the
container's perspective.
The 'prepare' phase of the backup hook is executed right before and
allows the backup provider to prepare for the (usually) unprivileged
execution context in the user namespace.
The backup provider needs to back up the guest and firewall
configuration and the filesystem structure of the container, honoring
file exclusions and the bandwidth limit.
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
---
Changes in v7:
* Adapt to changed backup_get_mechanism() return type.
src/PVE/VZDump/LXC.pm | 40 +++++++++++++++++++++++++++++++++++++++-
1 file changed, 39 insertions(+), 1 deletion(-)
diff --git a/src/PVE/VZDump/LXC.pm b/src/PVE/VZDump/LXC.pm
index 9029387..e68ba74 100644
--- a/src/PVE/VZDump/LXC.pm
+++ b/src/PVE/VZDump/LXC.pm
@@ -11,6 +11,7 @@ use PVE::Cluster qw(cfs_read_file);
use PVE::GuestHelpers;
use PVE::INotify;
use PVE::LXC::Config;
+use PVE::LXC::Namespaces;
use PVE::LXC;
use PVE::Storage;
use PVE::Tools;
@@ -124,6 +125,7 @@ sub prepare {
my ($id_map, $root_uid, $root_gid) = PVE::LXC::parse_id_maps($conf);
$task->{userns_cmd} = PVE::LXC::userns_command($id_map);
+ $task->{id_map} = $id_map;
$task->{root_uid} = $root_uid;
$task->{root_gid} = $root_gid;
@@ -373,7 +375,43 @@ sub archive {
my $userns_cmd = $task->{userns_cmd};
my $findexcl = $self->{vzdump}->{findexcl};
- if ($self->{vzdump}->{opts}->{pbs}) {
+ if (my $backup_provider = $self->{vzdump}->{'backup-provider'}) {
+ $self->loginfo("starting external backup via " . $backup_provider->provider_name());
+
+ if (!scalar($task->{id_map}->@*) || $task->{root_uid} == 0 || $task->{root_gid} == 0) {
+ $self->log("warn", "external backup of privileged container can only be restored as"
+ ." unprivileged which might not work in all cases");
+ }
+
+ my $mechanism = $backup_provider->backup_get_mechanism($vmid, 'lxc');
+ die "mechanism '$mechanism' requested by backup provider is not supported for containers\n"
+ if $mechanism ne 'directory';
+
+ $self->loginfo("using backup mechanism '$mechanism'");
+
+ my $guest_config = PVE::Tools::file_get_contents("$tmpdir/etc/vzdump/pct.conf");
+ my $firewall_file = "$tmpdir/etc/vzdump/pct.fw";
+
+ my $info = {
+ directory => $snapdir,
+ sources => [@sources],
+ 'backup-user-id' => $task->{root_uid},
+ };
+ $info->{'firewall-config'} = PVE::Tools::file_get_contents($firewall_file)
+ if -e $firewall_file;
+ $info->{'bandwidth-limit'} = $opts->{bwlimit} * 1024 if $opts->{bwlimit};
+
+ $backup_provider->backup_container_prepare($vmid, $info);
+
+ if (scalar($task->{id_map}->@*)) {
+ PVE::LXC::Namespaces::run_in_userns(
+ sub { $backup_provider->backup_container($vmid, $guest_config, $findexcl, $info); },
+ $task->{id_map},
+ );
+ } else {
+ $backup_provider->backup_container($vmid, $guest_config, $findexcl, $info);
+ }
+ } elsif ($self->{vzdump}->{opts}->{pbs}) {
my $param = [];
push @$param, "pct.conf:$tmpdir/etc/vzdump/pct.conf";
--
2.39.5
_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel
next prev parent reply other threads:[~2025-04-01 17:38 UTC|newest]
Thread overview: 48+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-04-01 17:33 [pve-devel] [PATCH-SERIES qemu/storage/qemu-server/container/manager v7 00/37] backup provider API Fiona Ebner
2025-04-01 17:33 ` [pve-devel] [PATCH qemu v7 01/37] PVE backup: clean up directly in setup_snapshot_access() when it fails Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 02/37] PVE backup: factor out helper to clear backup state's bitmap list Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 03/37] PVE backup: factor out helper to initialize backup state stat struct Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 04/37] PVE backup: add target ID in backup state Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 05/37] PVE backup: get device info: allow caller to specify filter for which devices use fleecing Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 06/37] PVE backup: implement backup access setup and teardown API for external providers Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 07/37] PVE backup: factor out get_single_device_info() helper Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 08/37] PVE backup: implement bitmap support for external backup access Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu v7 09/37] PVE backup: backup-access api: indicate situation where a bitmap was recreated Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH storage v7 10/37] add storage_has_feature() helper function Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH storage v7 11/37] common: add deallocate " Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH storage v7 12/37] plugin: introduce new_backup_provider() method Fiona Ebner
2025-04-02 10:01 ` Max Carrara
2025-04-02 10:44 ` Thomas Lamprecht
2025-04-02 14:02 ` Max Carrara
2025-04-01 17:34 ` [pve-devel] [PATCH storage v7 13/37] config api/plugins: let plugins define sensitive properties themselves Fiona Ebner
2025-04-02 10:01 ` Max Carrara
2025-04-01 17:34 ` [pve-devel] [PATCH storage v7 14/37] plugin api: bump api version and age Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH storage v7 15/37] extract backup config: delegate to backup provider for storages that support it Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [POC storage v7 16/37] add backup provider example Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [POC storage v7 17/37] Borg example plugin Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 18/37] backup: keep track of block-node size for fleecing Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 19/37] backup: fleecing: use exact size when allocating non-raw fleecing images Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 20/37] backup: allow adding fleecing images also for EFI and TPM Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 21/37] backup: implement backup for external providers Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 22/37] test: qemu img convert: add test cases for snapshots Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 23/37] image convert: collect options in hash argument Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 24/37] image convert: allow caller to specify the format of the source path Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 25/37] backup: implement restore for external providers Fiona Ebner
2025-04-02 9:10 ` Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 26/37] backup: future-proof checks for QEMU feature support Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 27/37] backup: support 'missing-recreated' bitmap action Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH qemu-server v7 28/37] backup: bitmap action to human: lie about TPM state Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH container v7 29/37] add LXC::Namespaces module Fiona Ebner
2025-04-01 17:34 ` Fiona Ebner [this message]
2025-04-01 17:34 ` [pve-devel] [PATCH container v7 31/37] backup: implement restore for external providers Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH container v7 32/37] external restore: don't use 'one-file-system' tar flag when restoring from a directory Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH container v7 33/37] create: factor out compression option helper Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH container v7 34/37] restore tar archive: check potentially untrusted archive Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH container v7 35/37] api: add early check against restoring privileged container from external source Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH manager v7 36/37] ui: backup: also check for backup subtype to classify archive Fiona Ebner
2025-04-01 17:34 ` [pve-devel] [PATCH manager v7 37/37] backup: implement backup for external providers Fiona Ebner
2025-04-02 15:15 ` [pve-devel] [PATCH-SERIES qemu/storage/qemu-server/container/manager v7 00/37] backup provider API Friedrich Weber
2025-04-03 7:52 ` Wolfgang Bumiller
2025-04-03 13:55 ` Friedrich Weber
2025-04-04 7:30 ` Fiona Ebner
2025-04-03 13:11 ` [pve-devel] superseded: " Wolfgang Bumiller
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250401173435.221892-31-f.ebner@proxmox.com \
--to=f.ebner@proxmox.com \
--cc=pve-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal