Foreman представляет собой продукт с открытым исходным кодом, предназначенный для помощи системным администраторам в обслуживании серверов на всём их жизненном цикле, начиная с развёртывания и конфигурирования, и включая организацию взаимодействия и мониторинг. Поддержка развёртывания упрощает настройку новых серверов, а использование систем управления конфигурациями (поддерживаются Puppet, Ansible, Chef и Salt), позволяет автоматизировать повторяющиеся задачи. Использование Foreman позволяет быстро разворачивать приложения, проактивно реагируя на изменения в виртуальных, физических и облачных системах. Foreman хорошо масштабируется как на множественные географические локации (офисы, ЦОДы и т.д.), так и на множественные организации, обеспечивая рост без потери инфраструктурного единства.

Управление Foreman возможно через web-интерфейс, интерфейс командной строки и API REST, что позволяет строить высокоуровневую бизнес-логику на  едином решении.
ForemanIt применяется в организациях, эксплуатирующих от десятков до десятков тысяч серверов.

Данная инструкция основывается на инструкции по установке от разработчиков Foreman.

Установка Foreman

1. Назначить компьютеру статический IP-адрес.
   
   

2. Если ранее не назначено, то назначить компьютеру полное доменное имя (FQDN).
   Например, theforeman.example.com:

   sudo hostnamectl set-hostname theforeman.example.com

3. Убедиться, что FQDN разрешается в IP-адрес:

   ping theforeman.example.com
   Для эксплуатации системы для разрешения имён должен быть настроен сервис DNS.
   Для тестирования можно просто внести FQDN в файл /etc/hosts, например:
   10.0.2.254 theforeman.example.com theforeman

4. Если ранее не установлен пакет ca-certificates, то установить его:


   sudo apt-get -y install ca-certificates
   


5. Подключить репозиторий Debian по инструкции

6. Добавить локаль en_US.UTF-8:

   echo en_US.UTF-8 UTF-8 | sudo tee -a /etc/locale.gen
   sudo locale-gen

7. Скачать с web-сайта производителя и установить пакет puppet:

   cd /tmp && wget https://apt.puppetlabs.com/puppet5-release-stretch.deb
   sudo dpkg -i /tmp/puppet5-release-stretch.deb
   Puppet при этом будет установлен в каталог /opt/puppetlabs/bin/puppet
   
   

8. Подключить репозиторий Foreman:

   echo "deb http://deb.theforeman.org/ stretch 1.20" | sudo tee /etc/apt/sources.list.d/foreman.list
   echo "deb http://deb.theforeman.org/ plugins 1.20" | sudo tee -a /etc/apt/sources.list.d/foreman.list
   wget -q https://deb.theforeman.org/pubkey.gpg -O- | sudo apt-key add -

9. Установить пакет foreman-installer:

   sudo apt-get update && sudo apt-get -y install foreman-installer

10. Запустить процесс инсталляции:

    sudo foreman-installer
    При запуске процесса инсталляции можно сразу указать имя и пароль администратора в параметрах запуска:
    sudo foreman-installer --foreman-admin-username  admin --foreman-admin-password   password
    Если имя и/или пароль не указаны - то имя по умолчанию admin, а пароль генерируется случайным образом (и будет показан при завершении инсталляции).
    
    Дождаться завершения процесса.
    При завершении будет выдана примерно такая диагностика:

Где:
Foreman is running at https://theforeman.example.com - адрес для входа в web-интерфейс Foremen
Initial credentials are admin / 3ekw5xtyXCoXxS29  - имя и пароль администратора

Запустить WEB-браузер и войти в WEB-интерфейс Foreman по указанному адресу для входа.