This repository contains Ansible roles and playbooks for OpenShift clusters.

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

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 repository 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.9.5
• OpenShift Client (oc)

Install a cluster using the OpenShift Installer.

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

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

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

• OpenShift Container Platform
• OKD (formerly OpenShift Origin)

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

See the contribution guide.

See the build instructions.