okd/README.md

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 an existing 4.x cluster with RHEL hosts.

The master branch tracks our current work in development.

Requirements:

• Ansible >= 2.7.8
• pyOpenSSL
• python2-openshift

Quickstart

Install an OpenShift 4.x cluster

Install a cluster using the OpenShift Installer.

Inventory

Create an inventory file with the new_workers group to identify the hosts which should be added to the cluster.

---
[new_workers]
mycluster-worker-0.example.com
mycluster-worker-1.example.com
mycluster-worker-2.example.com

Run the scaleup playbook

ansible-playbook playbooks/openshift_node/scaleup.yml

Further reading

Complete Production Installation Documentation:

• OpenShift Container Platform
• OpenShift Origin

Containerized OpenShift Ansible

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

Installer Hooks

See the hooks documentation.

Contributing

See the contribution guide.

Building openshift-ansible RPMs and container images

See the build instructions.