foreman

Ansible Role to install and configure Foreman

Ubuntu VM in TravisCI has got issue, tested with kitchen-ansible using hyperv vagrant machine and Amazon ec2

Requirements

Foreman require hostname to be fqdn. Use Ansible hostname module to change hostname to fqdn or use the following role variable to change hostname e.g. foreman_hostname: foreman.vagrantup.com

When the install is successful, foreman can be accessed using https://foreman_fqdn with default credentials below

User: admin Password: password

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

disable_puppet: true

By default, all-in-one Foreman installation includes a Puppet master, but this can be disabled with the above parameter

Dependencies

VM (on-perm or cloud) is needed to install. Tested with the following OS -

1. Redhat Enterprise Linux 7, CentOS 7
2. Ubuntu 16.04 (Xenial), 18.04 (Bionic)
3. Debian 9

Both, PostgreSQL and MySQL supported for all above except Debian. Debian supports PostgreSQL only.

Example Playbook

- name: Install Puppet Master
  hosts: servers
  vars_files:
    - vars/main.yml
  roles:
    - role:  riponbanik.foreman
      foreman_hostname: foreman.vagrantup.com

- name: Install Chef Server
  hosts: servers
  vars_files:
    - vars/main.yml
  roles:
    - role:  riponbanik.foreman
      foreman_hostname: foreman.vagrantup.com
      foreman_version: 1.19
      foreman_plugins:
        - chef
        - tasks

- name: Install Chef Proxy
  hosts: servers
  vars_files:
    - vars/main.yml
  roles:
    - role:  riponbanik.foreman
      foreman_hostname: foreman.vagrantup.com
      foreman_version: 1.19  
      foreman_proxy_plugins:
        - chef
      foreman_proxy_plugin_options:
        chef-server-url: 'https://chef.example.com/organizations/default'
        chef-client-name: 'foreman'
        chef-private-key: '/etc/opscode/foreman.pem'
        chef-ssl-verify: 'false'

- name: Install Ansible
  hosts: servers
  vars_files:
    - vars/main.yml
  roles:
    - role:  riponbanik.foreman
      foreman_hostname: foreman.vagrantup.com
      foreman_version: 1.19  
      foreman_plugins:
        - ansible
        - remote-execution
      foreman_proxy_plugins:
        - ansible
        - remote-execution-ssh

- name: Install Ansible
  hosts: servers
  vars_files:
    - vars/main.yml
  roles:
    - role:  riponbanik.foreman
      foreman_hostname: foreman.vagrantup.com
      foreman_version: 1.19  
      foreman_compute:
        - ec2

Installation

Install the role from ansible galaxy to ansible default resarch path

sudo ansible-galaxy install riponbanik.foreman -p /etc/ansible/roles

Run the installation locally on the machine

sudo ansible-playbook -c local -i "localhost," playbook.yml

License

MIT / BSD

Refernces

Documentation is avaiable from Foreman Website [https://www.theforeman.org/]

Author Information

This role was created in 2018 by Ripon Banik. Fixes and testing in 2019 by Chris Scheible.