cloudron-box/dashboard/src/views/RestoreView.vue

<script setup>

import { ref, onMounted, useTemplateRef } from 'vue';
import { Notification, ProgressBar, Button, SingleSelect, FormGroup, PasswordInput, TextInput, Checkbox } from '@cloudron/pankow';
import { copyToClipboard } from '@cloudron/pankow/utils';
import { REGIONS_CONTABO, REGIONS_VULTR, REGIONS_IONOS, REGIONS_OVH, REGIONS_LINODE, REGIONS_SCALEWAY, REGIONS_WASABI } from '../constants.js';
import { redirectIfNeeded, mountlike, s3like } from  '../utils.js';
import ProvisionModel from '../models/ProvisionModel.js';
import BackupProviderForm from '../components/BackupProviderForm.vue';

const provisionModel = ProvisionModel.create();

const ipProviders = [
  { name: 'Disabled', value: 'noop' },
  { name: 'Public IP', value: 'generic' },
  { name: 'Static IP Address', value: 'fixed' },
  { name: 'Network Interface', value: 'network-interface' }
];

const formError = ref({});
const busy = ref(false);
const ready = ref(false);
const waitingForRestore = ref(false);
const progressMessage = ref('');
const taskMinutesActive = ref(0);
const provider = ref('');
const providerConfig = ref({});
const remotePath = ref('');
const format = ref('');
const encrypted = ref(false);
const encryptionPasswordHint = ref('');
const encryptionPassword = ref('');
const encryptedFilenames = ref(false);
const showAdvanced = ref(false);
const ipv4Provider = ref('generic');
const ipv4Address = ref('');
const ipv4Interface = ref('');
const ipv6Provider = ref('generic');
const ipv6Address = ref('');
const ipv6Interface = ref('');
const skipDnsSetup = ref(false);

const form = useTemplateRef('form');
const isFormValid = ref(false);
function checkValidity() {
  if (!provider.value) return false;
  isFormValid.value = form.value.checkValidity();
}

async function waitForRestore () {
  waitingForRestore.value = true;
  formError.value = {};

  const [error, result] = await provisionModel.status();
  if (error) {
    setTimeout(waitForRestore, 5000);
    return console.error(error);
  }

  if (!result.restore.active) {
    if (!result.adminFqdn || result.restore.errorMessage) { // restore reset or errored. start over
      formError.value.dnsWait = result.restore.errorMessage;
      waitingForRestore.value = false;
      busy.value = false;
    } else { // proceed to dashboard
      window.location.href = 'https://' + result.adminFqdn;
    }
    return;
  }

  progressMessage.value = result.restore.message;
  // TODO do we have the time here?
  taskMinutesActive.value = (new Date() - new Date(result.restore.startTime)) / 60000;

  setTimeout(waitForRestore, 5000);
}

