Перейти до вмісту

Резервні копії

← Назад до індексу документації

Сторінка Резервні копії містить усі знімки вашого парку серверів із зазначенням розміру, причини та віку, з можливістю фільтрації за сервером та причиною.

Резервні копії

Створення резервної копії

Section titled “Створення резервної копії”

На вкладці Резервні копії сервера (або через розклад) ви можете створити знімок усієї директорії сервера одним кліком. Панель спочатку зупиняє запис у світ (save-off → save-all), стискає дані, а потім знову вмикає запис (save-on), тому резервні копії є послідовними навіть на запущеному сервері. Стиснення виконується у фоновому потоці, щоб не блокувати панель. Резервна копія, розпочата через API, може містити примітку.

Кожен архів перевіряється на цілісність у момент запису: панель повторно відкриває zip-архів і читає його вміст. Пошкоджений або невідкривний архів видаляється, і запит на резервне копіювання негайно скасовується, щоб проблема не виявилася через місяці, коли відновлення буде єдиним способом уникнути втрати даних. Архів з нульовим вмістом (сервер, який ніколи не запускався) дозволяється, але позначається в події.

Поставте прапорець “Також зменшити світ після цього” (на вкладці “Резервні копії” або в розкладі резервного копіювання), щоб видалити рідко відвідувані чанки після безпечного запису архіву (див. Зменшення світу). Зменшення виконується лише тоді, коли сервер зупинено; на запущеному сервері резервне копіювання все одно відбувається, а зменшення пропускається.

Резервні копії сервера

Причини резервного копіювання

Section titled “Причини резервного копіювання”

Резервні копії позначаються причиною їх створення:

  • вручну: ви натиснули Створити резервну копію зараз. Заміна активного світу сервера на один з бібліотеки також спочатку створює вручну резервну копію.
  • за розкладом: створено за розкладом. Кожен новий сервер також автоматично отримує щоденну резервну копію за розкладом (з інтервалом між 02:00 та 05:59), тому сервер має автоматичне покриття з першого дня, а не лише перед оновленнями.
  • перед оновленням: створюється автоматично перед оновленням пакету або зміною версії Minecraft, тому оновлення завжди можна скасувати.
  • перед відновленням: створюється автоматично безпосередньо перед відновленням або скиданням світу як запобіжний захід на випадок, якщо відновлення виявиться не тим, що ви хотіли.

Зберігання обмежено на сервер, на причину: зберігаються найновіші в кожній групі, старі автоматично видаляються після кожного успішного резервного копіювання:

Причина Зберігається за замовчуванням
за розкладом 10
перед оновленням 10
вручну 20
перед відновленням 5

перед відновленням (на панелі називаються резервними копіями безпеки) має власний невеликий буфер саме для того, щоб автоматична резервна копія безпеки ніколи не могла витіснити вручну резервну копію, яку ви свідомо зберегли.

Два необов’язкові обмеження застосовуються поверх кількості на причину, обидва вимкнені за замовчуванням: максимальний вік (резервні копії старші за N днів видаляються, незалежно від причини) та максимальний загальний розмір на сервер (найстаріші видаляються, доки загальний розмір не вміститься: спочатку резервні копії безпеки, потім за розкладом, потім решта). Найновіша резервна копія сервера ніколи не видаляється жодним із цих обмежень.

Адміністратори встановлюють загальну політику панелі в картці Зберігання резервних копій на сторінці Налаштування (Заповнити вбудовані повертає значення за замовчуванням вище у форму, готові до збереження). Сервер може відрізнятися за будь-яким із шести значень: відкрийте його вкладку Резервні копії та розгорніть Зберігання для цього сервера. Кожне поле там порожнє, якщо цей сервер його не встановив, а порожнє поле дотримується загального значення панелі (відображається всередині нього). Таким чином, сервер може, наприклад, зберігати 3 резервні копії за розкладом і використовувати загальні значення панелі для всього іншого; очищення поля повертає його до загального значення панелі.

Картка Зберігання резервних копій у Налаштуваннях

Зберігання для цього сервера на вкладці Резервні копії сервера

