The openshift-ansible repository contains Ansible roles and playbooks for installing and configuring OpenShift clusters. Written primarily in Python, it serves as infrastructure automation tooling for Red Hat's container orchestration platform. The repository is classified across multiple domains including orchestration, cloud-native Kubernetes management, cluster management, configuration management, and DevOps automation.
The project has evolved significantly across OpenShift versions. For OpenShift 3.x clusters, the repository provides complete installation and configuration capabilities through Ansible playbooks, with the last 3.x release being version 3.11 available on the release-3.11 branch. However, for OpenShift 4.x deployments, the installation process shifted to use a command-line installation wizard provided by the separate OpenShift Installer project rather than Ansible playbooks. In the 4.x context, openshift-ansible now focuses on more limited operational tasks, specifically providing playbooks for scaling up RHEL hosts in existing clusters and upgrading RHEL nodes within established 4.x environments.
The repository requires Ansible version 2.9.5 or later and the OpenShift Client (oc) to function. Users must create an Ansible inventory file with appropriate groups and variables, with a template example provided in inventory/hosts.example. Key configuration includes specifying the openshift_kubeconfig_path variable pointing to the cluster's kubeconfig file. The project includes documentation on hooks that allow custom tasks to be executed at different stages during node upgrades, detailed in the HOOKS.md file.
Activity tracking shows the repository maintains moderate engagement with a median issue and pull request response latency of 665.8 hours across tracked items, though some responses extend significantly longer with a mean latency of 6881.9 hours. The most active issue labels indicate ongoing concerns with merge blockers and lifecycle management, with tide/merge-blocker appearing twice in tracked activity. Primary contributors and triagers include Office-Manager with four recorded events, barbacbd with three events, and jianzhangbjz with two events. The repository shares contributor overlap with related OpenShift projects including openshift/installer, openshift/coredns, and openshift/descheduler, indicating a connected ecosystem of tooling.
The master branch tracks current development work. The repository provides comprehensive documentation references pointing to official OpenShift Container Platform and OKD installation guides. Additional resources include containerization instructions in README_CONTAINER_IMAGE.md for packaging openshift-ansible as a container image, build instructions for creating RPMs and container images in BUILD.md, and contribution guidelines in CONTRIBUTING.md. The project homepage at try.openshift.com provides entry points for users exploring OpenShift deployment options.
