Аннотация

Puppet — нструмент управления конфигурацией, позволяющий системным администраторам автоматизировать предоставление, настройку и управление серверной инфраструктурой. Требует установки агентского ПО на управляемые компьютеры. Puppet позволяет описывать желаемое состояние систем в виде кода и применяет этот код для настройки серверов, рабочих станций и т.д. Puppet функционирует по принципу взаимодействия двух компонентов: Puppet Server и Puppet Agent. Puppet Server выступает в роли центрального узла, который хранит конфигурации и управляет их распространением. Puppet Agent работает на управляемых узлах и отвечает за применение конфигураций, полученных от сервера. 

Основные термины:

• Агент (Agent) — компонент Puppet, работающий на управляемых узлах. Агент периодически отправляет запросы на сервер для получения обновлений и отправляет отчеты о состоянии системы после применения изменений.
• Сервер (Server) — центральный компонент Puppet, который хранит и распространяет конфигурации по запросу агентов.
• Манифест (Manifest) — файл с расширением .pp, содержащий описание желаемого состояния системы на декларативном языке Puppet DSL.
• Модуль (Module) — структурированный набор манифестов, файлов и шаблонов для решения конкретной задачи. Существуют готовые модули Puppet.
• Ресурс (Resource) — единица конфигурации в Puppet (например, файл, пакет, служба). Puppet Agent проверяет состояние каждого ресурса перед выполнением действий из манифеста.

Принцип работы Puppet:

1. Описание состояния. Администратор описывает желаемое состояние системы в манифесте.
2. Распространение конфигурации. После запроса агентов Puppet Server распространяет на них манифесты, содержащие программную конфигурацию операционной системы.
3. Применение изменений. Puppet Agent применяет изменения для достижения желаемого состояния операционной системы.
4. Проверка соответствия. Puppet Agent периодически проверяет соответствие текущего состояния системы заданному. Если Puppet Agent не может получить обновления от сервера то, по умолчанию, система остаётся в состоянии, актуализированном на момент последнего успешного запроса.

Взаимодействие между сервером и агентами осуществляется через HTTPS (порт 8140) с использованием SSL/TLS. Puppet Server выполняет роль центра сертификации, управляя подписью сертификатов агентов для аутентификации. 

Описание стенда

На стенде отсутствует настроенный DNS-сервер, поэтому для разрешения IP-адресов используются файлы /etc/hosts на сервере и на клиенте.

Настройка стенда

Для правильной работы служб Puppet Server и Puppet Agent необходимо настроить разрешение имён одним из способов:

• либо в службе DNS;
• либо указать адреса и имена узлов в файлах /etc/hosts на всех узлах (этот вариант используется в данной статье):

127.0.0.1 localhost
10.0.2.120 master.astra.lan master puppet
10.0.2.121 agent1.astra.lan agent1
# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

и на агенте:

Если включен межсетевой экран, то на узлах необходимо разрешить коммуникации через порт 8140. Для сетевого экрана ufw:

Установка Puppet Server

1. Для установки выполнить на сервере следующие команды:
   

   sudo apt update sudo apt install default-jre-headless puppetserver

   Указание пакета в команде установки пакета openjdk-jre-headless необходимо для того, чтобы он обновился из расширенного репозитория если был установлен ранее.
   
   

2. Разрешить автоматический запуск Puppet Server и запусть его:
   

   sudo systemctl enable puppetserver sudo systemctl start puppetserver

   
   

3. Проверить статус службы:
   

   active

   
   

   После запуска Puppet Server самостоятельно выпустит собственный сертификат и подпишет его. Сертификат сервера может появиться не сразу, а в течении одной минуты.

4. Проверить наличие сертификата сервера:
   

   Signed Certificates: master.astra.lan       (SHA256)  D0:9D:AC:79:E4:C0:23:D2:42:EC:B0:1E:A0:5B:BB:EC:D9:B0:14:90:2A:8B:E3:E1:E4:76:E6:6A:BA:9B:86:4B

   
   

   • Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений:
     

     sudo /opt/puppetlabs/bin/puppetserver ca list --all

      

Получить общую справку для puppetserver можно выполнив puppetserver --help или puppetserver <имя параметра> --help для конкретного параметра. Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений это 

/opt/puppetlabs/bin/puppetserver --help или /opt/puppetlabs/bin/puppetserver <имя параметра> --help.

