Site icon 8HOST.COM

Синхронизация локальных и удалённых каталогов при помощи lsyncd

Что такое lsyncd?

При управлении веб-сервером или приложением часто возникает необходимость синхронизировать каталоги. Одним из надёжных решений для выполнения этой задачи является демон lsyncd.

В данном руководстве показано, как настроить lsyncd для синхронизации изменений в каталогах на одной машине и между удалёнными хостами.

Примечание: Данное руководство выполнено на виртуальном выделенном сервере Ubuntu 12.04, но любой современный дистрибутив будет работать таким же образом.

Установка lsyncd

Демон lsyncd можно скачать из официального репозитория Ubuntu.

Чтобы установить lsyncd, используйте команды:

sudo apt-get update
sudo apt-get install lsyncd

Эти команды установят lsyncd. Но демон поставляется без стандартных настроек, потому их необходимо установить самостоятельно.

Примеры конфигурации lsyncd

Демон lsyncd не имеет стандартного конфигурационного файла, но предоставляет несколько примеров конфигураций, которые можно найти в каталоге /usr/share/doc/lsyncd/examples:

cd /usr/share/doc/lsyncd/examples
ls
lbash.lua  lgforce.lua      lpostcmd.lua  lrsyncssh.lua
lecho.lua  limagemagic.lua  lrsync.lua

Ознакомьтесь с этими текстовыми файлами, чтобы понять, как устроены конфигурации lsyncd.

Более подробные настройки можно найти в файле lrsync.lua:

sudo nano
----
-- User configuration file for lsyncd.
--
-- Simple example for default rsync.
--
settings = {
statusFile = "/tmp/lsyncd.stat",
statusIntervall = 1,
}
sync{
default.rsync,
source="src",
target="trg",
}

Строки, которые начинаются с двух тире (–), закомментированы, lsyncd не интерпретирует их.

Конфигурационный файл lsync написан ан языке программирования Lua; узнать больше о Lua можно здесь.

Настройка окружения

Для примера попробуйте синхронизировать два локальных каталога. Создайте их при помощи следующей команды:

sudo mkdir -p /source/to/copy
sudo mkdir /dest

Затем нужно добавить несколько файлов в первый каталог:

cd /source/to/copy
sudo touch file{1..100}

Эти команды создают 100 файлов в каталоге /source/to/copy.

Кроме того, нужно создать лог для lsyncd и несколько файлов в нём:

sudo mkdir /var/log/lsyncd
touch /var/log/lsyncd/lsyncd.{log,status}

Затем нужно создать конфигурационный каталог lsyncd:

sudo mkdir /etc/lsyncd

В этом каталоге создайте конфигурационный файл lsyncd.conf.lua:

sudo nano /etc/lsyncd/lsyncd.conf.lua

Синхронизация локальных каталогов при помощи lsyncd

При помощи только что созданного конфигурационного файла можно синхронизировать каталоги /source/to/copy directory to the /dest.

Основные настройки

Основные настройки находятся в разделе settings; поместите в файл:

settings = {
logfile = "/var/log/lsyncd/lsyncd.log",
statusFile = "/var/log/lsyncd/lsyncd.status"
}

Благодаря этим опциям lsyncd будет использовать созданные ранее файлы.

Настройки синхронизации

Следующий раздел содержит настройки синхронизации. Поскольку в данном случае синхронизация будет выполняться локально, можно использовать команду rsync.

Эти конфигурации определяются при помощи опции default.rsync, которая значит, что демон lsyncd будет ждать 20 секунд или собирать 1000 отдельных событий синхронизации, а затем вызовет rsync для синхронизации изменений.

Согласно мануалу lsyncd вызываемая команда rsync эквивалентна команде:

rsync -ltsd --delete --include-from=- --exclude=* SOURCE TARGET

Это значит, что rsync работает следующим образом:

Всё, что нужно сделать, чтобы изменения вступили в силу – указать тип синхронизации, исходный и целевой каталог. Раздел sync должен выглядеть так:

sync {
default.rsync,
source = "/source/to/copy",
target = "/dest"
}

Чтобы изменить поведение rsync при помощи опций, задайте переменной rsyncOpts список этих опций, разделив их запятыми:

