Puppet module for managing OpenShift - the Ansible part

Table of Contents

1. Description
2. Setup - The basics of getting started with openshift
   • What openshift affects
   • Setup requirements
   • Beginning with openshift
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Description

This Puppet module manages Ansible for setting up an OpenShift cluster with the official openshift-ansible Playbooks.

Setup

What openshift affects

The module has two "roles":

• openshift::role::ansible_master:
  • Installs Ansible
  • Checks out openshift-ansible from git
  • Configures SSH for Ansible
  • Writes the inventory file in YAML format
• openshift::role::node:
  • Installs required packages
  • Enables NetworkManager
  • Add some missing CA certificates

Setup Requirements

Required modules:

• vcsrepo
• inifile

Beginning with openshift

On the host you want to run Ansible, apply the ansible_master role and pass the inventory to it:

class { 'openshift::role::ansible_master':
  host_groups => {
    'OSEv3' => {
      children => ["nodes", "masters"],
    },
    masters => {
      vars => {
        osm_default_node_selector => "foo=bar",
      },
      hosts => {
        "master1.example.com" => {},
        "master2.example.com" => {},
      },
      children => ["etcd"],
    },
    nodes => {
      hosts => {
        "node[1:9].example.com" => {
          custom_var => true,
        },
      },
    },
  }
}

This parameters can also be configured in Hiera.

An all nodes, apply the node role:

class { 'openshift::role::node': }

Usage

Reference

Classes

Public Classes

• openshift::role::ansible_master: Installs and configures Ansible.

[host_groups] Default: {}. Hash of Ansible inventory data.

[playbooks_source] Default: https://github.com/openshift/openshift-ansible.git. Git repository where the Ansible plabooks are stored.

[playbooks_version] Default: master Git reference to check out

• openshift::role::node: Prepares node for OpenShift.

No parameters available.

Limitations

This Puppet module only runs on CentOS and RHEL.

Development

1. Fork it (https://github.com/appuio/puppet-openshift/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

CHANGELOG

v2.2.6

• Fix changelog

v2.2.5

• Accept Hash for group children

v2.2.4

• Add parameter to "openshift::role::ansible_master" class to control management of Ansible configuration (not inventory).

v2.2.3

• Enable Ansible option "show_custom_stats" to always show statistics

v2.2.1

• Quote resource "NetworkManager" so it's a string

v2.2.0

• Initial public release