Установка Puppet Agent

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

   sudo apt update sudo apt install puppet-agent

   
   
2. Указать имя сервера в конфигурационном файле:
   

   server = master.astra.lan show_diff = true

   Где show_diff — параметр, указывающий инструменту выводить подробную информацию об изменениях в конфигурации клиента в ходе выполнения манифестов. Параметр применяется при настройке и отладке.
   

   Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений в пути каталогов указывается каталог /etc/puppetlabs/puppet вместо /etc/puppet.

3. Разрешить автоматический запуск службы Puppet Agent и запустить её:
   

   sudo systemctl enable puppet sudo systemctl start puppet

   
   

4. Проверить статус службы:
   

   active

Создание псевдонимов для запуска старых версий Puppet Server и Puppet Agent

В Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений используется запуск инструметов Puppet с указанием полного пути до исполняемых файлов: /opt/puppetlabs/bin/puppetserver и /opt/puppetlabs/bin/puppet. Пример:

Чтобы упростить дальнейшую работу с инстументом рекомендуется создать ссылки с сокращенными названиями puppetserver и puppet соответственно:

1. Проверить наличие исполняемого файла на сервере и клиентах в каталоге:
   

   /opt/puppetlabs/bin/puppetserver

2. Создать сокращенную ссылку для puppet (на сервере и клиентах):
   

   sudo ln -s /opt/puppetlabs/bin/puppet /usr/local/bin/puppet

3. Создать сокращенную ссылку для puppet (на сервере):
   

   sudo ln -s /opt/puppetlabs/bin/puppetserver /usr/local/bin/puppetserver

Настройка Puppet Agent

• Узнать версию puppet:


  puppet --version

• Получить общую справку для puppet:


  puppet --help

• Проверить настроено ли SSL-соединение между агентом и сервером:
  

  sudo puppet ssl verify

• Отобразить информацию о настройках агента:
  

  sudo puppet config print

• Выполнить однократный тестовый запрос без применения изменений:
  

  sudo puppet agent --test --noop

  Параметр --noop указывает агенту не применять изменения.

Подписание сертификата агента

1. При первом запуске клиентская служба Puppet Agent отправит на Puppet Server запрос на подпись сертификата. Для просмотра списка запросов на подпись сертификата выполнить на сервере следующую команду:
   

   Requested Certificates: agent1.astra.lan (SHA256) 9A:FD:EA:3D:2E:41:A5:11:A1:F7:61:6B:2E:E5:95:BD:81:63:5A:66:0D:93:D2:E0:4A:D9:81:E3:73:8F:0B:6C

   В примере выше сервер сообщает, что у него имеется один запрос на подпись сертификата от клиента с именем agent1.astra.lan.
   

   Запрос на подписание при первой установке может приходить с временной задержкой до 5 мин.

2. Подписать сертификат на сервере:
   

   Successfully signed certificate request for agent1.astra.lan

   Имя узла в данном примере это agent1.astra.lan.
   
   
   • Чтобы вручную отправить запрос выполнить при первом запуске на агенте:
     

     sudo puppet agent --test --waitforcert 60

     Где --test однократный запрос конфигурации с сервера,  --waitforcert 60 ожидание подписания сертификата агента сервером в течении 60 секунд.

     После отправленного вручную запроса сертификат так же необходимо подписать на сервере.
     
     

3. Повторно проверить перечень сертификатов на сервере:
   

   Signed Certificates:    master.astra.lan       (SHA256)  D0:9D:AC:79:E4:C0:23:D2:42:EC:B0:1E:A0:5B:BB:EC:D9:B0:14:90:2A:8B:E3:E1:E4:76:E6:6A:BA:9B:86:4B     alt names: ["DNS:puppet", "DNS:master.astra.lan"]   authorization extensions: [pp_cli_auth: true]    agent1.astra.lan       (SHA256)  9A:FD:EA:3D:2E:41:A5:11:A1:F7:61:6B:2E:E5:95:BD:81:63:5A:66:0D:93:D2:E0:4A:D9:81:E3:73:8F:0B:6C

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

1. Остановить службу:

   sudo systemctl stop puppet