async function onSubmit() {
  if (!isFormValid.value) return;

  busy.value = true;
  formError.value = {};

  if (remotePath.value.indexOf('/') === -1) {
    error.value.generic = 'Backup id must include the directory path';
    error.value.remotePath = true;
    busy.value = false;
    return;
  }

  if (remotePath.value.indexOf('box') === -1) {
    error.value.generic = 'Backup id must contain "box"';
    error.value.remotePath = true;
    busy.value = false;
    return;
  }

  const version = remotePath.value.match(/_v(\d+.\d+.\d+)/);
  if (!version) {
    formError.value.generic = 'Backup id is missing version information';
    formError.value.remotePath = true;
    busy.value = false;
    return;
  }

  const config = {}; // filled below

  const data = {
    backupConfig: {
      provider: provider.value,
      config, // filled below
      format: format.value,
    },
    remotePath: remotePath.value,
    version: version ? version[1] : '',
    ipv4Config: {
      provider: ipv4Provider.value,
      ip: ipv4Address.value,
      ifname: ipv4Interface.value,
    },
    ipv6Config: {
      provider: ipv6Provider.value,
      ip: ipv6Address.value,
      ifname: ipv6Interface.value,
    },
    skipDnsSetup: skipDnsSetup.value,
  };

  if (encrypted.value) {
    data.backupConfig.encryptionPassword = encryptionPassword.value;
    data.backupConfig.encryptedFilenames = encryptedFilenames.value;
  }

  if (s3like(provider.value)) {
    config.endpoint = providerConfig.value.endpoint;
    config.prefix = providerConfig.value.prefix;
    config.bucket = providerConfig.value.bucket;
    config.accessKeyId = providerConfig.value.accessKeyId;
    config.secretAccessKey = providerConfig.value.secretAccessKey;

    if (provider.value === 's3') {
      config.region = providerConfig.value.region || undefined;
    } else if (provider.value === 'minio' || provider.value === 's3-v4-compat') {
      config.region = providerConfig.value.region || 'us-east-1';
      config.acceptSelfSignedCerts = providerConfig.value.acceptSelfSignedCerts;
      config.s3ForcePathStyle = true;
    } else if (provider.value === 'exoscale-sos') {
      config.region = 'us-east-1';
      config.signatureVersion = 'v4';
    } else if (provider.value === 'wasabi') {
      config.region = REGIONS_WASABI.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
    } else if (provider.value === 'scaleway-objectstorage') {
      config.region = REGIONS_SCALEWAY.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
    } else if (provider.value === 'linode-objectstorage') {
      config.region = REGIONS_LINODE.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
    } else if (provider.value === 'ovh-objectstorage') {
      config.region = REGIONS_OVH.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
    } else if (provider.value === 'ionos-objectstorage') {
      config.region = REGIONS_IONOS.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
    } else if (provider.value === 'vultr-objectstorage') {
      config.region = REGIONS_VULTR.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
    } else if (provider.value === 'contabo-objectstorage') {
      config.region = REGIONS_CONTABO.find(function (x) { return x.value === config.endpoint; }).region;
      config.signatureVersion = 'v4';
      config.s3ForcePathStyle = true;
    } else if (provider.value === 'upcloud-objectstorage') { // the UI sets region and endpoint
      const m = /^.*\.(.*)\.upcloudobjects.com$/.exec(config.endpoint);
      config.region = m ? m[1] : 'us-east-1'; // let it fail in validation phase if m is not valid
      config.signatureVersion = 'v4';
    } else if (provider.value === 'digitalocean-spaces') {
      config.region = 'us-east-1';
    } else if (provider.value === 'hetzner-objectstorage') {
      config.region = 'us-east-1';
      config.signatureVersion = 'v4';
    }
  } else if (mountlike(provider.value)) {
    config.prefix = providerConfig.value.prefix;
    config.noHardlinks = !providerConfig.value.useHardlinks;
    config.mountOptions = {};

    if (provider.value === 'cifs' || provider.value === 'sshfs' || provider.value === 'nfs') {
      config.mountOptions.host = providerConfig.value.mountOptionHost;
      config.mountOptions.remoteDir = providerConfig.value.mountOptionRemoteDir;

      if (provider.value === 'cifs') {
        config.mountOptions.username = providerConfig.value.mountOptionUsername;
        config.mountOptions.password = providerConfig.value.mountOptionPassword;
        config.mountOptions.seal = !!providerConfig.value.mountOptionSeal;
        config.preserveAttributes = !!providerConfig.value.preserveAttributes;
      } else if (provider.value === 'sshfs') {
        config.mountOptions.user = providerConfig.value.mountOptionUser;
        config.mountOptions.port = parseInt(providerConfig.value.mountOptionPort);
        config.mountOptions.privateKey = providerConfig.value.mountOptionPrivateKey;
        config.preserveAttributes = true;
      }
    } else if (provider.value === 'ext4' || provider.value === 'xfs' || provider.value === 'disk') {
        config.mountOptions.diskPath = providerConfig.value.mountOptionDiskPath;
        config.preserveAttributes = true;
    } else if (provider.value === 'mountpoint') {
        config.mountPoint = providerConfig.value.mountPoint;
        config.chown = !!providerConfig.value.chown;
        config.preserveAttributes = !!providerConfig.value.preserveAttributes;
    }
  } else if (provider.value === 'filesystem') {
    config.backupDir = providerConfig.value.backupDir;
    config.noHardlinks = !providerConfig.value.useHardlinks;
    config.preserveAttributes = true;
  } else if (provider.value === 'gcs') {
    config.bucket = providerConfig.value.bucket;
    config.prefix = providerConfig.value.prefix;
    config.projectId = providerConfig.value.projectId;
    config.credentials = providerConfig.value.credentials;
  }

  const [error] = await provisionModel.restore(data);
  if (error) {
    if (error.status === 424) {
      formError.value.generic = error.body.message;

      if (error.body.message.indexOf('AWS Access Key Id') !== -1) {
        formError.value.accessKeyId = true;
      } else if (error.body.message.indexOf('not match the signature') !== -1 ) {
        formError.value.secretAccessKey = true;
      } else if (error.body.message.toLowerCase() === 'access denied') {
        formError.value.bucket = true;
      } else if (error.body.message.indexOf('ECONNREFUSED') !== -1) {
        formError.value.generic = 'Unknown region';
        formError.value.region = true;
      } else if (error.body.message.toLowerCase() === 'wrong region') {
        formError.value.generic = 'Wrong S3 Region';
        formError.value.region = true;
      } else {
        formError.value.generic = error.body.message;
      }
    } else {
      formError.value.generic = error.body ? error.body.message : 'Internal error';
      console.error(error);
    }

    busy.value = false;
    return;
  }

  waitForRestore();
}

