Skip to content
OpenShift Installation and Configuration Management
Branch: master
Clone or download
Latest commit 97e7634 Apr 23, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Remove pull request template Mar 25, 2019
.tito Update releasers.conf Feb 26, 2019
docs Update docs for scaleup and upgrade Apr 5, 2019
hack Move libvirt folder from test to hack. Mar 29, 2019
images/installer Test using Ansible 2.7.10 Apr 11, 2019
inventory Update docs for scaleup and upgrade Apr 5, 2019
playbooks Merge pull request #11338 from mtnbikenc/cleanup-docs Mar 27, 2019
roles/openshift_node Remove systemd-journal-gateway from package list Apr 22, 2019
test Merge pull request #11434 from patrickdillon/clean-up-test Apr 6, 2019
.dockerignore Rework test CI Aug 31, 2018
.flake8 Clean up tests Mar 8, 2019
.gitignore update gitignore Dec 13, 2018
.travis.yml Clean up tests Mar 8, 2019
.yamllint More toxification Jan 10, 2017 Docs update for 4.1 Mar 25, 2019 Docs update for 4.1 Mar 25, 2019
OWNERS Updating OWNERS Mar 29, 2019 #10765 Update installation doc link Apr 17, 2019 Update documentation links, -> Aug 13, 2018
openshift-ansible.spec Test using Ansible 2.7.10 Apr 11, 2019
requirements.txt Test using Ansible 2.7.10 Apr 11, 2019
setup.cfg Clean up tests Mar 8, 2019
tox.ini Clean up tests Mar 8, 2019

Join the chat at Build Status

OpenShift Ansible

This repository contains Ansible roles and playbooks for OpenShift clusters.

Previous OpenShift Ansible 3.x releases

For 3.x releases of OpenShift Ansible please reference the release branch for specific versions. The last 3.x release is 3.11 release.

OpenShift 4.x

Installation of OpenShift 4.x uses a command-line installation wizard instead of Ansible playbooks. Learn more about the OpenShift Installer in this overview.

For OpenShift 4.x, this repo only provides playbooks necessary for scaling up or upgrading RHEL hosts in an existing 4.x cluster.

The master branch tracks our current work in development.

Requirements: (localhost)

  • Ansible >= 2.7.8
  • OpenShift Client (oc)


Install an OpenShift 4.x cluster

Install a cluster using the OpenShift Installer.

Create an Ansible Inventory

Create an inventory file with the appropriate groups and variables defined. An example inventory can be found in inventory/hosts.example.

Required variables include:

  • openshift_kubeconfig_path - Path to the kubeconfig for the cluster
  • openshift_pull_secret_path - Path to the pull secret to the image registry

Run the RHEL node scaleup playbook

cd openshift-ansible
ansible-playbook -i inventory/hosts playbooks/scaleup.yml

Run the RHEL node upgrade playbook

Custom tasks can be performed during upgrades at different stages of the upgrade. See the hooks documentation for more information.

cd openshift-ansible
ansible-playbook -i inventory/hosts playbooks/upgrade.yml

Further reading

Complete Production Installation Documentation:

Containerized OpenShift Ansible

See for information on how to package openshift-ansible as a container image.


See the contribution guide.

Building openshift-ansible RPMs and container images

See the build instructions.

You can’t perform that action at this time.