diff options
| author | SixOnMyface <[email protected]> | 2026-06-29 07:58:20 +0300 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-06-29 07:58:20 +0300 |
| commit | e0a46902292e7fafd03dec4ec492a65ebb2fee07 (patch) | |
| tree | 040b66f221d7c0d939307e1802d77bab109a7c82 | |
| parent | 742e66c489bc07327d1133aec34e34c6fbd42be5 (diff) | |
YDBDOCS2114-BACKUP REPLACING (#43672)
Co-authored-by: Stepan Beloyarov <[email protected]>
Co-authored-by: sintjuri <[email protected]>
| -rw-r--r-- | ydb/docs/redirects.yaml | 4 | ||||
| -rw-r--r-- | ydb/docs/ru/core/concepts/backup.md | 46 | ||||
| -rw-r--r-- | ydb/docs/ru/core/devops/_includes/backup_and_recovery/options_overlay.md | 1 | ||||
| -rw-r--r-- | ydb/docs/ru/core/devops/backup-and-recovery/index.md | 19 | ||||
| -rw-r--r-- | ydb/docs/ru/core/devops/backup-and-recovery/toc_p.yaml | 3 | ||||
| -rw-r--r-- | ydb/docs/ru/core/devops/toc_p.yaml | 3 | ||||
| -rw-r--r-- | ydb/docs/ru/core/recipes/system-tablet-backup/enabling-backup.md | 41 | ||||
| -rw-r--r-- | ydb/docs/ru/core/recipes/system-tablet-backup/index.md | 14 | ||||
| -rw-r--r-- | ydb/docs/ru/core/recipes/system-tablet-backup/recovery.md (renamed from ydb/docs/ru/core/devops/backup-and-recovery/system-tablet-backup.md) | 95 | ||||
| -rw-r--r-- | ydb/docs/ru/core/recipes/system-tablet-backup/toc_p.yaml | 5 | ||||
| -rw-r--r-- | ydb/docs/ru/core/recipes/toc_p.yaml | 5 | ||||
| -rw-r--r-- | ydb/docs/ru/core/reference/configuration/system_tablet_backup_config.md | 2 | ||||
| -rw-r--r-- | ydb/docs/ru/core/reference/ydb-cli/export-import/toc_i.yaml | 2 |
13 files changed, 144 insertions, 96 deletions
diff --git a/ydb/docs/redirects.yaml b/ydb/docs/redirects.yaml index fbc3e8d1ab7..7aefb7f3353 100644 --- a/ydb/docs/redirects.yaml +++ b/ydb/docs/redirects.yaml @@ -513,6 +513,8 @@ ru: to: /devops/configuration-management/configuration-v1/cluster-expansion.md - from: /concepts/topic.md to: /concepts/datamodel/topic.md + - from: /devops/backup-and-recovery/system-tablet-backup.md + to: /concepts/backup.md#system-tablet-backup - from: /reference/ydb-sdk/recipes/debug.md to: /reference/ydb-sdk/observability/index.md - from: /reference/ydb-sdk/recipes/debug-logs.md @@ -534,7 +536,7 @@ ru: - from: /recipes/ydb-sdk/debug-jaeger.md to: /reference/ydb-sdk/observability/tracing/jaeger.md - from: /recipes/ydb-sdk/debug-otel-tracing.md - to: /reference/ydb-sdk/observability/tracing/opentelemetry.md + to: /reference/ydb-sdk/observability/tracing/opentelemetry.md
en: - from: /reference/ydb-sdk/recipes/debug-jaeger.md diff --git a/ydb/docs/ru/core/concepts/backup.md b/ydb/docs/ru/core/concepts/backup.md index 0fd414702ce..22738b28755 100644 --- a/ydb/docs/ru/core/concepts/backup.md +++ b/ydb/docs/ru/core/concepts/backup.md @@ -61,6 +61,49 @@ {% endnote %} +## Резервное копирование системных таблеток {#system-tablet-backup} + +{% note info %} + +На текущий момент поддерживается резервное копирование только кластерных системных таблеток. Резервное копирование системных таблеток баз данных не поддерживается. + +{% endnote %} + +Механизм резервного копирования системных таблеток обеспечивает инкрементальное копирование метаданных кластера — таких как [Hive](glossary.md#hive), [BSController](glossary.md#ds-controller) и [SchemeShard](glossary.md#scheme-shard) — на локальную файловую систему хостов кластера. + +Этот механизм используют для восстановления метаданных кластера, когда [восстановление из резервных копий баз данных](#full-backup) технически возможно, но не подходит по времени или объёму работ. Типичный сценарий — совокупный объём баз данных в кластере велик из‑за их количества, размера отдельных баз или сочетания обоих факторов; полный `import/restore` всех данных в новый кластер в таком случае приводит к длительному простою. В этом сценарии можно восстановить системные таблетки и вернуть кластер к работоспособному состоянию, не выполняя массовое восстановление пользовательских данных на новом кластере. + +Если объём баз данных позволяет выполнить штатное восстановление, используйте в первую очередь [export/import](#s3) или [dump/restore](#dump). Резервное копирование системных таблеток следует применять как специальный механизм для ситуаций, когда нужно восстановить именно метаданные кластера и сократить объём восстановительных операций. + +{% note info %} + +Практические инструкции по включению и восстановлению см. в [рецептах для резервного копирования системных таблеток](../recipes/system-tablet-backup/index.md). + +{% endnote %} + +{% note warning %} + +Резервные копии разных системных таблеток создаются независимо друг от друга и не согласованы между собой. После восстановления состояние таблеток может оказаться несогласованным, что может негативно влиять на работу кластера. + +{% endnote %} + +### Принцип работы {#system-tablet-backup-how-it-works} + +Резервное копирование состоит из двух компонентов: + +- **Снимок состояния (snapshot)** — при каждом запуске таблетка сканирует все свои таблицы и записывает свое полное состояние в резервную копию, включая схему данных. Сканирование выполняется на основе снимка состояния и не блокирует работу таблетки. +- **Журнал изменений (changelog)** — при каждом изменении данных или схемы таблетка асинхронно записывает изменение в журнал параллельно с записью в распределённое хранилище. Когда размер журнала превышает размер снимка состояния, таблетка автоматически делает новый снимок. + +{% note warning %} + +Из-за асинхронной записи возможна потеря последних изменений, не успевших попасть в резервную копию до момента сбоя. + +{% endnote %} + +Резервные копии создаются **локально на хосте, где в данный момент работает таблетка**. Поэтому наиболее актуальная копия находится на том хосте, где таблетка работала непосредственно перед сбоем. + +Количество хранимых резервных копий на хосте ограничено в [конфигурации](../reference/configuration/system_tablet_backup_config.md). После успешного снятия снапшота самая старая копия автоматически удаляется при превышении лимита. Незавершённые копии (без полностью записанного снапшота) удаляются при создании новой резервной копии. + ## Сравнение подходов {#comparison} #| @@ -69,11 +112,14 @@ || [Дамп в файловую систему](#dump) | Файловая система | Нет | Разработка, тестирование, небольшие БД || || [Экспорт в S3-совместимое хранилище](#s3) | S3-совместимое хранилище | Нет | Аварийное восстановление, миграция, архивирование || || [Инкрементальное резервное копирование](#incremental-backup) | В кластере ([экспортируются](datamodel/backup-collection.md#external-storage) в S3 или файловую систему) | Да | Регулярные бэкапы больших производственных БД || +|| [Резервное копирование системных таблеток](#system-tablet-backup) | Локальная ФС хостов кластера | Да | Восстановление метаданных кластера в аварийных ситуациях || |# ## См. также +- [Резервное копирование и восстановление](../devops/backup-and-recovery/index.md) — практическое руководство - [Коллекции резервных копий](datamodel/backup-collection.md) — архитектура и ограничения +- [Рецепты для резервного копирования системных таблеток](../recipes/system-tablet-backup/index.md) — включение и восстановление - [Резервное копирование и восстановление](../devops/backup-and-recovery/index.md) — практическое руководство - [Справочник export/import](../reference/ydb-cli/export-import/index.md) — команды CLI - Справочник YQL: diff --git a/ydb/docs/ru/core/devops/_includes/backup_and_recovery/options_overlay.md b/ydb/docs/ru/core/devops/_includes/backup_and_recovery/options_overlay.md index eeaa4f6ebe0..470236af614 100644 --- a/ydb/docs/ru/core/devops/_includes/backup_and_recovery/options_overlay.md +++ b/ydb/docs/ru/core/devops/_includes/backup_and_recovery/options_overlay.md @@ -1,2 +1,3 @@ * Резервное копирование в файлы и восстановление с помощью {{ ydb-short-name }} CLI. * Резервное копирование в S3-совместимое хранилище и восстановление с помощью {{ ydb-short-name }} CLI. +* Резервное копирование системных таблеток на локальную файловую систему хостов кластера.
diff --git a/ydb/docs/ru/core/devops/backup-and-recovery/index.md b/ydb/docs/ru/core/devops/backup-and-recovery/index.md index 49e77a83ebf..f791106f739 100644 --- a/ydb/docs/ru/core/devops/backup-and-recovery/index.md +++ b/ydb/docs/ru/core/devops/backup-and-recovery/index.md @@ -48,16 +48,25 @@ {% endnote %} +## Коллекции резервных копий {#backup-collections} + +Коллекции резервных копий обеспечивают инкрементальное резервное копирование и восстановление на момент времени для производственных нагрузок. Концептуальную информацию и детали архитектуры см. в [Коллекциях резервных копий](../../concepts/datamodel/backup-collection.md). + +Коллекции резервных копий рекомендуются для производственных сред с регулярным расписанием резервного копирования и больших наборов данных, где инкрементальные изменения значительно меньше общего объёма. Для более простых сценариев (разовые миграции, среды разработки, небольшие базы данных) рассмотрите использование [export/import](#s3) или [dump/restore](#files). + +Пошаговые инструкции по настройке и использованию коллекций резервных копий см. в: + +- [Коллекциях резервных копий](../../concepts/datamodel/backup-collection.md) — архитектура, концепции и ограничения +- [Рецептах для коллекций резервных копий](../../recipes/backup-collections/index.md) — типовые сценарии и примеры + {% include [_includes/backup_and_recovery/cli_overlay.md](../_includes/backup_and_recovery/cli_overlay.md) %} {% include [_includes/backup_and_recovery/others_overlay.md](../_includes/backup_and_recovery/others_overlay.md) %} ## Резервное копирование системных таблеток {#system-tablet-backup} -Механизм резервного копирования системных таблеток, таких как [Hive](../../concepts/glossary.md#hive), [BSController](../../concepts/glossary.md#ds-controller) и [SchemeShard](../../concepts/glossary.md#scheme-shard), обеспечивает инкрементальное копирование метаданных кластера на локальную файловую систему кластера. - -Этот механизм предназначен для восстановления метаданных кластера, когда другие способы восстановления недоступны — например, резервная копия базы данных отсутствует или объём базы данных слишком велик для восстановления из резервной копии за приемлемое время. Механизм позволяет восстановить метаданные в существующем кластере без необходимости пересоздавать кластер и восстанавливать базы данных из резервных копий. +Механизм резервного копирования системных таблеток обеспечивает инкрементальное копирование метаданных кластера на локальную файловую систему хостов кластера. -Если есть возможность восстановить кластер с помощью команд [export/import](#s3) или [dump/restore](#files), рекомендуется использовать эти способы. +Концептуальную информацию и принцип работы см. в [Концепциях резервного копирования](../../concepts/backup.md#system-tablet-backup). -Подробная информация, включая руководство по восстановлению, доступна в разделе [{#T}](./system-tablet-backup.md). +Пошаговые инструкции по включению и восстановлению см. в [Рецептах для резервного копирования системных таблеток](../../recipes/system-tablet-backup/index.md). diff --git a/ydb/docs/ru/core/devops/backup-and-recovery/toc_p.yaml b/ydb/docs/ru/core/devops/backup-and-recovery/toc_p.yaml deleted file mode 100644 index 617e900ce4a..00000000000 --- a/ydb/docs/ru/core/devops/backup-and-recovery/toc_p.yaml +++ /dev/null @@ -1,3 +0,0 @@ -items: -- name: Резервное копирование системных таблеток - href: system-tablet-backup.md diff --git a/ydb/docs/ru/core/devops/toc_p.yaml b/ydb/docs/ru/core/devops/toc_p.yaml index d247fdc3a67..7067830d8a7 100644 --- a/ydb/docs/ru/core/devops/toc_p.yaml +++ b/ydb/docs/ru/core/devops/toc_p.yaml @@ -26,6 +26,3 @@ items: path: observability/toc_p.yaml - name: Резервное копирование и восстановление href: backup-and-recovery/index.md - include: - mode: link - path: backup-and-recovery/toc_p.yaml diff --git a/ydb/docs/ru/core/recipes/system-tablet-backup/enabling-backup.md b/ydb/docs/ru/core/recipes/system-tablet-backup/enabling-backup.md new file mode 100644 index 00000000000..188bee0285d --- /dev/null +++ b/ydb/docs/ru/core/recipes/system-tablet-backup/enabling-backup.md @@ -0,0 +1,41 @@ +# Включение и настройка резервного копирования системных таблеток {#enabling-backup} + +{% note info %} + +Концептуальную информацию о механизме см. в разделе [Резервное копирование системных таблеток](../../concepts/backup.md#system-tablet-backup). + +{% endnote %} + +{% note warning %} + +В качестве хранилища резервных копий поддерживаются только локальные файловые системы. Сетевые файловые системы, такие как NFS, не поддерживаются и могут привести к повреждению резервных копий или сбоям в работе таблеток. + +{% endnote %} + +По умолчанию резервное копирование системных таблеток **выключено**, так как требует настройки хранилища. Узлы {{ ydb-short-name }} обычно не используют локальную файловую систему, поэтому включение требует осознанного решения администратора. + +Для включения добавьте секцию `system_tablet_backup_config` в [конфигурацию кластера](../../reference/configuration/index.md): + +```yaml +system_tablet_backup_config: + filesystem: + path: "/path/to/backup/directory" +``` + +Параметр `path` — абсолютный путь к директории на локальной файловой системе хоста для хранения резервных копий. + +{% note warning %} + +Директория для резервных копий должна быть доступна для записи процессом {{ ydb-short-name }} на каждом хосте, где работают системные таблетки. Убедитесь, что на диске каждого хоста достаточно свободного места для хранения нескольких резервных копий всех системных таблеток. Для крупных рабочих сред, состоящих из десятков узлов хранения, рекомендуется как минимум 5 ГБ. + +{% endnote %} + +После изменения конфигурации перезапустите узлы кластера, на которых могут работать системные таблетки. Резервное копирование начнётся автоматически. + +{% note warning %} + +По умолчанию системные таблетки могут работать на любых статических узлах кластера, в том числе на тех, диски которых входят в [статическую группу](../../concepts/glossary.md#static-group). Резервные копии хранятся локально на хостах, где работают системные таблетки. Это означает, что при потере хостов статической группы могут быть потеряны и резервные копии, которые могут потребоваться для восстановления статической группы. + +Рекомендуется настроить секцию `bootstrap_config` в [конфигурации кластера](../../reference/configuration/index.md) так, чтобы системные таблетки запускались на узлах, не входящих в статическую группу. В этом случае резервные копии будут храниться отдельно от данных статической группы. + +{% endnote %} diff --git a/ydb/docs/ru/core/recipes/system-tablet-backup/index.md b/ydb/docs/ru/core/recipes/system-tablet-backup/index.md new file mode 100644 index 00000000000..5d1df2aea0b --- /dev/null +++ b/ydb/docs/ru/core/recipes/system-tablet-backup/index.md @@ -0,0 +1,14 @@ +# Рецепты для резервного копирования системных таблеток + +Пошаговые руководства по включению резервного копирования системных таблеток и их восстановлению. + +## Включение и восстановление + +- [Включение и настройка резервного копирования](enabling-backup.md) — настройка `system_tablet_backup_config` и подготовка хранилища; +- [Восстановление системных таблеток](recovery.md) — перевод в Recovery-режим и восстановление из локальной резервной копии. + +## См. также + +- [Резервное копирование системных таблеток](../../concepts/backup.md#system-tablet-backup) — концепции и принцип работы +- [Резервное копирование и восстановление](../../devops/backup-and-recovery/index.md#system-tablet-backup) — обзор способов резервного копирования +- [system_tablet_backup_config](../../reference/configuration/system_tablet_backup_config.md) — параметры конфигурации diff --git a/ydb/docs/ru/core/devops/backup-and-recovery/system-tablet-backup.md b/ydb/docs/ru/core/recipes/system-tablet-backup/recovery.md index 5e3660c3122..9cbf20d9fef 100644 --- a/ydb/docs/ru/core/devops/backup-and-recovery/system-tablet-backup.md +++ b/ydb/docs/ru/core/recipes/system-tablet-backup/recovery.md @@ -1,85 +1,18 @@ -# Резервное копирование системных таблеток +# Восстановление системных таблеток {#recovery-guide} {% note info %} -На текущий момент поддерживается резервное копирование только кластерных системных таблеток. Резервное копирование системных таблеток баз данных не поддерживается. +Концептуальную информацию о механизме см. в разделе [Резервное копирование системных таблеток](../../concepts/backup.md#system-tablet-backup). {% endnote %} -Механизм резервного копирования системных таблеток обеспечивает инкрементальное копирование метаданных кластера — таких как [Hive](../../concepts/glossary.md#hive), [BSController](../../concepts/glossary.md#ds-controller) и [SchemeShard](../../concepts/glossary.md#scheme-shard) — на локальную файловую систему хостов кластера. - -Этот механизм предназначен для восстановления метаданных кластера, когда другие способы восстановления недоступны — например, резервная копия базы данных отсутствует или объём базы данных слишком велик для восстановления ее из резервной копии за приемлемое время. Механизм позволяет восстановить метаданные в существующем кластере без необходимости пересоздавать кластер и восстанавливать базы данных из резервных копий. - -Если есть возможность восстановить кластер с помощью команд [export/import](./index.md#s3) или [dump/restore](./index.md#files), рекомендуется использовать эти способы. - -{% note warning %} - -Резервные копии разных системных таблеток создаются независимо друг от друга и не согласованы между собой. После восстановления состояние таблеток может оказаться несогласованным, что может негативно влиять на работу кластера. - -{% endnote %} - -## Принцип работы {#how-it-works} - -Резервное копирование состоит из двух компонентов: - -- **Снимок состояния (snapshot)** — при каждом запуске таблетка сканирует все свои таблицы и записывает свое полное состояние в резервную копию, включая схему данных. Сканирование выполняется на основе снимка состояния и не блокирует работу таблетки. -- **Журнал изменений (changelog)** — при каждом изменении данных или схемы таблетка асинхронно записывает изменение в журнал параллельно с записью в распределённое хранилище. Когда размер журнала превышает размер снимка состояния, таблетка автоматически делает новый снимок. - -{% note warning %} - -Из-за асинхронной записи возможна потеря последних изменений, не успевших попасть в резервную копию до момента сбоя. - -{% endnote %} - -Резервные копии создаются **локально на хосте, где в данный момент работает таблетка**. Поэтому наиболее актуальная копия находится на том хосте, где таблетка работала непосредственно перед сбоем. - -Количество хранимых резервных копий на хосте ограничено в [конфигурации](../../reference/configuration/system_tablet_backup_config.md). После успешного снятия снапшота самая старая копия автоматически удаляется при превышении лимита. Незавершённые копии (без полностью записанного снапшота) удаляются при создании новой резервной копии. - -## Включение и настройка резервного копирования {#enabling-backup} - -{% note warning %} - -В качестве хранилища резервных копий поддерживаются только локальные файловые системы. Сетевые файловые системы, такие как NFS, не поддерживаются и могут привести к повреждению резервных копий или сбоям в работе таблеток. - -{% endnote %} - -По умолчанию резервное копирование системных таблеток **выключено**, так как требует настройки хранилища. Узлы {{ ydb-short-name }} обычно не используют локальную файловую систему, поэтому включение требует осознанного решения администратора. - -Для включения добавьте секцию `system_tablet_backup_config` в [конфигурацию кластера](../../reference/configuration/index.md): - -```yaml -system_tablet_backup_config: - filesystem: - path: "/path/to/backup/directory" -``` - -Параметр `path` — абсолютный путь к директории на локальной файловой системе хоста для хранения резервных копий. - -{% note warning %} - -Директория для резервных копий должна быть доступна для записи процессом {{ ydb-short-name }} на каждом хосте, где работают системные таблетки. Убедитесь, что на диске каждого хоста достаточно свободного места для хранения нескольких резервных копий всех системных таблеток. Для крупных рабочих сред, состоящих из десятков узлов хранения, рекомендуется как минимум 5 ГБ. - -{% endnote %} - -После изменения конфигурации перезапустите узлы кластера, на которых могут работать системные таблетки. Резервное копирование начнётся автоматически. - -{% note warning %} - -По умолчанию системные таблетки могут работать на любых статических узлах кластера, в том числе на тех, диски которых входят в [статическую группу](../../concepts/glossary.md#static-group). Резервные копии хранятся локально на хостах, где работают системные таблетки. Это означает, что при потере хостов статической группы могут быть потеряны и резервные копии, которые могут потребоваться для восстановления статической группы. - -Рекомендуется настроить секцию `bootstrap_config` в [конфигурации кластера](../../reference/configuration/index.md) так, чтобы системные таблетки запускались на узлах, не входящих в статическую группу. В этом случае резервные копии будут храниться отдельно от данных статической группы. - -{% endnote %} - -## Руководство по восстановлению {#recovery-guide} - {% note warning %} Восстановление системных таблеток — критическая операция, в результате которой могут быть потеряны данные. Выполняйте её только при наличии чёткого понимания проблемы и после консультации с командой эксплуатации. Перед началом убедитесь, что вы ознакомились со всеми шагами. {% endnote %} -### Шаг 1. Переведите таблетку в Recovery-режим {#enable-recovery-mode} +## Шаг 1. Переведите таблетку в Recovery-режим {#enable-recovery-mode} Таблетку, которую требуется восстановить, необходимо перевести в Recovery-режим. В этом режиме таблетка запускается и доступна через [Embedded UI](../../reference/embedded-ui/index.md), но **не работает штатно** и **не вычитывает данные из распределённого хранилища**, что позволяет выполнять операции восстановления. Остальные таблетки продолжат работать в штатном режиме, что позволит кластеру продолжать функционировать, но некоторые control-plane операции могут быть недоступны. @@ -90,10 +23,10 @@ system_tablet_backup_config: {% endnote %} 1. Определите идентификатор системной таблетки, которую требуется восстановить. Идентификатор таблетки можно найти в разделе Tablets в [Embedded UI](../../reference/embedded-ui/index.md). -2. Определите список узлов, на которых может работать восстанавливаемая системная таблетка. Этот список находится в секции `bootstrap_config` соответствующей таблетки в [конфигурации кластера](../configuration-management/index.md). Если секция `bootstrap_config` отсутствует в конфигурации, используйте список всех [статических узлов](../../concepts/glossary.md#static-node) кластера, указанных в секции `hosts` конфигурации кластера. +2. Определите список узлов, на которых может работать восстанавливаемая системная таблетка. Этот список находится в секции `bootstrap_config` соответствующей таблетки в [конфигурации кластера](../../devops/configuration-management/index.md). Если секция `bootstrap_config` отсутствует в конфигурации, используйте список всех [статических узлов](../../concepts/glossary.md#static-node) кластера, указанных в секции `hosts` конфигурации кластера. 3. Измените конфигурацию, добавив `boot_mode: RECOVERY` в секцию `bootstrap_config` восстанавливаемой таблетки. - - При использовании конфигурации V1, необходимо изменить [статическую конфигурацию](../configuration-management/configuration-v1/static-config.md) на всех узлах, на которых может работать восстанавливаемая таблетка. - - При использовании конфигурации V2, воспользуйтесь [инструкцией](../configuration-management/configuration-v2/update-config.md). + - При использовании конфигурации V1, необходимо изменить [статическую конфигурацию](../../devops/configuration-management/configuration-v1/static-config.md) на всех узлах, на которых может работать восстанавливаемая таблетка. + - При использовании конфигурации V2, воспользуйтесь [инструкцией](../../devops/configuration-management/configuration-v2/update-config.md). - Пример для таблетки `Hive` с идентификатором `72057594037968897`: ```yaml @@ -138,11 +71,11 @@ system_tablet_backup_config: - Таблетка не перезапускается. - В App таблетки в [Embedded UI](../../reference/embedded-ui/index.md) доступна форма восстановления. -### Шаг 2. Найдите файлы резервной копии {#find-backup-files} +## Шаг 2. Найдите файлы резервной копии {#find-backup-files} 1. Определите, на каких хостах искать. Прежде всего проверьте хосты, на которых таблетка работала до сбоя. Определить эти хосты можно с помощью логов или системы мониторинга. - Если определить конкретные хосты не удалось, проверьте все хосты, на которых таблетка могла работать. Этот список находится в секции `bootstrap_config` соответствующей таблетки в [конфигурации кластера](../configuration-management/index.md). Если секция `bootstrap_config` отсутствует в конфигурации, используйте список всех [статических узлов](../../concepts/glossary.md#static-node) кластера, указанных в секции `hosts` конфигурации кластера. + Если определить конкретные хосты не удалось, проверьте все хосты, на которых таблетка могла работать. Этот список находится в секции `bootstrap_config` соответствующей таблетки в [конфигурации кластера](../../devops/configuration-management/index.md). Если секция `bootstrap_config` отсутствует в конфигурации, используйте список всех [статических узлов](../../concepts/glossary.md#static-node) кластера, указанных в секции `hosts` конфигурации кластера. 2. Найдите директорию с резервными копиями. На каждом хосте-кандидате проверьте наличие резервных копий. Путь к резервным копиям определяется параметром `path` в конфигурации `system_tablet_backup_config`: @@ -184,7 +117,7 @@ system_tablet_backup_config: ... ``` -### Шаг 3. Перенесите файлы резервной копии {#transfer-backup-files} +## Шаг 3. Перенесите файлы резервной копии {#transfer-backup-files} 1. Определите, на каком хосте запущена таблетка в Recovery-режиме. Для этого откройте [Embedded UI](../../reference/embedded-ui/index.md) и найдите узел, на котором работает таблетка. 2. Если файлы резервной копии находятся на другом хосте, скопируйте их на хост с таблеткой в Recovery-режиме с помощью `scp`, `rsync` или любого другого доступного инструмента: @@ -196,7 +129,7 @@ system_tablet_backup_config: 3. Убедитесь, что файлы доступны для чтения процессу {{ ydb-short-name }} на целевом хосте. -### Шаг 4. Выполните восстановление {#perform-recovery} +## Шаг 4. Выполните восстановление {#perform-recovery} 1. Откройте App восстанавливаемой таблетки в [Embedded UI](../../reference/embedded-ui/index.md). @@ -256,14 +189,14 @@ system_tablet_backup_config: 6. Дождитесь успешного завершения восстановления. Если форма восстановления снова стала доступна (кнопка **Start Restore** активна, статус сброшен), это означает, что таблетка была перезапущена и восстановление прервано. В этом случае начните восстановление заново с пункта 2. -### Шаг 5. Верните таблетку к нормальному режиму работы {#return-to-normal} +## Шаг 5. Верните таблетку к нормальному режиму работы {#return-to-normal} После успешного восстановления: -1. Определите список узлов, на которых может работать восстанавливаемая системная таблетка. Этот список находится в секции `bootstrap_config` соответствующей таблетки в [конфигурации кластера](../configuration-management/index.md). Если секция `bootstrap_config` отсутствует в конфигурации, используйте список всех [статических узлов](../../concepts/glossary.md#static-node) кластера, указанных в секции `hosts` конфигурации кластера. +1. Определите список узлов, на которых может работать восстанавливаемая системная таблетка. Этот список находится в секции `bootstrap_config` соответствующей таблетки в [конфигурации кластера](../../devops/configuration-management/index.md). Если секция `bootstrap_config` отсутствует в конфигурации, используйте список всех [статических узлов](../../concepts/glossary.md#static-node) кластера, указанных в секции `hosts` конфигурации кластера. 2. Измените конфигурацию, удалив `boot_mode: RECOVERY` из секции `bootstrap_config` восстанавливаемой таблетки. - - При использовании конфигурации V1, необходимо изменить [статическую конфигурацию](../configuration-management/configuration-v1/static-config.md) на всех узлах, на которых может работать восстанавливаемая таблетка. - - При использовании конфигурации V2, воспользуйтесь [инструкцией](../configuration-management/configuration-v2/update-config.md). + - При использовании конфигурации V1, необходимо изменить [статическую конфигурацию](../../devops/configuration-management/configuration-v1/static-config.md) на всех узлах, на которых может работать восстанавливаемая таблетка. + - При использовании конфигурации V2, воспользуйтесь [инструкцией](../../devops/configuration-management/configuration-v2/update-config.md). 3. Перезапустите все узлы, на которых может работать восстанавливаемая таблетка. Если какие-либо узлы были изолированы от кластера по сети на предыдущих шагах, снимите сетевую изоляцию. 4. Убедитесь, что: - С таблеткой нет проблем в [HealthCheck](../../reference/ydb-sdk/health-check-api.md). diff --git a/ydb/docs/ru/core/recipes/system-tablet-backup/toc_p.yaml b/ydb/docs/ru/core/recipes/system-tablet-backup/toc_p.yaml new file mode 100644 index 00000000000..c25178f58ac --- /dev/null +++ b/ydb/docs/ru/core/recipes/system-tablet-backup/toc_p.yaml @@ -0,0 +1,5 @@ +items: +- name: Включение и настройка + href: enabling-backup.md +- name: Восстановление + href: recovery.md diff --git a/ydb/docs/ru/core/recipes/toc_p.yaml b/ydb/docs/ru/core/recipes/toc_p.yaml index ad6f716b542..3874041bed3 100644 --- a/ydb/docs/ru/core/recipes/toc_p.yaml +++ b/ydb/docs/ru/core/recipes/toc_p.yaml @@ -4,6 +4,11 @@ items: include: mode: link path: backup-collections/toc_p.yaml +- name: Рецепты резервного копирования системных таблеток + href: system-tablet-backup/index.md + include: + mode: link + path: system-tablet-backup/toc_p.yaml - name: YDB SDK и фреймворки include: mode: link diff --git a/ydb/docs/ru/core/reference/configuration/system_tablet_backup_config.md b/ydb/docs/ru/core/reference/configuration/system_tablet_backup_config.md index 991e3be56cc..6fad8fb3657 100644 --- a/ydb/docs/ru/core/reference/configuration/system_tablet_backup_config.md +++ b/ydb/docs/ru/core/reference/configuration/system_tablet_backup_config.md @@ -1,6 +1,6 @@ # system_tablet_backup_config -Механизм [резервного копирования системных таблеток](../../devops/backup-and-recovery/system-tablet-backup.md) обеспечивает инкрементальное копирование метаданных кластера — таких как [Hive](../../concepts/glossary.md#hive), [BSController](../../concepts/glossary.md#ds-controller) и [SchemeShard](../../concepts/glossary.md#scheme-shard) — на локальную файловую систему хостов кластера. Поведение резервного копирования конфигурируется в секции `system_tablet_backup_config` конфигурации {{ ydb-short-name }}. +Механизм [резервного копирования системных таблеток](../../concepts/backup.md#system-tablet-backup) обеспечивает инкрементальное копирование метаданных кластера — таких как [Hive](../../concepts/glossary.md#hive), [BSController](../../concepts/glossary.md#ds-controller) и [SchemeShard](../../concepts/glossary.md#scheme-shard) — на локальную файловую систему хостов кластера. Поведение резервного копирования конфигурируется в секции `system_tablet_backup_config` конфигурации {{ ydb-short-name }}. ## Синтаксис diff --git a/ydb/docs/ru/core/reference/ydb-cli/export-import/toc_i.yaml b/ydb/docs/ru/core/reference/ydb-cli/export-import/toc_i.yaml index fafd14c03c2..5390d8d317d 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/export-import/toc_i.yaml +++ b/ydb/docs/ru/core/reference/ydb-cli/export-import/toc_i.yaml @@ -13,5 +13,3 @@ items: href: import-s3.md - name: Импорт данных из файла в существующую таблицу href: import-file.md -- name: Коллекции резервных копий - href: ../../../devops/backup-and-recovery/index.md |