function onBackupConfigChanged(event) {
  const reader = new FileReader();
  reader.onload = function (result) {
    if (!result.target || !result.target.result) return console.error('Unable to read backup config');

    let data;
    try {
      data = JSON.parse(result.target.result); // 'provider', 'config', 'limits', 'format', 'remotePath', 'encrypted', 'encryptedFilenames'
      if (data.provider === 'filesystem') { // this allows a user to upload a backup to server and import easily with an absolute path
        data.remotePath = `${data.config.backupDir}/${data.remotePath}`;
      }
    } catch (e) {
      console.error('Unable to parse backup config', e);
      return;
    }

    provider.value = data.provider;
    remotePath.value = data.remotePath;
    providerConfig.value = data.config;
    format.value = data.format;
    encrypted.value = !!data.encrypted;
    encryptionPasswordHint.value = data.encryptionPasswordHint || '';
    encryptionPassword.value = '';
    encryptedFilenames.value = data.encryptedFilenames;
  };

  reader.readAsText(event.target.files[0]);
}

const backupConfigFileInput = useTemplateRef('backupConfigFileInput');
function onUploadBackupConfig() {
  backupConfigFileInput.value.click();
}

function onCopyToClipboard(value) {
  copyToClipboard(value);
  window.pankow.notify('copied to clipboard');
}

onMounted(async () => {
  let [error, result] = await provisionModel.status();
  if (error) return console.error(error);

  if (redirectIfNeeded(result, 'restore')) return; // redirected to some other view...

  [error, result] = await provisionModel.detectIp();
  if (error) return console.error(error);

  ipv4Provider.value = result.ipv4 ? 'generic' : 'noop';
  ipv6Provider.value = result.ipv6 ? 'generic' : 'noop';

  ready.value = true;
});

</script>

