okd/README.md

#OpenShift and Atomic Enterprise Ansible

This repo contains Ansible code for OpenShift and Atomic Enterprise.

##Setup

• Install base dependencies:

  • Fedora: dnf install -y ansible rubygem-thor rubygem-parseconfig util-linux pyOpenSSL libffi-devel python-cryptography

  • OSX:

    # Install ansible and python 2
    brew install ansible python
    # Required ruby gems
    gem install thor parseconfig
    

• Setup for a specific cloud:

  • AWS
  • GCE
  • local VMs

• Bring your own host deployments:

  • OpenShift Enterprise
  • OpenShift Origin
  • Atomic Enterprise

• Build

  • How to build the openshift-ansible rpms

• Directory Structure:

  • bin/cluster - python script to easily create clusters
  • docs - Documentation for the project
  • filter_plugins/ - custom filters used to manipulate data in Ansible
  • inventory/ - houses Ansible dynamic inventory scripts
  • playbooks/ - houses host-type Ansible playbooks (launch, config, destroy, vars)
  • roles/ - shareable Ansible tasks

##Contributing

• Best Practices Guide
• Core Concepts
• Style Guide

###Feature Roadmap Our Feature Roadmap is available on the OpenShift Origin Infrastructure Trello board. All ansible items will be tagged with [installv3].