OpenShift Ansible Code
Python Shell Other
Switch branches/tags
v3.0.2-2 v3.0.2-1 v3.0.1-1 v3.0.0 v3.0.0-rc v3.0.0-8 v3.0.0-7 v3.0.0-6 v3.0.0-5 v3.0.0-4 v3.0.0-3 v3.0.0-2 v3.0.0-1 openshift-ansible-3.3.0-1 openshift-ansible-3.2.4-1 openshift-ansible-3.2.3-1 openshift-ansible-3.2.2-1 openshift-ansible-3.2.1-1 openshift-ansible-3.2.0-1 openshift-ansible-3.0.97-1 openshift-ansible-3.0.96-1 openshift-ansible-3.0.95-1 openshift-ansible-3.0.94-1 openshift-ansible-3.0.93-1 openshift-ansible-3.0.92-1 openshift-ansible-3.0.90-1 openshift-ansible-3.0.89-1 openshift-ansible-3.0.88-1 openshift-ansible-3.0.87-1 openshift-ansible-3.0.86-1 openshift-ansible-3.0.85-1 openshift-ansible-3.0.84-1 openshift-ansible-3.0.83-1 openshift-ansible-3.0.82-1 openshift-ansible-3.0.81-1 openshift-ansible-3.0.80-1 openshift-ansible-3.0.79-1 openshift-ansible-3.0.78-1 openshift-ansible-3.0.77-1 openshift-ansible-3.0.76-1 openshift-ansible-3.0.75-1 openshift-ansible-3.0.74-1 openshift-ansible-3.0.73-1 openshift-ansible-3.0.72-1 openshift-ansible-3.0.71-1 openshift-ansible-3.0.70-1 openshift-ansible-3.0.69-1 openshift-ansible-3.0.68-1 openshift-ansible-3.0.67-1 openshift-ansible-3.0.66-1 openshift-ansible-3.0.65-1 openshift-ansible-3.0.64-1 openshift-ansible-3.0.63-1 openshift-ansible-3.0.62-1 openshift-ansible-3.0.61-1 openshift-ansible-3.0.60-1 openshift-ansible-3.0.59-1 openshift-ansible-3.0.58-1 openshift-ansible-3.0.57-1 openshift-ansible-3.0.56-1 openshift-ansible-3.0.55-1 openshift-ansible-3.0.54-1 openshift-ansible-3.0.53-1 openshift-ansible-3.0.52-1 openshift-ansible-3.0.51-1 openshift-ansible-3.0.50-1 openshift-ansible-3.0.49-1 openshift-ansible-3.0.48-1 openshift-ansible-3.0.47-6 openshift-ansible-3.0.47-1 openshift-ansible-3.0.46-1 openshift-ansible-3.0.45-1 openshift-ansible-3.0.44-1 openshift-ansible-3.0.43-1 openshift-ansible-3.0.42-1 openshift-ansible-3.0.41-1 openshift-ansible-3.0.40-1 openshift-ansible-3.0.39-1 openshift-ansible-3.0.38-1 openshift-ansible-3.0.37-1 openshift-ansible-3.0.36-1 openshift-ansible-3.0.35-1 openshift-ansible-3.0.34-1 openshift-ansible-3.0.33-1 openshift-ansible-3.0.32-1 openshift-ansible-3.0.31-1 openshift-ansible-3.0.30-1 openshift-ansible-3.0.29-1 openshift-ansible-3.0.28-1 openshift-ansible-3.0.27-1 openshift-ansible-3.0.26-1 openshift-ansible-3.0.25-1 openshift-ansible-3.0.24-1 openshift-ansible-3.0.23-1 openshift-ansible-3.0.22-1 openshift-ansible-3.0.21-1 openshift-ansible-3.0.20-1 openshift-ansible-3.0.19-1 openshift-ansible-3.0.18-1 openshift-ansible-3.0.17-1
Nothing to show
Pull request Compare This branch is 538 commits behind openshift:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
.tito
ansible-profile
callback_plugins
docs
examples
filter_plugins
hack
images/installer
inventory
library
lookup_plugins
playbooks
roles
test
utils
.coveragerc
.dockerignore
.flake8
.gitignore
.papr.inventory
.papr.sh
.papr.yml
.pylintrc
.travis.yml
.yamllint
BUILD.md
CONTRIBUTING.md
DEPLOYMENT_TYPES.md
HOOKS.md
LICENSE
README.md
README_CONTAINERIZED_INSTALLATION.md
README_CONTAINER_IMAGE.md
ansible.cfg
conftest.py
openshift-ansible.spec
pytest.ini
requirements.txt
setup.cfg
setup.py
test-requirements.txt
tox.ini

README.md

Join the chat at https://gitter.im/openshift/openshift-ansible Build Status Coverage Status

OpenShift Ansible

This repository contains Ansible roles and playbooks to install, upgrade, and manage OpenShift clusters.

Note: the Ansible playbooks in this repository require an RPM package that provides docker. Currently, the RPMs from dockerproject.org do not provide this requirement, though they may in the future. This limitation is being tracked by #2720.

Getting the correct version

The master branch tracks our current work in development and should be compatible with the Origin master branch (code in development).

In addition to the master branch, we maintain stable branches corresponding to upstream Origin releases, e.g.: we guarantee an openshift-ansible 3.2 release will fully support an origin 1.2 release. The most recent branch will often receive minor feature backports and fixes. Older branches will receive only critical fixes.

Getting the right openshift-ansible release

Follow this release pattern and you can't go wrong:

Origin/OCP OpenShift-Ansible version openshift-ansible branch
1.3 / 3.3 3.3 release-1.3
1.4 / 3.4 3.4 release-1.4
1.5 / 3.5 3.5 release-1.5
3.X 3.X release-3.x

If you're running from the openshift-ansible master branch we can only guarantee compatibility with the newest origin releases in development. Use a branch corresponding to your origin version if you are not running a stable release.

Setup

  1. Install base dependencies:


    Requirements:

    • Ansible >= 2.3.0.0
    • Jinja >= 2.7
    • pyOpenSSL
    • python-lxml

    Fedora:

    dnf install -y ansible pyOpenSSL python-cryptography python-lxml
    
  2. OpenShift Installation Documentation:

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.