You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenShift Merge Robot 0844e92b3c
Merge pull request #11839 from mtnbikenc/retry-package
1 day ago
.github Remove pull request template 4 months ago
.tito Update releasers.conf 5 months ago
docs Update docs for scaleup and upgrade 4 months ago
hack Move libvirt folder from test to hack. 4 months ago
images/installer Install openshift RPMs based on cluster version 1 month ago
inventory Refactor openshift_node 2 months ago
playbooks Scaleup: Check new_workers for active nodes 1 month ago
roles/openshift_node Add retries to package command 2 days ago
test Merge pull request #11839 from mtnbikenc/retry-package 1 day ago
.dockerignore Rework test CI 11 months ago
.flake8 Clean up tests 5 months ago
.gitignore update gitignore 8 months ago
.pylintrc Fix ansible version checking 9 months ago
.release Branch for v3.11 1 year ago
.travis.yml Clean up tests 5 months ago
.yamllint More toxification 2 years ago
BUILD.md Docs update for 4.1 4 months ago
CONTRIBUTING.md Docs update for 4.1 4 months ago
HOOKS.md Update docs for scaleup and upgrade 4 months ago
LICENSE move LICENSE to /usr/share/licenses/openshift-ansible-VERSION/ 2 years ago
OWNERS Remove myself from OWNERS due to pending absence 3 months ago
README.md Require Ansible 2.8.2 for release-4.2 2 weeks ago
README_CONTAINER_IMAGE.md Update documentation links, docs.openshift.org -> docs.okd.io 1 year ago
ansible.cfg Add ssh retries to ansible.cfg 4 months ago
openshift-ansible.spec Require Ansible 2.8.2 for release-4.2 2 weeks ago
requirements.txt Require Ansible 2.8.2 for release-4.2 2 weeks ago
setup.cfg Remove atomic-openshift-utils 1 year ago
setup.py Update tox test environment vars 2 months ago
test-requirements.txt Clean up tests 5 months ago
tox.ini Add ANSIBLE_CONFIG to tox.ini 2 weeks ago

README.md

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

Quickstart

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

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 README_CONTAINER_IMAGE.md for information on how to package openshift-ansible as a container image.

Contributing

See the contribution guide.

Building openshift-ansible RPMs and container images

See the build instructions.