okd/README.md

#openshift-ansible

This repo contains OpenShift Ansible code.

##Setup

• Install base dependencies:

  • Fedora: yum install -y ansible rubygem-thor rubygem-parseconfig util-linux

  • 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

• Build

  • How to build the openshift-ansible rpms

• Directory Structure:

  • bin/cluster - python script to easily create OpenShift 3 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

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