Intro

The intention of this repository is to help support practical use of OpenShift for workloads and provide a collection of configurations / demos / workshops.

Please look at the GitOps Catalog if you only need to automate an operator install.

In this repo, look at various kustomized configs and argo apps for ideas.

For issues with oc apply -k see the known issues section below.

Prerequisites - Get a cluster

• OpenShift 4.16+
  • role: cluster-admin - for all demo or cluster configs
  • role: self-provisioner - for namespaced components

Red Hat Demo Platform Options (Tested)

NOTE: The node sizes below are the recommended minimum to select for provisioning

• AWS with OpenShift Open Environment
  • 1 x Control Plane - m6a.2xlarge
  • 0 x Workers - m6a.2xlarge
• One Node OpenShift
  • 1 x Control Plane - m6a.2xlarge
• MLOps Demo: Data Science & Edge Practice

Getting Started

Install the OpenShift Web Terminal

The following icon should appear in the top right of the OpenShift web console after you have installed the operator. Clicking this icon launches the web terminal.

NOTE: Reload the page in your browser if you do not see the icon after installing the operator.

Make the enhanced web terminal permanent

# apply the enhanced web terminal
oc apply -k https://github.com/redhat-na-ssa/demo-ai-gitops-catalog/demos/components/install-web-terminal

# delete old web terminal
$(wtoctl | grep 'oc delete')

Enhance the terminal for one time use (ephemeral)

# bootstrap the enhanced web terminal
YOLO_URL=https://raw.githubusercontent.com/redhat-na-ssa/demo-ai-gitops-catalog/main/scripts/library/term.sh

. <(curl -s "${YOLO_URL}")

term_init

NOTE: open a new terminal to full activate the new configuration

---

ALTERNATIVE - Use a local environment / shell

1. Verify you are logged into your cluster using oc.
2. Clone this repository

NOTE: See the tools section below for more info

# verify oc login
oc whoami

# git clone this repo
git clone https://github.com/redhat-na-ssa/demo-ai-gitops-catalog
cd demo-ai-gitops-catalog

# load functions into a bash shell
. scripts/functions.sh

Apply Configurations / Demos

Setup basic cluster config

until oc apply -k demo/default; do : ; done

Development

Tools

The following cli tools are required:

• bash, git
• oc - Download mac, linux, windows
• kubectl (optional) - Included in oc bundle
• kustomize (optional) - Download mac, linux

NOTE: bash, git, and oc are available in the OpenShift Web Terminal

The following are used to encrypt secrets and are optional:

• age - Info
• sops - Info

Contributing

Please run the following before submitting a PR / commit

scripts/lint.sh

Additional Info

Internal Docs

• Local Docs
• Notes Dump

External Links

General

• GitOps Catalog
• Helm Chart Catalog
• Enhanced Web Terminal Container
• OpenShift - Automation

ArgoCD

• ArgoCD - Example
• ArgoCD - Patterns