Using GitOps to control and customize your OpenShift clusters and applications

Lab Environment Setup

Using RHPD (demo.redhat.com)

This lab is designed to use environments provided by this catalog item on demo.redhat.com. Provision that catalog item with the workshop interface enabled, then direct your users to the instructions at this link!

Using your own Environment

An Ansible role/task that performs much of the necessary setup can be found at this link.

1. This is a single-tenant lab. Each lab attendee requires their own OpenShift cluster.

2. The lab is tested with clusters running OpenShift 4.12, that have the stable channel of both the Web Terminal and Red Hat OpenShift GitOps operators installed in their default configurations.

3. After installing the Web Terminal operator, edit the DevWorkspaceTemplate resource named web-terminal-tooling in the openshift-operators Namespace to use the following image: quay.io/evanshortiss/summit-2023-web-terminal-tooling:latest.

4. Lab attendees must have access to a user with cluster-admin permissions. In the instructions this is the opentlc-mgr that’s provided by the htpasswd OAuth identity provider. You can read more about identity providers in the OpenShift Documentation.

5. Lab users must have access to a foo user with no assigned permissions, and the password foopassword. In the lab instructions this is provided by the standard-users OAuth provider.

Develop and Host the Lab Guide

This is only necessary if the hosted version available at redhat-scholars.github.io/summit-2023-gitops-lab-guide isn’t accessible, or needs tweaks for your lab.

Local Guide Development Build

Build and view the lab guide locally using Docker/Podman:

podman build -t localhost/summit-2023-gitops-lab-guide .
podman run --rm --name guides -d -p 4000:8080 localhost/summit-2023-gitops-lab-guide

Build and Deploy Guide on OpenShift

Deploy the lab guide on OpenShift using the oc CLI:

oc new-app https://github.com/redhat-scholars/summit-2023-gitops-lab-guide --strategy=docker
oc create route edge summit-2023-gitops-lab-guide --service=summit-2023-gitops-lab-guide
# To rebuild after changes pushed to git
oc start-build summit-2023-gitops-lab-guide --follow