<template>
  <div class="container" v-if="ready">
    <Notification />

    <Transition name="slide-fade" mode="out-in">
      <div class="view" v-if="waitingForRestore" style="text-align: center;">
        <div>
          <h3>Please wait while Cloudron is restoring</h3>
          <ProgressBar mode="indeterminate" :show-label="false" :slim="true"/>
          <h3>{{ progressMessage }}</h3>
        </div>
        <div style="position: absolute; bottom: 10px; text-align: center; width: 100%; font-size: 12px;">
          <span v-show="taskMinutesActive >= 4">If restore appears stuck, it can be restarted by running <code @click="onCopyToClipboard('systemctl restart box')">systemctl restart box</code> and reloading this page.</span>
          <br/>
          <br/>
          You can follow the logs on the server at <code @click="onCopyToClipboard('/home/yellowtent/platformdata/logs/box.log')">/home/yellowtent/platformdata/logs/box.log</code>
        </div>
      </div>

      <div class="view" v-else style="max-width: 500px;">
        <h1 style="text-align: center">Cloudron Restore</h1>
        <p>Provide the backup information to restore from, or
          <input type="file" ref="backupConfigFileInput" @change="onBackupConfigChanged" accept="application/json, text/json" style="display:none"/>
          <button type="button" style="background: none; border: none; color: #007bff; cursor: pointer; text-decoration: underline; padding: 0;" @click="onUploadBackupConfig()">
            upload a Backup Config
          </button>
        </p>

        <div class="error-label" v-if="formError.generic">{{ formError.generic }}</div>

        <form ref="form" @submit.prevent="onSubmit()" @input="checkValidity()">
          <fieldset :disabled="busy">
            <input type="submit" style="display: none;"/>

            <!-- remotePath contains the prefix as well -->
            <FormGroup>
              <label for="inputRemotePath">{{ $t('app.importBackupDialog.remotePath') }} <sup><a href="https://docs.cloudron.io/backups/#import-app-backup" class="help" target="_blank"><i class="fa fa-question-circle"></i></a></sup></label>
              <TextInput id="inputRemotePath" v-model="remotePath" required />
            </FormGroup>

            <BackupProviderForm ref="form"
              v-model:provider="provider"
              v-model:provider-config="providerConfig"
              v-model:format="format"
              :form-error="formError"
              :provisioning="true"
              :import-only="true" />

            <div v-show="showAdvanced">
              <Checkbox style="padding-top: 12px" v-model="encrypted" :label="$t('backups.configureBackupStorage.usesEncryption')"/>
              <FormGroup v-if="encrypted">
                <label for="encryptionPassswordInput">{{ $t('backups.configureBackupStorage.encryptionPassword') }}</label>
                <PasswordInput id="encryptionPassswordInput" v-model="encryptionPassword" :placeholder="$t('backups.configureBackupStorage.encryptionPasswordPlaceholder')" required/>
                <div class="warning-label" v-if="encryptionPasswordHint">{{ $t('backups.configureBackupStorage.encryptionHint') }}: {{ encryptionPasswordHint }}</div>
              </FormGroup>
              <Checkbox v-if="encrypted && format === 'rsync'" v-model="encryptedFilenames" :label="$t('backups.configureBackupStorage.encryptFilenames')"/>

              <!-- IPv4 provider -->
              <FormGroup>
                <label class="control-label">IPv4 Configuration  <sup><a href="https://docs.cloudron.io/networking/#ip-configuration" class="help" target="_blank"><i class="fa fa-question-circle"></i></a></sup></label>
                <SingleSelect v-model="ipv4Provider" :options="ipProviders" option-key="value" option-label="name" />
              </FormGroup>

              <!-- IPv4 Fixed -->
              <FormGroup v-if="ipv4Provider === 'fixed'">
                <label for="ipv4AddressInput">IPv4 Address</label>
                <TextInput id="ipv4AddressInput" v-model="ipv4Address" required />
              </FormGroup>

              <!-- IPv4 Network Interface -->
              <FormGroup v-if="ipv4Provider === 'network-interface'">
                <label for="ipv4InterfaceInput">IPv4 Interface Name</label>
                <TextInput id="ipv4InterfaceInput" v-model="ipv4Interface" required />
              </FormGroup>

              <!-- IPv6 provider -->
              <FormGroup>
                <label class="control-label">IPv6 Configuration  <sup><a href="https://docs.cloudron.io/networking/#ip-configuration" class="help" target="_blank"><i class="fa fa-question-circle"></i></a></sup></label>
                <SingleSelect v-model="ipv6Provider" :options="ipProviders" option-key="value" option-label="name" />
              </FormGroup>

              <!-- IPv6 Fixed -->
              <FormGroup v-if="ipv6Provider === 'fixed'">
                <label for="ipv6AddressInput">IPv6 Address</label>
                <TextInput id="ipv6AddressInput" v-model="ipv6Address" required />
              </FormGroup>

              <!-- IPv6 Network Interface -->
              <FormGroup v-if="ipv6Provider === 'network-interface'">
                <label for="ipv6InterfaceInpt">IPv6 Interface Name</label>
                <TextInput id="ipv6InterfaceInpt" v-model="ipv6Interface" required />
              </FormGroup>
            </div>

            <div class="actionable" @click="showAdvanced = false" v-if="showAdvanced">Hide Advanced settings</div>
            <div class="actionable" @click="showAdvanced = true" v-else>Advanced settings...</div>

            <div style="margin-top: 18px">
              <Checkbox v-model="skipDnsSetup" label="Dry run"/>
              <small class="helper-text">
                When enabled, apps are restored but the DNS records are not updated to point to this server.
                To access the dashboard, this browser's host must have an entry in <code>/etc/hosts</code> for the dashboard domain to this server's IP.
                See the <a href="https://docs.cloudron.io/backups/#dry-run" target="_blank">docs</a> for more information.
              </small>
            </div>

          </fieldset>
        </form>

        <div class="actions">
          <Button @click="onSubmit()" :disabled="busy || !isFormValid" :loading="busy">Restore</Button>
          <a class="setup" href="/setup.html">Looking to setup?</a>
        </div>

      </div>
    </Transition>
  </div>
</template>

<style scoped>

.actions {
  margin-top: 1.5em;
  display: flex;
  flex-direction: column;
  align-items: center;
}

.actions .setup {
  margin-top: 1em;
  font-size: 0.9em;
}

</style>