Збереження саме по собі нічого не видаляє. Якщо нові ліміти призведуть до перевищення існуючих резервних копій, панель покаже для кожного сервера, скільки резервних копій кожного типу буде видалено, скільки місця це звільнить і скільки років найстарішій. Вона також вказує, коли сервер вже перевищував свої ліміти до цієї зміни (наприклад, після попереднього З наступного резервного копіювання), оскільки застосування зараз обрізає все, що перевищує ліміт, а не лише те, що додає ця правка. Потім запитує, як їх застосувати:

  • Видалити зараз видаляє саме ті резервні копії, які щойно були перелічені, і нічого більше: резервна копія, зроблена в проміжку, чекає на наступне обрізання. На сторінці налаштувань сервер, який перебуває в середині процесу відновлення, резервного копіювання або подібної дії, пропускається і обрізається після наступного резервного копіювання; на власній вкладці резервних копій сервера вам буде запропоновано спробувати знову, коли ця дія завершиться. Поки старі резервні копії сервера видаляються (зазвичай секунди), інші дії на цьому сервері повинні чекати: заплановане резервне копіювання або запуск, що припадає на цей час, повторюється щохвилини, доки не зможе (до 30 хвилин), збійний сервер перезапускається приблизно через 20 секунд після завершення (до 30 хвилин), а заплановане перезавантаження або зупинка, що збігається з ним, пропускається до наступного разу.
  • З наступного резервного копіювання зберігає їх наразі; кожен сервер обрізає свої резервні копії під час наступного створення, як це завжди було.

Діалогове вікно зі списком того, що видалять нові ліміти

Резервна копія, яка відновлюється, ніколи не видаляється під час виконання відновлення: зберігання залишає її в спокої (і не видаляє інші резервні копії, щоб звільнити для неї місце), а видалення вручну забороняється до завершення відновлення.

Ті самі налаштування доступні для скриптів як кінцеві точки адміністративного API: GET/POST /api/backups/retention та /api/servers/:id/backups/retention. Загальні значення панелі не можуть бути null. Для сервера значення null (або "") видаляє цей ключ, щоб він знову дотримувався загального значення панелі, а { "reset": true } видаляє їх усі. Під кожним із цих двох шляхів POST …/preview повідомляє, що зміна видалить, не видаляючи (backups, bytes, servers, ids та розбивка byServer по серверах), а POST …/apply застосовує збережену політику зараз і відповідає { deleted, skipped } для всієї панелі (skipped підраховує зайняті сервери) або { deleted } для одного сервера. Надішліть { "token": "..." } з попереднього перегляду (зберігається 10 хвилин) або його { "ids": [...] }, щоб видалити лише їх; без жодного з них видаляється все, що перевищує ліміт. Застосування для одного сервера на зайнятому сервері відповідає 409.

Резервні копії можна перейменувати зі списку резервних копій (кнопка перейменування в кожному рядку). Архів на диску та запис панелі переміщуються разом, тому завантаження, відновлення та зберігання продовжують працювати з новою назвою.

Перейменування резервної копії

Зберігання автоматично обмежено, але великі модифіковані архіви все ще враховуються в квоті дискового простору сервера, тому стежте за загальним обсягом для великих пакетів.

Відновлення резервної копії зупиняє сервер (перевіряючи, чи контейнер дійсно зупинився, перш ніж торкатися будь-яких файлів), створює резервну копію безпеки перед відновленням, замінює весь каталог сервера знімком і залишає його зупиненим, щоб ви могли запустити його знову. Архів розпаковується спочатку збоку і вставляється лише після повного розпакування, тому відновлення, яке зазнає невдачі на півдорозі, залишає поточні файли недоторканими. Оскільки оновлення пакетів завжди спочатку створюють резервну копію перед оновленням, ви завжди можете скасувати невдале оновлення.

Власна база даних панелі

Section titled “Власна база даних панелі”

Резервні копії сервера охоплюють лише власну папку кожного сервера. Власна база даних панелі (panel.db, що містить користувачів, ролі, секрети 2FA, розклади, закріплення пакетів та історію) знімається окремо під час щоденного таймера обслуговування:

  • VACUUM INTO записує послідовну, дефрагментовану копію до backups/_panel/ у папці даних; зберігаються найновіші 14.
  • Під час завантаження панель виконує PRAGMA integrity_check і голосно логує, якщо вона не вдається, вказуючи вам на backups/_panel для найновішої робочої копії.

Якщо ви зробите резервну копію всієї папки даних (вона також містить .secret-key, ключ шифрування в стані спокою), ви зробите резервну копію всього.