Добавление дополнительных файлов в резервную копию

примечание

Исполнять сценарий необходимо от имени пользователя postgres.

Описание сценария

При создании резервной копии в итоговый CWL-архив, помимо данных из директории PGDATA и связанных с ней табличных пространств, могут быть добавлены дополнительные файлы, например файлы конфигурации сторонних утилит и служб.

Для каждого дополнительного файла в архиве сохраняются следующие данные:

• исходный полный путь к файлу;
• размер файла;
• права доступа;
• дата и время последнего изменения.

примечание

• Максимальный размер одного дополнительного файла — 10 МБ.
• Количество дополнительных файлов не ограничено.
• Файлы должны быть доступны для чтения пользователем, от имени которого выполняется создание резервной копии.

Последовательность выполнения

1. Для включения дополнительных файлов в резервную копию укажите их пути в конфигурационном файле copywala.yaml в параметре extra_files секции backup_policy.

   Например, для добавления файлов test_file_1.conf и test_file_2.conf, расположенных в /etc/pbr/ заполненная секция будет выглядеть так:

       backup_policy:
     extra_files:
       - /etc/pbr/test_file_1.conf
       - /etc/pbr/test_file_2.conf

2. Запустите резервное копирование командой copywala create-backup и дождитесь его завершения.

Результат

Дополнительные файлы успешно добавлены в CWL-архив резервной копии.

Для проверки того, что файлы включены в архив, выполните команду copywala cwl info <путь_к_cwl_архиву>. В выводе команды перейдите к разделу backup_info.extra_files — здесь будет перечислен список дополнительных файлов, вошедших в резервную копию:

:caption: Пример вывода
:emphasize-lines: 11-13
version: CWLv3
footer_offset: 107831296
footer_size: 188416
part_size: 4194304
parts_num: 91
entries_num: 1488
checksum_algorithm: CRC32
compression_algorithm: S2
backup_info:
    ...
    extra_files:
        - /etc/pbr/test_file_1.conf
        - /etc/pbr/test_file_2.conf

Исключительные сценарии

Будет выведено соответствующее сообщение для случаев:

• Размер файла превышает допустимый лимит (10 МБ).

  :caption: Пример вывода
  WRN skip saving extra file package=cwl err="extra file size overflow" file=/etc/pbr/large_file.txt size=11.00MB max_size=10.00MB

• Указанный в конфигурации файл отсутствует или недоступен для чтения при создании резервной копии.

  :caption: Пример вывода
  WRN skip saving extra file package=cwl err="stat /etc/pbr/test_file_3.conf: no such file or directory" file=/etc/pbr/test_file_3.conf

  :caption: Пример вывода
  WRN skip saving extra file package=cwl err="open /etc/pbr/test_secret_file_5.txt: permission denied" file=/etc/pbr/test_secret_file_5.txt