Skip to content
This repository was archived by the owner on Apr 18, 2023. It is now read-only.

README.md

Latest commit

 

History

History
74 lines (49 loc) · 3 KB

README.md

File metadata and controls

74 lines (49 loc) · 3 KB

maistra-ocp-install

Python 3.7

An installation tool for running operators and Maistra on AWS OpenShift 4.x cluster.

Introduction

This project aims to automate installation/uninstallation Maistra system on an AWS OpenShift 4.x Cluster.

The installation/uninstallation follows OpenShift Installer and istio-operator.

Versions

Name Version
OS Fedora 28+
Python 3.7+

Installation

1. Prepare

  • It is generally recommended to install packages in a virtual environment
$ python3 -m venv .env
$ source .env/bin/activate
(.env) $ pip install -r requirements.txt
  • Prepare aws configuration files or configure them from awscli
  • Save OpenShift Pull Secret content and we need that in running openshift-installer.
  • Download your private registry pull secret and create a file called "secret.yaml"

2. Environment Variables

Name Description
AWS_PROFILE AWS profile name
CR_FILE ControlPlane CR file path
  • Export the environment variables (See the table above) with their values.

3. OCP/AWS

  • Run "python main.py -h" and follow arguments help message. e.g. "python main.py -i -c ocp -d ./assets -v 4.6.17" will install an OCP 4.6.17 cluster on AWS.

  • After Deploying the cluster... starts, follow the prompts.

    • Select a SSH public key
    • Select Platform > aws
    • Select a Region
    • Select a Base Domain
    • Create a Cluster Name
    • Paste the Pull Secret content

  • Waiting for the cluster creation completes. It usually takes 40 - 50 minutes.

    When OCP installation compeleted, you should see INFO message "Install complete".

4. Maistra/Istio

  • Run "python main -h" and follow arguments help message. e.g. "python main.py -i -c istio -d ./assets" will install the Jaeger, Kiali, Service Mesh Operators from OpenShift OLM OperatorHub. After operators are running, a service mesh control plane and a memeber roll will be created.

  • Waiting for the service mesh control plane installation completes. It usually takes 10 - 15 minutes.

    When service mesh control plane installation completed, you should see message "Installed=True, reason=InstallSuccessful"

Uninstallation

  • Follow the Installation section and replace argument -i with -u for each component.

License

Maistra maistra-ocp-install is Apache 2.0 licensed