https://github.com/appuio/puppet-openshift

Simple Puppet module to manage Ansible and the OpenShift Ansible inventory
https://github.com/appuio/puppet-openshift

ansible openshift openshift-ansible puppet

Last synced: 3 months ago
JSON representation

Simple Puppet module to manage Ansible and the OpenShift Ansible inventory

• Host: GitHub
• URL: https://github.com/appuio/puppet-openshift
• Owner: appuio
• License: bsd-3-clause
• Archived: true
• Created: 2017-08-07T15:58:05.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-06-26T09:12:41.000Z (over 2 years ago)
• Last Synced: 2024-09-22T06:02:13.283Z (4 months ago)
• Topics: ansible, openshift, openshift-ansible, puppet
• Language: Puppet
• Size: 59.6 KB
• Stars: 2
• Watchers: 15
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

        
# Puppet module for managing OpenShift - the Ansible part

#### Table of Contents

1. [Description](#description)

2. [Setup - The basics of getting started with openshift](#setup)

    * [What openshift affects](#what-openshift-affects)

    * [Setup requirements](#setup-requirements)

    * [Beginning with openshift](#beginning-with-openshift)

3. [Usage - Configuration options and additional functionality](#usage)

4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)

5. [Limitations - OS compatibility, etc.](#limitations)

6. [Development - Guide for contributing to the module](#development)

## Description

This Puppet module manages Ansible for setting up an OpenShift cluster with the official

[openshift-ansible](https://github.com/openshift/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](https://forge.puppet.com/puppetlabs/vcsrepo)

* [inifile](https://forge.puppet.com/puppetlabs/inifile)

### Beginning with `openshift`

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

```puppet

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:

```puppet

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