2. Выполнить тестирование работы службы, в процессе которого служба запросит и получит сертификат:

   Info: csr_attributes file loading from /etc/puppetlabs/puppet/csr_attributes.yaml Info: Creating a new SSL certificate request for agent1.astra.lan Info: Certificate Request fingerprint (SHA256): 9A:FD:EA:3D:2E:41:A5:11:A1:F7:61:6B:2E:E5:95:BD:81:63:5A:66:0D:93:D2:E0:4A:D9:81:E3:73:8F:0B:6C Info: Downloaded certificate for agent1.astra.lan from puppet Info: Using configured environment 'production' Info: Retrieving pluginfacts Info: Retrieving plugin Info: Retrieving locales Info: Caching catalog for agent1.astra.lan Info: Applying configuration version '1568370748' Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml Notice: Applied catalog in 0.02 seconds

3. Повторно запустить службу:

   sudo systemctl start puppet

Чтобы получить информацию о нужном сертификате нужно выполнить на сервере или агенте:

• Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений:
  

  puppet agent --configprint certname <имя узла>

  
  

Перевыпуск сертификата агента

1. Удалить текущие сертификаты: 
   
   1. на агенте:
      

      sudo rm -rf /var/lib/puppet/ssl/*

      • Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений выполнить последовательно:
        

        sudo rm -rf /etc/puppetlabs/puppet/ssl/ sudo mkdir /etc/puppetlabs/puppet/ssl/

        
        
   2. на сервере:
      

      sudo puppetserver ca clean --certname <имя_узла>

      для удаления всех сертификатов применить опцию --all вместо указания имени узла.
      
      
2. Повторно запросить подпись сертификата на агенте:
   

   sudo puppet agent -tv

   Где  -tv это одноразовый запрос (test) и подробный вывод информации (verbose) соответственно.

Назначение каталогов Puppet

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

Для вывода актуальной системной директории Puppet

Ниже приведено описание основных каталогов сервера:

• /etc/puppet — основной каталог для конфигурации Puppet. Каталог содержит puppet.conf — главный конфигурационный файл Puppet, где задаются параметры работы агента и сервера;
• /var/lib/puppet/ssl — сертификаты, ключи и запросы на сертификаты для всех узлов;
• /var/log/puppetserver/ и /var/puppet/ — журналы Puppet Server и Puppet Agent соответственно;
  
• /etc/puppet/code/environments/production/manifests/ — каталог для манифестов по умолчанию. Каталог /environments позволяет группировать и независимо выполнять разные наборы манифестов, т.е. определить окружение конфигураций. 

Окружение (environment)  — это логическая группа конфигураций Puppet, которая определяет набор манифестов, модулей и данных, применяемых к определенной группе узлов (агентов).

Каждое окружение работает независимо от других. По умолчанию определено окружение на основе содержимого каталога /production . Чтобы определить новое окружение нужно:

1. Создать новый подкаталог в  /environments (например, подкалалог /testing или /development) на сервере:
   

   sudo mkdir /etc/puppet/code/environments/testing/manifests

   
   

2. Указать параметр, определяющий окружение для клиентов в основном конфигурационном файле Puppet на агентах, которым требуется отличное от основного окружение:
   

   [agent] environment = production

   
   
   • Альтернативный способ определить параметр через указание его для клиентов с определенными именами узлов в основном манифесте на сервере:
     

     node 'agent1.astra.lan' { environment = 'testing' }

Выполнение манифестов

Манифест Puppet по умолчанию — /etc/puppet/manifests/site.pp. Файл отсутствует сразу при установке и создается пользователем при настройке Puppet Server. Каталог /etc/puppet/manifests может содержать несколько файлов .pp которые определяются инструментом как единое пространство с инструкциями. 

По умолчанию синхронизация Puppet-агентов с Puppet-сервером происходит каждые 30 минут. При отклонении состояния агентов от заданного в манифестах состояния происходит выполнение заданных в них инструкций.

Чтобы изменить период обновления, нужно указать его в файле агента /etc/puppetlabs/puppet.conf, добавив параметр runinterval=<время> в секундах (900), минутах (15m) или часах (1h).

Можно использовать команду на агенте:

Вручную обновить перечень манифестов на агенте : 

Для выполнения отдельного манифеста в целях тестирования выполнить на сервере:

Манифесты Puppet имеют расширение .pp и по умолчанию создаются в каталоге /etc/puppet/code/environments/production/manifests на сервере:

• Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений:
  

  sudo nano /etc/puppetlabs/code/environments/production/manifests/test.pp

Дополнительно в инструкциях манифеста могут указываться ссылки на сценарии .sh из каталога по умолчанию /etc/puppetlabs/puppet/files. При отсутствии каталога files его необходимо создать  на сервере вручную:

• Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений:
  

  sudo mkdir /etc/puppetlabs/puppet/files

Получить список доступных для манифестов ресурсов на сервере:

Получить описание ресурса на сервере:

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

Пример создания тестового манифеста

На клиенте:

1. Проверить отсутствие ранее не созданного текстового файла:
   

   Файл не существует

2. Проверить отсутствие ранее не установленного инструмента, например tree:
   

   bash: tree: команда не найдена

На сервере:

Создать основной файл манифеста с содержимым:

# 1. Установка инструмента tree
package { 'tree':
  ensure => installed, # Убедиться, что пакет установлен
}
# 2. Создание файла /tmp/hello_puppet.txt с содержимым
file { '/tmp/hello_puppet.txt':
  ensure  => file,            # Убедиться, что это файл
  content => "Hello, Puppet!\n", # Содержимое файла
  mode    => '0644',          # Права доступа к файлу
  owner   => 'root',          # Владелец файла
  group   => 'root',          # Группа файла
}

На клиенте:

Применить тестовый манифест:

 или:

• Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений:
  

  sudo puppet apply /etc/puppetlabs/code/environments/production/manifests/test.pp

  
  

Далее повторно проверить наличие текстового файла и установленного инструмента на клиенте.

Модули Puppet

Модули Puppet позволяют повторно использовать ранее созданные решения по конфигурации узлов с помощью Puppet. Модуль Puppet представляет собой пакет, который содержит все необходимые файлы, манифесты, шаблоны и данные для достижения определенного состояния операционной системы на клиенте (например, автоматизированная установка и настройка Nginx, Apache, MySQL или других инструментов). Модули Puppet загружаются со стороннего ресурса https://forge.puppet.com/modules — централизованного хранилища готовых модулей. Модули устанавливаются только на сервере. Модули организованы в виде каталогов.

module_name/

├── manifests/          # Основные манифесты (.pp файлы)
│   └── init.pp         # Главный манифест модуля
├── files/              # Статические файлы, которые будут скопированы на узлы
├── templates/          # Шаблоны для генерации динамических файлов (обычно ERB)
├── lib/                # Пользовательские факты (facts, необходимы для описания состояний), типы и провайдеры
├── examples/           # Примеры использования модуля
├── spec/               # Тесты для модуля
└── metadata.json       # Метаданные модуля (информация о зависимости, версии и т.д.)

Работа с модулями Puppet

На сервере:

• Список установленных модулей:
  

  sudo puppet module list

  Для поиска и установки готовых сторонних модулей требуется подключение сервера к сети Интернет. Перед установкой модуля следует учитывать его совместимость с версией Puppet.

  
  
  • Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений. Поиск модуля по ключевому слову:
    

    puppet module search <ключевое_слово>

    
    
• Установка модуля:
  

  sudo puppet module install <название_модуля>

  
  
• Удаление модуля:
  

  sudo puppet module uninstall <название_модуля>

  
  

Подробная справка о работе модулей доступна по команде man puppet-module.

Пример использования модуля

Установка и настройка веб-сервера Apache с помощью модуля puppetlabs-apache:

На сервере:

1. Установить модуль:
   

   Notice: Preparing to install into /home/testadmin/.puppetlabs/etc/code/modules ... Notice: Created target directory /home/testadmin/.puppetlabs/etc/code/modules Notice: Downloading from https://forgeapi.puppet.com ... Notice: Installing -- do not interrupt ... /home/testadmin/.puppetlabs/etc/code/modules └─┬ puppetlabs-apache (v12.3.1)   ├── puppetlabs-concat (v9.1.0)   └── puppetlabs-stdlib (v9.7.0)

   
   
2. Создать манифест site.pp:
   

   node 'agent1.astra.lan' { class { 'apache': default_vhost => true, mpm_module => 'prefork', } }

   
   
3. Применить манифест на агенте:
   

   puppet apply /etc/puppet/code/environments/production/manifests/site.pp

   
   
   • Для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7) и более ранних обновлений:
     

     puppet apply /etc/puppetlabs/code/environments/production/manifests/site.pp