Управление SCI сервисами¶
OVERVIEW | INSTALL | SETUP | OPERATIONS | LICENSE
ОБЗОР | УСТАНОВКА | НАСТРОЙКА | ОПЕРАЦИИ | ЛИЦЕНЗИЯ
PUPPET¶
Puppet - это платформа для автоматизации системного администрирования большого количества компьютеров.
Puppet позволяет легко автоматизировать задачи по настройке операционных систем и используется для настройки узлов и виртуальных машин в кластере.
Документация можно найти здесь: http://docs.puppetlabs.com/
Управляющий сервер - "Puppet master" установлен на сервисной виртуальной машине 'sci'.
В комплекте поставки есть следующие модули:- Общая настройка сервера (common) - установка полезных пакетов и удобных умолчаний
- locale (locale)
- timezone (timezone)
- Approx (approx) - прокси для пакетов обновления Debian
- DNS (bind9) - запуск в chroot и пред-настройка для обслуживания кластера
- DHCP (dhcpd) - пред-настройка для кластера и DDNS
- Почта (exim4) - настройка доставки локальной почты
Конфигурация хостов¶
Конфигурация для хостов задается в файле /etc/puppet/manifests/nodes.pp:
node 'default' {
class { sources_list_local: stage => pre0, }
class { common_profile: stage => pre1, }
class { timezone: zone => "Europe/Moscow", stage => main, }
class { locale: def_locale => "ru_RU.UTF-8", stage => main, }
}
node 'sci' {
class { approx_local: stage => pre0, }
class { sources_list_local: stage => pre0, }
class { common_profile: stage => pre1, }
class { bind9_sci: stage => main, }
class { timezone: zone => "Europe/Moscow", stage => main, }
class { locale: def_locale => "ru_RU.UTF-8", stage => main, }
class { dhcpd: enabled => no, stage => post1, }
}
Если Вы не указали хост в файле, то к нему применяются настройки default.
Обновление рецептов¶
Настройка большинства сервисов SkyCover Infrastructure производится при помощи рецептов puppet.
В вашей системе эти рецепты находятся в каталоге /etc/puppet/modules
Вы можете получать обновления каталога рецептов из официального репозтория https://github.com/skycover/sci-puppet при помощи следующей процедуры:
Запишите изменения в своем каталоге рецептов (если вы их вносили)
cd /etc/puppet git status # показать список изменений, которые вы сделали git diff --color # показать различия в виде diff git commit -am"Latest changes" # записать изменения git push
Проверьте наличие обновлений
cd /root/puppet git checkout master git pull
Если последняя команда вывела список изменившихся файлов, то можно проанализировать изменения:
git log
Затем посмотреть различия с вашей локальной версией
git checkout local git diff master
Добавьте изменения в локальную версию
git merge master
или
git cherry-pick HASHSUM
Все эти манипуляции не затрагивают ваш действующий каталог рецептов и могут быть отменены
Перенесите обновление в действующий каталог рецептов
cd /etc/puppet git pull
Для более подробной информации рекомендуем познакомиться с git. Начните от сюда: МАГИЯ GIT
Apt¶
Apt автоматически настраивается во всем кластере средствами puppet
sources.list¶
Шаблон для sources.list находится в /etc/puppet/modules/approx/templates/sources.list.erb и настроен для работы через approx.
Approx¶
Шаблон конфига Approx находится /etc/puppet/modules/approx/templates/approx.conf.erb
Для быстрого применения изменений выполните:
/etc/init.d/puppet restart
DNS¶
DNS автоматически устанавливается на машине 'sci'.
Прямая зона лежит в файле /etc/bind/master/$domain
Обратная зона (192.168.0.0/16) лежит в файле /etc/bind/master/in-addr
Если требуется держать обратную зону для другого диапазона ip, то следует сначала поправить /etc/bind9/named.conf.local,
а уже затем поправить содержимое зоны. Пример конфига в named.conf.local для зоны 10.0.0.0/8:
zone 10.in-addr.arpa in {
type master;
file "/etc/bind/master/in-addr";
allow-query { any; };
allow-update{ key DHCP_UPDATE; };
};
При каждом ручном изменении зоны Вы должны увеличивать счетчик в начале файла:
0000000001 ; Serial
Рекомендуется формат YYYYMMDDNN (NN порядковый номер изменения за этот день).
Вы можете изменять этот файл как угодно для того, чтобы он подходил к Вашей системе.
Новые записи должны идти после:
; here you can put any other records
Чтобы применить изменения, следует:
/etc/init.d/bind9 reload
ПРИМЕЧАНИЕ: Если Вы используете динамические апдейты зоны(например, от dhcp сервера),
до ручного изменения файла следует "заморозить" зону:
rndc freeze your.domain
для прямой зоны
rndc freeze 168.192.in-addr.arpa
для обратной зоны
а после изменения файла следует "разморозить" зону:
rndc unfreeze your.domain
или
rndc unfreeze 168.192.in-addr.arpa
DHCP¶
isc-dhcp-server настроен на машине sci, но отключен по умолчанию.
Если Вы хотите его включить, Вам следует сменить строчку в nodes.pp:
class { dhcpd: enabled => no, stage => post1, }
на:
class { dhcpd: enabled => yes, stage => post1, }
Если у Вас есть отдельный lan сегмент, то dhcp настраивается на него, если нет - на основной сегмент.
Дефолтный конфиг выглядит наподобие этого:
ddns-update-style interim;
ddns-updates on;
allow-unknown-clients;
autoritative;
ddns-domainname "your.domain";
update-static-leases on;
allow client-updates;
key DHCP_UPDATE {
algorithm HMAC-MD5;
secret secret-generated-md5;
};
subnet 192.168.5.0 netmask 255.255.255.0 {
authoritative;
ddns-updates on;
range 192.168.5.11 192.168.5.254;
option routers 192.168.5.35;
option domain-name-servers 192.168.5.35;
option domain-name "your.domain";
default-lease-time 604800;
max-lease-time 2592000;
}
zone your.domain. {
primary 127.0.0.1;
key DHCP_UPDATE;
}
zone 168.192.in-addr.arpa. {
primary 127.0.0.1;
key DHCP_UPDATE;
}
Локаль¶
Локаль в кластере настраивается с помощью puppet. По умолчанию она - ru_RU.UTF-8.
При создании машины sci локаль берется из sci.conf(переменная LOCALE) и вносится в nodes.pp.
Если Вам уже после создания понадобилась другая локаль, назначьте ее в /etc/puppet/manifests/nodes.pp
class { locale: def_locale => "ru_RU.cp1251", stage => main, }
Часовой пояс¶
Настраивается через puppet модулем timezone. По умолчанию - Europe/Moscow.
При создании машины sci часовой пояс берется из sci.conf(переменная TIMEZONE) и вносится в nodes.pp.
Если Вам уже после создания понадобилась другая локаль, назначьте ее в /etc/puppet/manifests/nodes.pp
class { timezone: zone => "Europe/Berlin", stage => main, }
Системная почта¶
Реализовано два подхода к доставке системной почты:
1) Вся почта поступает на одну машину (sci по умолчанию) в локальный почтовый ящик указанного пользователя
2) Все почта поступает на сторонний почтовый ящик. Это более удобный подход, но для него требуется смартхост, который может доставлять почту через интернет, поэтому по умолчанию используется первый подход.
Этот модуль конфигурируется аргументами из nodes.pp. Для первой схемы он выглядит так:
node 'default' {
...........
class { exim4: smarthost => "default", forward_to => 'admin', stage => main, }
}
node 'sci' {
...........
class { exim4: mailhub => yes, forward_to => 'admin', stage => main, }
}
Вся почта приходит пользователю admin (по умолчанию root) на машину sci.
А вот пример для внешнего ящика:
node 'default' {
...........
class { exim4: smarthost => "my-smarthost.localdomain", forward_to => 'notify@other.domain', stage => main, }
}
node 'sci' {
...........
class { exim4: smarthost => "my-smarthost.localdomain", forward_to => 'notify@other.domain', stage => main, }
}
Web сервер¶
для применения модуля в nodes.pp нужно добавить:
node 'web' inherits default {
class { web: stage => main, }
}
Где web - хостнейм веб сервера.
Затем дать команду service puppetmaster reload
Данный модуль поставит nginx, php-fpm, mysql, а также скрипт для быстрого добавления сайтов add-site.
# add-site usage: /usr/local/sbin/add-site user [sitename] /usr/local/sbin/add-site user creates user and home dirs if not exist /usr/local/sbin/add-site user sitename creates user if not exist and create /home/$user/www/$sitename directory creates /etc/nginx/sites-available/$sitename and /etc/php5/pfm/pool.d/$sitename.conf from templates creates mysqlbase $sitename and mysql user $sitename grant all privileges to new user on new base generate password for new user and echo it on console
Для начала нужно создать окружение пользователя:
add-site user01
создает системного пользователя, генерирует ему пароль, чтобы под ним можно было заходить по ssh.
Также он создает ~/www - там будут лежать директориями с сайтами пользователя и ~/logs - там будут лежать логи этих сайтов.
Затем нужно создать сайт:
add-site user01 example.com
Эта команда создаст директорию /home/user01/www/example.com, конфиг vhost для nginx, конфиг vhost для php-fpm
Шаблоны для конфигов лежат в /etc/add-site, их можно менять.
Затем скрипт создаст mysql базу example.com и пользователя mysql example.com.
Пользователю назначит права на базу, сгенерирует пароль и выведет его на экран.
Все, что останется сделать руками - залить от имени пользователя по ssh файлы сайта в ~/www/example.com
Задать параметры подключения к mysql в конфиге сайта, выполнить активацию нового вхоста:
nginx_ensite example.com service php5-fpm reload
Ну и настроить днс для домена example.com