dillard
943c95bf07
backup:user:backup and backup:user:restore now ask the administrator before installing or enabling user_migration (or take --install-user-migration), so nothing changes on the server without consent. The restore warns that user_migration imports only its allowlisted app settings. Also: a clear error for unknown locations instead of a raw database message; prune reports the number of affected users, not the number of kept ones; and --user-last rejects values that are not whole numbers. Adds docs/HOWTO.md and updates the README and PLAN.md for the beta.
70 lines
2.8 KiB
PHP
70 lines
2.8 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
// SPDX-FileCopyrightText: 2026 Dillard Blom
|
|
// SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
namespace OCA\NgBackup\Command;
|
|
|
|
use OCA\NgBackup\Service\PruneService;
|
|
use OCA\NgBackup\Service\TargetService;
|
|
use Symfony\Component\Console\Command\Command;
|
|
use Symfony\Component\Console\Input\InputArgument;
|
|
use Symfony\Component\Console\Input\InputInterface;
|
|
use Symfony\Component\Console\Input\InputOption;
|
|
use Symfony\Component\Console\Output\OutputInterface;
|
|
|
|
final class Prune extends Command {
|
|
public function __construct(
|
|
private TargetService $targets,
|
|
private PruneService $prune,
|
|
) {
|
|
parent::__construct();
|
|
}
|
|
|
|
protected function configure(): void {
|
|
$this->setName('backup:prune')
|
|
->setDescription('Apply the retention policy: remove old snapshots and the data only they used')
|
|
->addArgument('target', InputArgument::OPTIONAL, 'Location name or id (default: all that are not append-only)')
|
|
->addOption('dry-run', null, InputOption::VALUE_NONE, 'Only show what would be removed');
|
|
}
|
|
|
|
protected function execute(InputInterface $input, OutputInterface $output): int {
|
|
$name = $input->getArgument('target');
|
|
$targets = $name === null ? array_filter($this->targets->list(), fn ($t) => !$t->getAppendOnly()) : [$this->targets->get($name)];
|
|
$dry = (bool)$input->getOption('dry-run');
|
|
$output->writeln('Policy: ' . json_encode($this->prune->policy()->toArray()) . ($dry ? ' (dry run)' : ''));
|
|
$rc = 0;
|
|
foreach ($targets as $t) {
|
|
// User exports first: Repository::prune()'s blob garbage collection (run as part of
|
|
// apply() below) scans the users/ manifests still on the location at that point, so
|
|
// forgetting one here lets its now-unused blobs be freed in this same pass.
|
|
try {
|
|
$ru = $this->prune->applyUserExports($t, $dry);
|
|
} catch (\Throwable $e) {
|
|
$output->writeln('<error>' . $t->getName() . ' (user exports): ' . $e->getMessage() . '</error>');
|
|
$rc = 1;
|
|
continue;
|
|
}
|
|
if ($ru['forgotten'] !== []) {
|
|
$affected = count(array_unique(array_map(static fn (string $path): string => explode('/', $path)[1] ?? '', $ru['forgotten'])));
|
|
$output->writeln(sprintf('<info>%s</info>: %s %d user export(s) for %d user(s)',
|
|
$t->getName(), $dry ? 'would forget' : 'forgot', count($ru['forgotten']), $affected));
|
|
}
|
|
try {
|
|
$r = $this->prune->apply($t, $dry);
|
|
} catch (\Throwable $e) {
|
|
$output->writeln('<error>' . $t->getName() . ': ' . $e->getMessage() . '</error>');
|
|
$rc = 1;
|
|
continue;
|
|
}
|
|
$p = $r['prune'];
|
|
$output->writeln(sprintf('<info>%s</info>: keep %d, %s %d snapshots; packs: %d, %s %d, repack %d, frees %.1f MiB',
|
|
$t->getName(), count($r['kept']), $dry ? 'would forget' : 'forgot', count($r['forgotten']), $p['packs'],
|
|
$dry ? 'would delete' : 'deleted', $p['deleted'], $p['repacked'], $p['freedBytes'] / 1048576));
|
|
}
|
|
return $rc;
|
|
}
|
|
}
|