# # This file is part of FreedomBox. # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as # published by the Free Software Foundation, either version 3 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see . # """ FreedomBox app to manage backup archives. """ import json import os from django.utils.text import get_valid_filename from django.utils.translation import ugettext_lazy as _ from plinth import actions from plinth.errors import PlinthError from plinth.menu import main_menu from plinth.modules import storage from . import api from .manifest import backup version = 1 managed_packages = ['borgbackup'] name = _('Backups') description = [ _('Backups allows creating and managing backup archives.'), ] service = None MANIFESTS_FOLDER = '/var/lib/plinth/backups-manifests/' BACKUP_FOLDER_NAME = 'FreedomBox-backups' def init(): """Intialize the module.""" menu = main_menu.get('system') menu.add_urlname(name, 'glyphicon-duplicate', 'backups:index') def setup(helper, old_version=None): """Install and configure the module.""" helper.install(managed_packages) helper.call('post', actions.superuser_run, 'backups', ['setup']) def get_info(): output = actions.superuser_run('backups', ['info']) return json.loads(output) def list_archives(): output = actions.superuser_run('backups', ['list']) return json.loads(output)['archives'] def get_archive(name): for archive in list_archives(): if archive['name'] == name: return archive return None def _backup_handler(packet): """Performs backup operation on packet.""" if not os.path.exists(MANIFESTS_FOLDER): os.makedirs(MANIFESTS_FOLDER) manifest_path = os.path.join(MANIFESTS_FOLDER, get_valid_filename(packet.label) + '.json') manifests = [{ 'name': app.name, 'version': app.app.version, 'backup': app.manifest } for app in packet.apps] with open(manifest_path, 'w') as manifest_file: json.dump(manifests, manifest_file) paths = packet.directories + packet.files paths.append(manifest_path) actions.superuser_run( 'backups', ['create', '--name', packet.label, '--paths'] + paths) def create_archive(name, app_names): api.backup_apps(_backup_handler, app_names, name) def delete_archive(name): actions.superuser_run('backups', ['delete', '--name', name]) def export_archive(name, location): location_path = get_location_path(location) filepath = get_archive_path(location_path, get_valid_filename(name) + '.tar.gz') # TODO: that's a full path, not a filename; rename argument actions.superuser_run('backups', ['export', '--name', name, '--filename', filepath]) def get_export_locations(): """Return a list of storage locations for exported backup archives.""" locations = [{ 'path': '/var/lib/freedombox/', 'label': _('Root Filesystem'), 'device': '/' }] if storage.is_running(): devices = storage.udisks2.list_devices() for device in devices: if 'mount_points' in device and len(device['mount_points']) > 0: location = { 'path': device['mount_points'][0], 'label': device['label'] or device['device'], 'device': device['device'] } locations.append(location) return locations def get_location_path(device, locations=None): """Returns the location path given a disk label""" if locations is None: locations = get_export_locations() for location in locations: if location['device'] == device: return location['path'] raise PlinthError('Could not find path of location %s' % device) def get_export_files(): """Return a dict of exported backup archives found in storage locations.""" locations = get_export_locations() export_files = [] for location in locations: output = actions.superuser_run( 'backups', ['list-exports', '--location', location['path']]) location['files'] = json.loads(output) export_files.append(location) return export_files def get_archive_path(location, archive_name): return os.path.join(location, BACKUP_FOLDER_NAME, archive_name) def find_exported_archive(device, archive_name): """Return the full path for the exported archive file.""" location_path = get_location_path(device) return get_archive_path(location_path, archive_name) def get_export_apps(filename): """Get list of apps included in exported archive file.""" output = actions.superuser_run('backups', ['get-export-apps', '--filename', filename]) return output.splitlines() def _restore_handler(packet): """Perform restore operation on packet.""" locations = {'directories': packet.directories, 'files': packet.files} locations_data = json.dumps(locations) actions.superuser_run('backups', ['restore', '--filename', packet.label], input=locations_data.encode()) def restore_exported(device, archive_name, apps=None): """Restore files from exported backup archive.""" filename = find_exported_archive(device, archive_name) api.restore_apps(_restore_handler, app_names=apps, create_subvolume=False, backup_file=filename)