Project

General

Profile

Управление 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