okd/README.md

#OpenShift Ansible

This repo contains Ansible code for OpenShift. This repo and the origin RPMs that it installs currently require a package that provides docker. Currently the RPMs provided from dockerproject.org do not provide this requirement, though they may in the future.

##Setup

• Install base dependencies:

  • Fedora: dnf install -y ansible-1.9.4 pyOpenSSL python-cryptography

  • OSX:

    # Install ansible 1.9.4 and python 2
    brew install ansible python
    

• 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