sync {
default.rsync,
source = "/source/to/copy",
target = "/dest",
rsyncOpts = {"rsync option1", "rsync option2", "rsync option3"}
}

Теперь файл готов к тестовой синхронизации; сохраните и закройте файл.

Тестовая локальная синхронизация

Откройте целевой каталог и убедитесь, что он пуст (в данном случае это /dest):

cd /dest
ls

Последняя команда не должна вернуть никакого вывода, поскольку каталог пуст.

Перезапустите сервис  lsyncd, выполнив команду:

sudo service lsyncd start

Снова выполните команду ls:

ls
file1    file18  file27  file36  file45  file54  file63  file72  file81  file90
file10   file19  file28  file37  file46  file55  file64  file73  file82  file91
file100  file2   file29  file38  file47  file56  file65  file74  file83  file92
file11   file20  file3   file39  file48  file57  file66  file75  file84  file93
file12   file21  file30  file4   file49  file58  file67  file76  file85  file94
file13   file22  file31  file40  file5   file59  file68  file77  file86  file95
file14   file23  file32  file41  file50  file6   file69  file78  file87  file96
file15   file24  file33  file42  file51  file60  file7   file79  file88  file97
file16   file25  file34  file43  file52  file61  file70  file8   file89  file98
file17   file26  file35  file44  file53  file62  file71  file80  file9   file99

Как видите, демон lsyncd успешно синхронизировал локальные каталоги.

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

sudo mkdir /source/to/copy/hello{1..100}
ls

Затем проверьте целевой каталог при помощи команды ls.

Удалённая синхронизация при помощи lsyncd

Чтобы настроить удалённую синхронизацию, нужно внести несколько изменений в конфигурационный файл.

Для начала нужно иметь возможность подключиться к машине по ssh.

Подключение к удалённой машине с помощью SSH-ключей

Чтобы получить инструкции по созданию SSH-ключей, читайте данное руководство.

Создайте пару ключей для root-пользователя, поскольку lsyncd будет работать как root. Затем скопируйте файл ключа на удалённую машину при помощи команды:

sudo su
ssh-copy-id remote_mirror_ip_address

Теперь файл ключа позволит входить на удалённый сервер как пользователю root.

Убедитесь, что это работает, и создайте на удалённой машине целевой каталог:

ssh remote_mirror_ip_address

Для примера создайте целевой каталог /remotesync:

mkdir /remotesync

Закройте удалённую сессию и локальную root-сессию, дважды введя exit:

exit
exit

Настройка удалённой синхронизации lsyncd

Откройте конфигурационный файл lsyncd:

sudo nano /etc/lsyncd/lsyncd.conf.lua
settings = {
logfile = "/var/log/lsyncd/lsyncd.log",
statusFile = "/var/log/lsyncd/lsyncd.status"
}
sync {
default.rsync,
source = "/source/to/copy",
target = "/dest"
}

Нужно внести некоторые изменения в раздел sync:

Замените default.rsync на default.rsyncssh, чтобы включить поддержку rsync по ssh; также замените переменную target переменными host и targetdir:

settings = {
logfile = "/var/log/lsyncd/lsyncd.log",
statusFile = "/var/log/lsyncd/lsyncd.status"
}
sync {
default.rsyncssh,
source = "/source/to/copy",
host = "remote_mirror_ip_address",
targetdir = "/remotesync"
}

Сохраните и закройте файл.

Тестирование удалённой синхронизации

Перезапустите сервис lsyncd:

sudo service lsyncd restart

Подключившись к удалённой машине по ssh, можно увидеть изменения в каталоге /remotesync:

sudo su
ssh remote_mirror_ip_address
ls /remotesync

Теперь этот каталог содержит файлы, добавленные в каталог /source/to/copy.

Заключение

Сервис lsyncd – отличный способ синхронизировать файлы между системами и каталогами. Написанный на Lua конфигурационный файл делает этот инструмент ещё более гибким и производительным. Документация Lua и lsyncd содержат инструкции для настройки более сложной синхронизации.

Кроме того, помните, что каталог /usr/share/doc/lsyncd/examples содержит и другие примеры конфигурационных файлов.