OpenShift Installation and Configuration Management
Python Shell Other
Latest commit 4653f96 Feb 19, 2017 @rhcarvalho rhcarvalho committed on GitHub Merge pull request #3418 from rhcarvalho/dead-code
Remove dead code in installer
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 Merge pull request #3404 from giuseppe/do-not-fail-on-grep Feb 17, 2017
roles Merge pull request #3412 from rhcarvalho/dead-code Feb 19, 2017
test update tests and flake8/pylint fixes Nov 29, 2016
utils Remove dead code in installer Feb 19, 2017
.coveragerc More toxification Jan 10, 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
openshift-ansible.spec Add libselinux-python dependency for localhost Feb 10, 2017
requirements.txt More toxification Jan 10, 2017
setup.cfg Added to flake8 tests Jan 12, 2017 Updated the scripts for tox and virtualenv. Jan 18, 2017
test-requirements.txt More toxification Jan 10, 2017
tox.ini Updated the scripts for tox and virtualenv. Jan 18, 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.