Бекапи
Бекап — це копія одного блокового тому на певний момент часу одного з двох типів: snapshot, який сервіс блокового сховища зберігає поряд із томом, або backup — окрема повна копія. Ви створюєте їх на вимогу або їх створює для вас розклад.
Бекапи чи снапшоти
І те, і інше — копії на певний момент часу; різняться вони тим, як працюють:
type: snapshot | type: backup | |
|---|---|---|
| Що це | Снапшот, що зберігається разом із томом | Окрема повна копія, яку можна надіслати ще й у ваше власне сховище |
| Створюється | Прямим викликом або розкладом | Прямим викликом або розкладом |
| Відновлюється через | POST /api/v1/backup_restore/volume_backups/snapshot_restore | POST /api/v1/backup_restore/volume_backups/backup_restore |
Снапшот належить своєму тому: видалення тому з cascade: true (DELETE /api/v1/storage/) видаляє і його снапшоти.
Створення копії
POST /api/v1/backup_restore/volume_backups/create_backup одразу копіює том. Укажіть volume_id і type (snapshot або backup), а також, за бажанням, name, description і permanent. Для backup параметр storage_ids додатково надсилає копію в підключення до зовнішніх сховищ, які ви налаштували через POST /api/v1/external/connections/.
Виклик ставить роботу в чергу й одразу відповідає — або відповідає 409, якщо копія не вміститься у вашу квоту на бекапи. GET /api/v1/backup_restore/volume_backups/ перелічує ваші копії з фільтрами backup_types і statuses, а також limit (за замовчуванням 10) і offset. status копії — це pending, in_progress, completed або failed.
Копії за розкладом
Розклад створює копії за вас. Створіть його через POST /api/v1/backup_restore/backup_scheduler/, указавши frequency і backup_quantity, а потім привʼяжіть до кожного тому через POST /api/v1/backup_restore/volume_scheduler/, указавши volume_id, schedule_id і type. Подробиці — на сторінці Заплановані бекапи.
Зберігання копій
Розклад зберігає backup_quantity найновіших копій (за замовчуванням 5) кожного привʼязаного до нього тому й видаляє старіші, коли зʼявляються нові; outside_backup_quantity (за замовчуванням 1) робить те саме для копій у кожному зовнішньому сховищі. Копії, створені на вимогу, зберігаються, доки ви їх не видалите.
Щоб вивести копію з цієї ротації, задайте для неї permanent: true — під час створення або пізніше через PATCH /api/v1/backup_restore/volume_backups/{volume_backup_id}.
Видаліть одну копію через DELETE /api/v1/backup_restore/volume_backups/single/{volume_backup_id} або кілька — через DELETE /api/v1/backup_restore/volume_backups/bulk, передавши їхні ідентифікатори в параметрі запиту backup_ids.
Відновлення
Відновіть снапшот через POST /api/v1/backup_restore/volume_backups/snapshot_restore, а бекап — через POST /api/v1/backup_restore/volume_backups/backup_restore. Обидва приймають {"backup_id": "…"}, ставлять роботу в чергу й одразу відповідають. Копія має бути в стані completed і того типу, який обслуговує ендпоінт; інакше виклик відповідає 409.
Відновлення відбувається на місці. Воно створює з копії новий том такого самого розміру й у тій самій зоні доступності, що й оригінал, і ставить його на місце оригіналу:
- Том даних відʼєднується від своєї VM, а відновлений том підʼєднується на його місце.
- Для завантажувального тому VM її перебудовують на відновленому диску. Нова VM переймає порти й плаваючі IP старої, а стару VM видаляють. VM отримує новий
id; відновлений диск зберігає SSH-ключі, які на ньому були.
Копії й привʼязки до розкладів вихідного тому переходять до відновленого тому.
Що далі
- Заплановані бекапи — створення копій за розкладом.
- Блокове сховище — томи, з яких створюються ці копії.
- Віртуальні машини — те, що перебудовує відновлення завантажувального тому.