MicroShift Demos

This repo contains demos of various MicroShift features.

• hello-microshift-demo: Demonstrates a minimal RHEL for Edge with MicroShift and deploying a "Hello, MicroShift!" app on it.
• ostree-demo: Become familiar with rpm-ostree basics (image building, updates&rollbacks, etc.) and "upgrading into MicroShift".

Building demo images on a RHEL machine

Unless otherwise noted, the demos require you to build a couple of artifacts such as rpm-ostree container and ISO installer images. The build process is described below.

Start from a RHEL 9.2 or higher machine (virtual or bare metal) registered via subscription-manager and attached to a subscription that includes the OpenShift Container Platform and RHEL repos. You can add a trial evaluation for OCP at Red Hat Customer Portal - Product Downloads.

Install git if not yet installed and clone the demo repo:

git clone https://github.com/jrthms/microshift-demos.git
cd microshift-demos

Set up Image Builder and other build dependencies:

./scripts/configure-builder

Download the OpenShift pull secret from https://console.redhat.com/openshift/downloads#tool-pull-secret and copy it to $HOME/.pull-secret.json.

Build the artifacts for a given demo by running

./scripts/build $DEMONAME

whereby $DEMONAME is one of the demos in the list above, e.g. ostree-demo.

Once the build completes, you should find the demo's artefacts in builds/$DEMONAME, e.g. for the ostree-demo this will be

id_demo
id_demo.pub
ostree-demo-0.0.1-container.tar
ostree-demo-0.0.1-metadata.tar
ostree-demo-0.0.1-logs.tar
ostree-demo-0.0.2-container.tar
...
ostree-demo-installer.x86_64.iso
password

After deploying a machine with the installer, you should be able to log into it using the user microshift and the password in builds/$DEMONAME/password or via ssh with

ssh -o "IdentitiesOnly=yes" -i builds/$DEMONAME/id_demo microshift@$MACHINE_IP