1. Главная
  2. Хаб
  3. Сценарии
  4. Снимки и резервные копии дисков по расписанию: консоль, CLI и cron

Сценарий 37

Снимки и резервные копии дисков по расписанию: консоль, CLI и cron

Делаем снимок диска сервера и резервную копию из него сначала вручную, затем ставим то же самое в расписание через API-ключ и CLI h3: каждую ночь снимок, раз в неделю копия, старые удаляются сами. В конце восстанавливаем данные в новый диск и проверяем, что копия рабочая.

35 минСредний5 шагов Серверы, Диски, Terraform обновлено

Содержание
  1. 01Сделайте снимок и резервную копию вручную
  2. 02Создайте API-ключ для расписания и настройте CLI
  3. 03Напишите скрипт: снимок, копия, ротация
  4. 04Поставьте скрипт в расписание
  5. 05Восстановите данные в новый диск
  6. Проверка результата
  7. Как удалить ресурсы
  8. Типичные ошибки
  9. Сколько стоит

Что получится

Ночной снимок диска сервера и еженедельная резервная копия из него в отдельном хранилище, ротация (последние 7 снимков и 4 копии), журнал запусков и проверенное восстановление в новый диск.

Что понадобится

  • Сервер с диском, который нужно защищать, — например, из сценария «Сайт на облачном сервере».
  • Машина, откуда будет запускаться расписание: отдельный небольшой сервер, CI-раннер или ваш компьютер с Linux/macOS. На ней нужны jq и CLI h3.
  1. Шаг 1. Сделайте снимок и резервную копию вручную

    Снимок — мгновенная копия диска рядом с ним. Резервная копия делается из снимка и хранится в отдельном долгосрочном хранилище, не там, где лежат диски. Нужны оба: снимок быстро откатывает ошибку, копия переживает потерю диска и снимков.

    Консоль

    1. В меню проекта откройте Диски, у диска сервера нажмите «…» → Снепшот диска.
    2. В окне «Создать снепшот диска» в поле Имя снимка введите manual-1 и нажмите Создать снепшот.
    3. Откройте Бэкапы и снимки. У снимка manual-1 нажмите «…» → Создать резервную копию, Имя резервной копии — manual-1, затем Создать резервную копию.

    CLI

    Терминал
    h3 disk list                                   # найдите ID диска
    h3 disk snapshot create --disk-id <ID диска> --name manual-1
    h3 disk snapshot list                          # дождитесь статуса READY
    h3 backup create --snapshot-id <ID снимка> --name manual-1

    Terraform

    Terraform
    resource "h3_snapshot" "manual" {
      project_id = var.project_id
      disk_id    = var.disk_id   # ID диска из консоли или `h3 disk list`
      name       = "manual-1"
    }
    
    # копия в отдельном хранилище; apply ждёт статуса READY до 60 минут
    resource "h3_backup" "manual" {
      project_id  = var.project_id
      snapshot_id = h3_snapshot.manual.id
      name        = "manual-1"
    }

    Проверка

    В Бэкапы и снимки две строки manual-1: тип «Снепшот» и «Бэкап», в колонке «Источник» — ваш диск. Копия сначала в статусе загрузки, потом готова.

    Если не получилось

    • Снимок мгновенный и согласован так же, как диск после внезапного выключения. Для базы данных на сервере делайте ещё и дамп (pg_dump, mysqldump) — например, по сценарию «Резервные копии в S3».
    • Резервная копия создаётся только из готового снимка: пока снимок создаётся, пункт копии вернёт ошибку.
  2. Шаг 2. Создайте API-ключ для расписания и настройте CLI

    Расписание будет работать без вас, поэтому ему нужен свой ключ: отдельный, только на этот проект и с ограниченным сроком. Так его легко отозвать, не задев Terraform и другие инструменты.

    Консоль

    1. Внизу левой панели нажмите значок ключа «API и SSH ключи» и откройте вкладку API-ключи.
    2. Нажмите Добавить ключ → Добавить API-ключ. Имя ключа disk-snapshots, Проекты — только проект с сервером, Срок действия — «Год».
    3. Нажмите Создать API ключ и скопируйте секретный ключ (h3_...): он показывается один раз. ID ключа — в списке ключей, ID проекта — на странице «Обзор проекта».
    На машине с расписанием
    curl -fsSL https://h3llo.cloud/cli/install.sh | sh
    sudo apt install -y jq            # macOS: brew install jq
    h3 init
    h3 config set key_id <ID ключа>
    h3 config set secret_key <секретный ключ h3_...>
    h3 config set project_id <ID проекта>

    Проверка

    CLI видит диски проекта:

    Терминал
    h3 disk list

    Если не получилось

    • Ключ, созданный в консоли, даёт полный доступ к выбранным проектам. Поэтому заведите отдельный ключ на один проект со сроком не больше года; конфиг ~/.h3/config.yaml должен быть доступен только владельцу (chmod 600).
  3. Шаг 3. Напишите скрипт: снимок, копия, ротация

    Встроенного расписания и автоудаления копий у дисков нет, поэтому всё делает скрипт: снимает диск, ждёт готовности, отправляет снимок в резервную копию и удаляет старые снимки и копии с префиксом nightly-. Ручные снимки с другими именами он не трогает.

    /usr/local/bin/disk-snapshot.sh
    #!/usr/bin/env bash
    # Ночной снимок диска h3llo.cloud + резервная копия, хранение: 7 снимков и 4 копии.
    set -euo pipefail
    DISK_ID="${1:?usage: disk-snapshot.sh <disk-id>}"
    KEEP_SNAPSHOTS=7
    KEEP_BACKUPS=4
    NAME="nightly-$(date +%F-%H%M)"
    
    SNAP_ID="$(h3 disk snapshot create --disk-id "$DISK_ID" --name "$NAME" -o json | jq -r .id)"
    for i in $(seq 1 60); do                       # до 30 минут
      STATUS="$(h3 disk snapshot get "$SNAP_ID" -o json | jq -r .status)"
      [ "$STATUS" = READY ] && break
      [ "$STATUS" = FAILED ] && { echo "snapshot $SNAP_ID failed" >&2; exit 1; }
      sleep 30
    done
    [ "$STATUS" = READY ] || { echo "snapshot $SNAP_ID not ready" >&2; exit 1; }
    
    # копия в отдельное хранилище раз в неделю, по воскресеньям
    if [ "$(date +%u)" = 7 ]; then
      h3 backup create --snapshot-id "$SNAP_ID" --name "$NAME" -o json | jq -r '"backup " + .id'
    fi
    
    # ротация: самые старые nightly-* этого диска сверх лимита
    h3 disk snapshot list -o json \
      | jq -r --arg d "$DISK_ID" --argjson k "$KEEP_SNAPSHOTS" \
        '[.[] | select(.disk_id == $d and (.name | startswith("nightly-")))] | sort_by(.created_at) | .[:-$k][]? | .id' \
      | xargs -r -n1 h3 disk snapshot delete
    h3 backup list -o json \
      | jq -r --arg d "$DISK_ID" --argjson k "$KEEP_BACKUPS" \
        '[.[] | select(.disk_id == $d and (.name | startswith("nightly-")))] | sort_by(.created_at) | .[:-$k][]? | .id' \
      | xargs -r -n1 h3 backup delete
    echo "$(date -Is) ok: $NAME ($SNAP_ID)"
    Установка и первый запуск
    sudo nano /usr/local/bin/disk-snapshot.sh      # вставьте скрипт выше
    sudo chmod 755 /usr/local/bin/disk-snapshot.sh
    disk-snapshot.sh <ID диска>

    Проверка

    Скрипт печатает ok и имя снимка, а в Бэкапы и снимки появился снимок nightly-<дата>:

    Терминал
    h3 disk snapshot list -o json | jq -r '.[] | select(.name | startswith("nightly-")) | .name + "  " + .status'

    Если не получилось

    • validation failed на создании снимка — у старых машин ID загрузочного диска оканчивается на -root и не проходит проверку API. Для такого диска делайте снимок в консоли или пересоздайте машину из снимка — у новой ID будет обычным.
    • Скрипт — пример: проверьте его на тестовом диске, прежде чем доверять ему удаление.
  4. Шаг 4. Поставьте скрипт в расписание

    cron

    Терминал
    # каждую ночь в 02:15 по времени машины, журнал — в домашнем каталоге
    ( crontab -l 2>/dev/null; echo '15 2 * * * /usr/local/bin/disk-snapshot.sh <ID диска> >> $HOME/disk-snapshot.log 2>&1' ) | crontab -
    crontab -l

    GitLab CI

    Терминал
    # .gitlab-ci.yml: задание для расписания CI/CD → Schedules.
    # H3_KEY_ID, H3_SECRET_KEY, H3_PROJECT_ID — замаскированные переменные CI, файл конфига не нужен.
    disk-snapshot:
      image: debian:12
      rules: [{if: '$CI_PIPELINE_SOURCE == "schedule"'}]
      script:
        - apt-get update && apt-get install -y curl jq
        - curl -fsSL https://h3llo.cloud/cli/install.sh | sh
        - bash ./disk-snapshot.sh "$DISK_ID"

    Проверка

    Утром в журнале — строка ok, а снимков nightly-* не больше семи:

    Терминал
    tail -n 5 ~/disk-snapshot.log
  5. Шаг 5. Восстановите данные в новый диск

    Восстановление никогда не перезаписывает исходный диск: из снимка или копии всегда создаётся новый диск. Его можно подключить к серверу рядом со старым и забрать нужные файлы — или сразу создать из снимка новую машину.

    Консоль

    1. Бэкапы и снимки → у снимка nightly-... нажмите «…» → Восстановить диск. В окне «Восстановить диск из снимка» Имя нового диска — data-restored, нажмите Восстановить. Для резервной копии тот же пункт Восстановить диск открывает окно «Восстановить диск из резервной копии».
    2. Диски → у диска data-restored «…» → Подключить к инстансу → ваш сервер.
    3. Целую машину из снимка загрузочного диска: Инстансы → Создать → ОС → вкладка Мои снепшоты (из копии — вкладка Бекапы).

    CLI

    Терминал
    h3 api POST /api/disks/v1/snapshots/<ID снимка>/restore \
      -d '{"new_disk_name": "data-restored", "project_id": "<ID проекта>"}'
    h3 disk restores                               # статус восстановления
    h3 disk attach <ID нового диска> <ID сервера>
    На сервере
    lsblk                                          # новый диск, например /dev/vdc
    sudo mkdir -p /mnt/restored
    sudo mount -o ro /dev/vdc1 /mnt/restored 2>/dev/null || sudo mount -o ro /dev/vdc /mnt/restored
    ls -la /mnt/restored

    Проверка

    В /mnt/restored — файлы на момент снимка. Нужное скопируйте обратно, затем отмонтируйте диск: sudo umount /mnt/restored.

    Если не получилось

    • Не форматируйте восстановленный диск командой из инструкции по новому диску — mkfs сотрёт восстановленные данные.

