Deploying ManageIQ on OKD

Introduction

The OKD installer includes the Ansible role openshift-management and playbooks for deploying ManageIQ (MIQ) on OKD.

The current implementation is incompatible with the Technology Preview deployment process of ManageIQ 4.5 as described in OKD 3.6 documentation.

When deploying ManageIQ on OKD, there are two major decisions to make:

  1. Do you want an external or a containerized (also referred to as podified) PostgreSQL database?

  2. Which storage class will back your persistent volumes (PVs)?

For the first decision, you can deploy ManageIQ in one of two ways, depending on the location of the PostgreSQL database to be used by ManageIQ:

Deployment VariantDescription

Fully containerized

All application services and the PostgreSQL database are run as pods on OKD.

External database

The application utilizes an externally-hosted PostgreSQL database server, while all other services are ran as pods on OKD.

For the second decision, the openshift-management role provides customization options for overriding many default deployment parameters. This includes the following storage class options to back your PVs:

Storage ClassDescription

NFS (default)

Local, on cluster

NFS External

NFS somewhere else, like a storage appliance

Cloud Provider

Use automatic storage provisioning from your cloud provider (Google Cloud Engine, Amazon Web Services, or Microsoft Azure)

Preconfigured (advanced)

Assumes you created everything ahead of time

Topics in this guide include the requirements for running ManageIQ on OKD, descriptions of the available configuration variables, and instructions on running the installer either during your initial OKD installation or after your cluster has been provisioned.