Permafrost

Permafrost представляет собой хостинговое хранилище, созданное для Frost. Для подключения хватает одного ключа доступа, без настройки бакета, региона или эндпоинта.

Копии шифруются на вашем компьютере до отправки, как и с любым другим хранилищем. Permafrost не может их прочитать.

Управлять аккаунтом Permafrost можно на getfro.st/perma/portal. В браузере снимков нажмите [h], затем [p], чтобы открыть его. Это сочетание доступно только для стандартного сервиса Permafrost.

#Как получить ключ

  1. Выполните frost init и выберите Permafrost.
  2. Выберите I don't have a key yet (ключа пока нет). Frost откроет getfro.st/perma в браузере. Если браузер не открылся, перейдите туда сами.
  3. Получите там ключ и скопируйте его.
  4. Вставьте его в мастер.

Если ключ у вас уже есть, выберите I have a key (ключ есть) и вставьте его.

#Как получить новый ключ

Если вы потеряли ключ, перейдите на getfro.st/perma/recover и введите адрес электронной почты, с которым получали ключ. В письме, которое придёт, будет ссылка на новый ключ. Новый ключ заменяет старый, и старый перестаёт работать на всех компьютерах.

На каждом компьютере, который использует Permafrost, замените ключ на новый:

frost config set storage.permafrost.token <new key>

Пока Permafrost не принимает загрузки, frost config set не может выполнить проверку хранилища. Вместо него используйте frost config edit и впишите ключ в token в разделе [storage.permafrost].

#Занятое место

frost status показывает, сколько места в Permafrost вы занимаете. Когда Permafrost нужно что-то сообщить, например что хранилище почти заполнено, frost status и frost backup показывают это как предупреждение. Подробнее в разделе Проверка резервных копий.

#Когда Permafrost отказывает

Ошибки Permafrost объясняют причину. Команды, обращающиеся к резервным копиям, останавливаются с этим сообщением.

Что вы видите Что это значит
the Permafrost access key was rejected Ключ неверный, его заменил более новый ключ или учётная запись закрыта. В сообщении сказано, что именно. Используйте самый новый ключ или получите новый
uploads are paused Permafrost пока не принимает новые резервные копии. Восстановление по-прежнему работает. В сообщении сказано, почему, до какого срока и что делать
your Permafrost storage is full Загрузка не помещается. В сообщении сказано, сколько вы храните и что делать

В мастере первые два сообщения выглядят как «Permafrost didn't accept that access key» и «Permafrost won't store backups with that access key», а после них следует та же причина.

#Совместимый сервер

Вместо сервера по умолчанию Frost может работать с любым сервером, поддерживающим API Permafrost. Этот вариант для тех, у кого уже есть такой сервер. Чтобы делать копии на своём компьютере, вариант Собственный сервер требует только SSH.

Совместимый сервер должен соблюдать правила API для объектов и ошибок, включая отказ от пустых загрузок. Если сервер занят, Frost автоматически повторяет запрос.

Перед первой настройкой создайте файл config.toml в папке конфигурации Frost, указанной в разделе Файлы и папки, с такими настройками. Замените адрес на адрес своего сервера:

[storage]
backend = "permafrost"

[storage.permafrost]
url = "https://<your-server>"

Затем выполните frost init, выберите Permafrost, вставьте ключ доступа, выберите папки и сохраните настройки. Если сервер пустой, мастер создаст репозиторий.

Если Frost уже настроен, через frost config edit измените тип хранилища и адрес сервера вместе в существующем файле. Подтвердите предупреждение, если новый сервер пустой, введите yes, чтобы сохранить, а затем снова выполните frost init. Команда frost config set не принимает пустое место назначения, поэтому подготовить новый сервер с её помощью нельзя.

Адрес должен начинаться с https://. Исключение составляет только сервер на вашем собственном компьютере, например http://localhost:8080. Оставьте настройку пустой, чтобы использовать сервер Permafrost по умолчанию, https://permafrost.wihiaawb.com.