Кукольный: Руководство для начинающих (часть 4) ~ Где мои данные?

Где мои данные?

Когда я запустил свой Puppet-ry, в примерах, которые я использовал, все данные конфигурации были спрятаны в коде манифестов DSL, люди пытались использовать наследование для передачи данных. Затем я увидел шаблон проектирования в марионеточных манифестах, не учитывающий отдельный манифест параметров для переменных конфигурации. Затем пришел поиск внешних данных через файлы CSV в качестве функции Puppet. Затем с улучшениями в кукольный и другие модули пришли вместе больше.

Ниже приведено несколько полезных способов использования отдельных источников данных в ваших манифестах.

Здесь мы увидим стили использования данных для Puppet Manifests, Extlookup CSV, Hiera, Plug-in Facts и PuppetDB.

params-манифест :

Это очень простой способ отделения данных от кода функциональности и предпочтительный способ для будущих типов данных с возрастающим набором значений. Это будет держать его отдельно от кода с момента запуска. Как только требование достигнет уровня, позволяющего изменить значение по отношению к предполагаемому в зависимости от среды / домена / fqdn / operatingsystem /, его можно извлечь любыми предпочтительными способами, указанными ниже и просто просмотренными здесь. Это позволит избежать изменения основного (вспомогательного) кода модуля.
[Gist-Set Externalize в Params Manifest: [a href = «https://gist.github.com/3683955» style = «text-художественное оформление: нет; цвет: rgb (136, 136, 136); семейство шрифтов: Грузия, Утопия, «Палатино Линотип», Палатино, с засечками, размер шрифта: 15px, высота строки: 21px, цвет фона: rgb (255, 249, 238); «] https://gist.github.com/ 3683955]

Допустим, вы предоставляете подмодуль httpd :: git для модуля httpd, размещая сгенерированный шаблонный файл конфигурации, используя данные, помещенные в параметрах …

# $ MODULEPATH / httpd / manifest / git.pp
  
класс httpd :: git {
  включить httpd :: params
 
  $ is_cgi = $ httpd :: params :: is_cgi
  $ path = $ httpd :: params :: path
  $ url = $ httpd :: params :: url
 
  файл {
    "$ {HTTPD :: PARAMS :: conf_path} /git.conf":
      обеспечить => «настоящее»,
      content => template ('httpd / mynode.conf.erb'),
  }
}

# $ MODULEPATH / httpd / templates / mynode.conf.erb
 
Псевдоним <% = url%> <% = путь%>
 
<Directory <% = путь% >>
  <% if is_cgi%>
  Опции + ExecCGI
  AddHandler cgi-скрипт .cgi
  DirectoryIndex gitweb.cgi
  <% end%>
</ Directory>

# $ MODULEPATH / httpd / manifest / params.pp
 
класс httpd :: params {
 
  $ conf_path = '/etc/httpd/conf.d/'
  $ is_cgi = true
  $ path = '/ var / www / git'
  $ url = '/ mygit'
}

Puppet apply --modulepath = $ MODULEPATH -e "включить httpd :: git"

# $ MANIFESTPATH ​​/ extdatadir / common.csv 
 
httpd_conf_dir, / и т.д. / HTTPD / conf.d
httpd_is_cgi, правда,
httpd_git_path, / вар / WWW / мерзавец
httpd_git_url, / mygit

# $ MANIFESTPATH ​​/ extdatadir / env_testnode.csv 
 
httpd_git_url, / testgit

# $ MODULEPATH / httpd / manifest / git.pp 
 
класс httpd :: git {
 
  $ conf_dir = extlookup ('httpd_conf_dir')
  $ is_cgi = extlookup ('httpd_is_cgi')
  $ path = extlookup ('httpd_git_path')
  $ url = extlookup ('httpd_git_url')
 
 
  файл {
    "$ {} Conf_dir /git.conf":
      обеспечить => «настоящее»,
      content => template ('httpd / mynode.conf.erb'),
  }
}

# $ MODULEPATH / httpd / templates / mynode.conf.erb 
 
Псевдоним <% = url%> <% = путь%>
 
<Directory <% = путь% >>
  <% if is_cgi === 'true'%> #, потому что из CSV любое (логическое) значение будет читаться как строка
  Опции + ExecCGI
  AddHandler cgi-скрипт .cgi
  DirectoryIndex gitweb.cgi
  <% end%>
</ Directory>

Puppet apply --environment = testnode --modulepath = $ MODULEPATH --manifestdir = $ MANIFESTPATH ​​$ MANIFESTPATH ​​/ site.pp

# $ MANIFESTPATH ​​/ site.pp
 
$ extlookup_datadir = "$ {settings :: manifestdir} / extdatadir"
$ extlookup_precedence = ["% {fqdn}", "env _% {environment}", "domain _% {domain}", "common"]
 
включить httpd :: git

: движки:
    - http
    - Redis
    - Ямл
    - JSON
 
: HTTP:
  : host: testnode.testenv.abk
  : порт: 5984
  : вывод: JSON
  : fail: изящный
  : путь:
    - /config/%ndom::hostname‹.json
    - /config/%ndom::fqdncasts.json
    - /config/%ndom::environment‹.json
    - /config/%ndom::operatingsystem rout.json
    - /config/common.json
 
: Redis:
    : пароль: my_redis_password
 
: YAML:
    : datadir: '/ etc / puppet / hieradata / yaml'
 
: JSON:
    : datadir: '/ etc / puppet / hieradata / json'
 
: Иерархия:
    -% {:: имя хоста}
    -% {:: fqdn}
    - %{::Окружающая среда}
    - %{::Операционная система}
    - обычный
 
: logger: console

{
  "message": "Лучше использовать PuppetDB.",
  "this_file": "/etc/puppet/hieradata/json/common.json"
}

---
public_data: "# создано в CentOS"
this_file: "/etc/puppet/hieradata/yaml/CentOS.yaml"

---
public_file: "/ tmp / note"
public_data: "# создано на любом узле"
this_file: "/etc/puppet/hieradata/yaml/common.yaml"

---

sed -i 's / ^ requirepass \ s * \ S * // g' /etc/redis.conf
 
REDIS_PASSWORD = 'my_redis_password'
echo "requirepass $ REDIS_PASSWORD" >> /etc/redis.conf
 
/ sbin / service redis перезапустить
 
redis-cli -a $ REDIS_PASSWORD << 'EOF'
  установить общий: secret_file /etc/local.keys
  Производство набора: секретный файл /etc/global.keys
  КЛЮЧИ *
EOF

---

{
  "secret_data": "все секретные ключи",
  "this_file": "http: //testnode.testenv.abk/config/mynode.json"
}

---

драгоценный камень установить иера иера-http иера-кукольный иера-редис
 
cat> site.pp << EOF
\ $ public_file = hiera ('public_file', '/ tmp / abc')
 
файл{
  \ $ Public_file:
    content => hiera ('public_data', 'a2z'),
    обеспечить => настоящее время,
}
 
\ $ secret_file = hiera ('secret_file', '/ tmp / cba')
 
файл{
  \ $ Secret_file:
    content => hiera ('secret_data', 'z2a'),
    обеспечить => настоящее время,
}
 
\ $ msg = hiera ('message', '')
извещение (\ $ сбщ)
EOF
 
кукольный применяется --environment = testnode site.pp

# $ MODULEPATH / httpd / manifest / git.pp 
 
класс httpd :: git {
 
  файл {
    "$ {:: conf_dir} /git.conf":
      обеспечить => «настоящее»,
      content => template ('httpd / mynode.conf.erb'),
  }
}

# $ MODULEPATH / httpd / templates / mynode.conf.erb
 
Псевдоним <% = git_url%> <% = git_path%>
 
<Directory <% = git_path% >>
<% if is_cgi === 'true'%> #, потому что в фактах любое (логическое) значение сохраняется как строка
  Опции + ExecCGI
  AddHandler cgi-скрипт .cgi
  DirectoryIndex gitweb.cgi
  <% end%>
</ Directory>

Puppet apply --modulepath = $ MODULEPATH -e "включить httpd :: git"

[главный]
  storeconfigs = true
  storeconfigs_backend = puppetdb
  отчеты = магазин, puppetdb
  pluginsync = true

[главный]
  сервер = $ FQDN
  порт = 8081

подать заявление:
  факты:
    конечная остановка: facter
    кеш: facter

# скачать puppetdb и зависимые модули puppet
модуль кукол установить puppetlabs / puppetdb
 
# установить puppetdb и postgresql по умолчанию
кукольный применить -e "class {'puppetdb':}"
puppet apply -e "package {'puppetdb-terminus':}"
 
# резервное копирование ssl dirs, если они существуют
if [-d / etc / puppet / ssl]; затем
  mv / etc / puppet / ssl /etc/puppet/ssl.bak
фи
if [-d / etc / puppetdb / ssl]; затем
  mv / etc / puppetdb / ssl /etc/puppetdb/ssl.bak
фи
 
# Исправление использования CA как masterless
FQDN = `facter fqdn`
кукольный сертификат генерирует $ FQDN
puppetdb-ssl-setup -f
 
# добавление полного доменного имени в IP-отображение хоста в PuppetDB и всех используемых узлов
IPADDRESS = `Ipaddress фастера`
echo "$ IPADDRESS $ FQDN" >> / etc / hosts
 
# / sbin / service или любая другая служебная команда, которую вы используете
/ sbin / service puppetdb restart