Проверка результата

В Бэкапы и снимки каждую ночь появляется снимок nightly-*, по воскресеньям — резервная копия, а число снимков не растёт больше семи. Раз в месяц повторяйте шаг 5 на свежей копии.

Терминал
h3 backup list -o json | jq -r '.[] | .name + "  " + .status'

Как удалить ресурсы

Снимки и копии оплачиваются, пока существуют. Удаление снимка не удаляет копию, сделанную из него, и наоборот.

CLI

Терминал
h3 disk snapshot list -o json | jq -r '.[] | select(.name | startswith("nightly-")) | .id' | xargs -r -n1 h3 disk snapshot delete
h3 backup list -o json | jq -r '.[] | select(.name | startswith("nightly-")) | .id' | xargs -r -n1 h3 backup delete
  1. Уберите задание из cron: crontab -l | grep -v disk-snapshot | crontab - (или удалите расписание в GitLab).
  2. Диски → data-restored → «…» → Отключить от инстанса, затем Удалить.
  3. Бэкапы и снимки → ненужные снимки «…» → Удалить снепшот, копии — Удалить резервную копию.
  4. Удалите API-ключ disk-snapshots на вкладке API-ключи: он перестанет работать сразу.

Типичные ошибки

Можно ли откатить сам диск к снимку, без нового диска?

