OpenShift Installation and Configuration Management
Python Shell Other
Latest commit c9563d8 Feb 20, 2017 @sdodson sdodson committed on GitHub Merge pull request #3409 from ewolinetz/logging_fix_verify_api
Adding missing handler to resolve error that it was not found
Failed to load latest commit information.
.github HTPASSWD_AUTH Jan 31, 2017
.tito Automatic commit of package [openshift-ansible] release [3.5.3-1]. Jan 31, 2017
ansible-profile Add README file to link to the upstream ansible-profile Jul 3, 2015
bin Document bin/cluster tool Jan 13, 2017
callback_plugins Add logic to verify patched version of Ansible Feb 2, 2017
docs Refactor to use Ansible package module Nov 17, 2016
filter_plugins Ansible Lint cleanup and making filter/lookup plugins used by openshi… Feb 15, 2017
inventory Merge pull request #3281 from ewolinetz/revert_3257 Feb 10, 2017
library Restructure certificate redeploy playbooks Feb 2, 2017
lookup_plugins update tests and flake8/pylint fixes Nov 29, 2016
playbooks Updating node playbooks to use oc_obj Feb 17, 2017
roles Merge pull request #3409 from ewolinetz/logging_fix_verify_api Feb 20, 2017
test update tests and flake8/pylint fixes Nov 29, 2016
utils Raise the bar on coverage requirements Feb 20, 2017
.coveragerc Raise the bar on coverage requirements Feb 20, 2017
.gitignore Add default ansible.cfg file Feb 1, 2017
.pylintrc Let pylint use as many CPUs as available Feb 10, 2017
.travis.yml update travis to use tox for utils Jan 10, 2017
.yamllint More toxification Jan 10, 2017 lies Aug 8, 2016 Document how to find dead Python code Feb 18, 2017 Fix "deloyment" typo in deployment types doc Jul 25, 2016
Dockerfile add io labels Oct 31, 2016 added documenting new hooks Jan 23, 2017
LICENSE move LICENSE to /usr/share/licenses/openshift-ansible-VERSION/ Sep 20, 2016 Added link to HOOKS in README Jan 23, 2017 Updated Dockerfile not to clone openshift-ansible repo. Aug 14, 2015 README_AWS: makes links consistent and working again Sep 29, 2016 Switch back to using etcd rather than etcd3 Dec 6, 2016 Changing formatting for issue#2244 update Jan 18, 2017 Merge pull request #1515 from fredoche/patch-1 Jul 6, 2016 Merge pull request #2734 from dougbtv/openstack_timeout_option Nov 16, 2016 Remove Vagrantfile Oct 24, 2016
ansible.cfg Add default ansible.cfg file Feb 1, 2017 Configure pytest to run tests and coverage Feb 20, 2017
openshift-ansible.spec Fix symlink to filter_plugins/ Feb 20, 2017
requirements.txt Unset exec bit in tests, add missing requirements Feb 19, 2017
setup.cfg Replace nose with pytest Feb 20, 2017 Fix validation of generated code Feb 20, 2017
test-requirements.txt Replace nose with pytest Feb 20, 2017
tox.ini Accept extra positional arguments in tox Feb 20, 2017

Join the chat at Build Status

OpenShift Ansible

This repository contains Ansible roles and playbooks to install, upgrade, and manage OpenShift clusters.

Note: the Ansible playbooks in this repository require an RPM package that provides docker. Currently, the RPMs from do not provide this requirement, though they may in the future. This limitation is being tracked by #2720.

Getting the correct version

The master branch tracks our current work in development and should be compatible with the Origin master branch (code in development).

In addition to the master branch, we maintain stable branches corresponding to upstream Origin releases, e.g.: we guarantee an openshift-ansible 3.2 release will fully support an origin 1.2 release. The most recent branch will often receive minor feature backports and fixes. Older branches will receive only critical fixes.

Getting the right openshift-ansible release

Follow this release pattern and you can't go wrong:

Origin OpenShift-Ansible
1.3 3.3
1.4 3.4
1.X 3.X

If you're running from the openshift-ansible master branch we can only guarantee compatibility with the newest origin releases in development. Use a branch corresponding to your origin version if you are not running a stable release.


  1. Install base dependencies:


    • Ansible >= 2.2.0
    • Jinja >= 2.7
    • pyOpenSSL
    • python-lxml


    dnf install -y ansible pyOpenSSL python-cryptography python-lxml
  2. Setup for a specific cloud:

Installer Hooks

See the hooks documentation.


See the contribution guide.