Нет: восстановление всегда создаёт новый диск, исходный не меняется. Это защищает от отката не того диска. Чтобы заменить загрузочный диск, создайте машину из снимка (вкладка «Мои снепшоты»).

Чем копия отличается от снимка?

Снимок лежит рядом с диском и создаётся мгновенно. Резервная копия загружается из снимка в отдельное долгосрочное хранилище: дольше, зато переживает потерю диска и его снимков. Держите несколько свежих снимков и реже — копии.

Снимок работающей базы данных — это бэкап базы?

Только как после аварийного выключения: PostgreSQL переживёт это, но надёжнее дамп или управляемая база с PITR — см. Managed PostgreSQL.

А с Terraform?

Ресурсы `h3_snapshot` и `h3_backup` подходят для разовых снимков «перед обновлением»: любое изменение аргументов создаёт новый снимок. Для ежедневной ротации удобнее скрипт из шага 3.

Связанные продукты и материалы

Сколько стоит

≈ 0,40 ₽ в час · 288 ₽ в месяц при работе 24/7

Новый диск при проверке восстановления, до 20 000 IOPS*, ГБ20 × 14,40 ₽

Снимок оплачивается по цене класса диска за полный размер диска. Хранение резервных копий до 12 декабря 2026 г. не тарифицируется, после — по цене хранения в S3 за фактический объём; цены — в тарифах. Диск из шага проверки удалите после неё, и он обойдётся в рубли. API и CLI бесплатны.

Цены из прайс-листа, по которому работает биллинг; списание поминутное, месяц — 720 часов. Если удалить ресурсы после проверки, сценарий обойдётся в рубли.

Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.

* IOPS растут с объёмом диска; точные значения для вашего объёма видны в консоли при выборе.