Skip to content

Review Done #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 2, 2025
Merged

Review Done #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
54e65cf
Review Done
sarveshpandit May 2, 2025
0f1fb53
Use a carret for links that open new browser window
flozanorht May 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 21 additions & 15 deletions modules/ROOT/pages/index.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ It is part of a Red Hat Device Learning path, which currently includes three cou

* For customers using RHEL for Edge and RPM-OSTree based edge images:
** https://redhatquickcourses.github.io/rhde-build/[Building Red Hat Device Edge Images^]
** https://redhatquickcourses.github.io/rhde-microshift/[Deploying MicroShift on Red Hat Device Edge Quick Course]
** https://redhatquickcourses.github.io/rhde-microshift/[Deploying MicroShift on Red Hat Device Edge Quick Course^]

* For customers using RHEL image mode:
** *Deploying MicroShift on RHEL Image Mode* (this course)
Expand All @@ -33,9 +33,9 @@ Red Hat and Partner roles that support Red Hat Device Edge on customers, such as

== Prerequisites

* Attend the RHEL labs https://www.redhat.com/en/introduction-to-image-mode-for-red-hat-enterprise-linux-interactive-lab[Introduction to image mode for Red Hat Enterprise Linux] and https://www.redhat.com/en/day-2-operations-with-image-mode-for-red-hat-enterprise-linux[Day 2 operations with image mode for Red Hat Enterprise Linux], or have equivalent experience with RHEL image mode.
* Familiarity with RHEL system administration, to the level of https://www.redhat.com/en/services/certification/rhcsa[Red Hat Certified System Administrator (RHCSA)] or equivalent knowledge.
* Familiarity with OpenShift administration, to the level of https://www.redhat.com/en/services/certification/rhcs-paas[Red Hat Certified OpenShift Administrator] or equivalent knowledge.
* Attend the RHEL labs https://www.redhat.com/en/introduction-to-image-mode-for-red-hat-enterprise-linux-interactive-lab[Introduction to image mode for Red Hat Enterprise Linux^] and https://www.redhat.com/en/day-2-operations-with-image-mode-for-red-hat-enterprise-linux[Day 2 operations with image mode for Red Hat Enterprise Linux^], or have equivalent experience with RHEL image mode.
* Familiarity with RHEL system administration, to the level of https://www.redhat.com/en/services/certification/rhcsa[Red Hat Certified System Administrator (RHCSA)^] or equivalent knowledge.
* Familiarity with OpenShift administration, to the level of https://www.redhat.com/en/services/certification/rhcs-paas[Red Hat Certified OpenShift Administrator^] or equivalent knowledge.
* Familiarity with Ansible playbooks and the Ansible Automation Platform is useful but not required.
* Familiarity with web server administration, such as Apache Web Server or NGinx, is useful but not required.
* Familiarity with database server administration, such as MySQL or MariaDB, is useful but not required.
Expand All @@ -44,40 +44,46 @@ Red Hat and Partner roles that support Red Hat Device Edge on customers, such as

You can perform all activities in this course using the virtual classroom lab from *HOL014: Red Hat Device Edge Quick Course Series*, which is shared by all Red Hat Device Edge quick courses and will be updated as required by future related courses.

WARNING: The current released version of HOL014 does NOT contain container images required by image mode. You have to manually copy the required images to the mirror registry, if you want to try the WIP course activities. HOL014 will be updated as part of releasing this quick course for general availability.
WARNING: The current released version of HOL014 does NOT contain container images required by image mode.
You have to manually copy the required images to the mirror registry, if you want to try the WIP course activities.
HOL014 will be updated as part of releasing this quick course for general availability.

Use the following links to access the virtual classroom lab on Red Hat Online Learning (ROLE):

* https://role.rhu.redhat.com/rol-rhu/app/courses/hol014-9.5/pages/pr01[HOL014 for Red Hat employees^].
* https://rol.redhat.com/rol/app/courses/hol014-9.5/pages/pr01[HOL014 for Red Hat partners and customers^] with a *Red Hat Learning Subscription*.

After you enter HOL014 on ROLE, follow the instructions there to create a new course classroom lab and access its virtual machines. If you already created a HOL014 classroom for another Red Hat Device Edge quick course, you can continue using the same classroom lab.
After you enter HOL014 on ROLE, follow the instructions there to create a new course classroom lab and access its virtual machines.
If you already created a HOL014 classroom for another Red Hat Device Edge quick course, you can continue using the same classroom lab.

Beware that ROLE classrooms have timers after which classroom labs are stopped and deleted, to conserve compute resources. If you plan to use the same classroom lab for multiple Red Hat Device Edge quick courses, do not wait too long to continue. You do not need to use the same classroom for multiple courses: each course provides step-by-step instructions to start from either a new classroom lab or to continue from an existing classroom lab.
Beware that ROLE classrooms have timers after which classroom labs are stopped and deleted, to conserve compute resources.
If you plan to use the same classroom lab for multiple Red Hat Device Edge quick courses, do not wait too long to continue.
You do not need to use the same classroom for multiple courses: each course provides step-by-step instructions to start from either a new classroom lab or to continue from an existing classroom lab.

You will follow this quick course by alternating between two browser windows: one to navigate quick course materials, such as this page; and another to access the virtual classroom lab, to perform hands-on activities.

If you can provision your own RHEL servers or VMs, it should be possible to configure all that is required for the hands-on activities by using a https://developers.redhat.com/products/rhel/download[free subscription] from the https://developers.redhat.com/about[Red Hat Developer Program], which gives access to RHEL installation media, RHEL package repositories, OpenShift package repositories, and OpenShift container images in Red Hat registries.
If you can provision your own RHEL servers or VMs, it should be possible to configure all that is required for the hands-on activities by using a https://developers.redhat.com/products/rhel/download[free subscription^] from the https://developers.redhat.com/about[Red Hat Developer Program^], which gives access to RHEL installation media, RHEL package repositories, OpenShift package repositories, and OpenShift container images in Red Hat registries.

== About Red Hat Online Learning (ROLE) and Red Hat Learning Subscription

The Red Hat Online Learning (ROLE) web site provides https://www.redhat.com/en/services/training-and-certification[Red Hat Training and Certification] course materials and their virtual classrooms labs. You must be enrolled in a Red Hat Training course or subscription to have access to ROLE.
The Red Hat Online Learning (ROLE) web site provides https://www.redhat.com/en/services/training-and-certification[Red Hat Training and Certification^] course materials and their virtual classrooms labs.
You must be enrolled in a Red Hat Training course or subscription to have access to ROLE.

NOTE: The Red Hat Device Edge Quick Courses Series use ROLE for its virtual classroom labs only, and hosts courses materials outside of ROLE, as GitHub pages.

A basic https://www.redhat.com/en/services/training/learning-subscription[Red Hat Learning Subscription] offers access to a number Red Hat Training courses and virtual classroom lab time. Higher subscription tiers offer additional benefits such as Red Hat Certification Exam vouchers.
A basic https://www.redhat.com/en/services/training/learning-subscription[Red Hat Learning Subscription^] offers access to a number Red Hat Training courses and virtual classroom lab time. Higher subscription tiers offer additional benefits such as Red Hat Certification Exam vouchers.

== Other Sources of Information About MicroShift

The main source is the https://docs.redhat.com/en/documentation/red_hat_build_of_microshift/4.17[product documentation for MicroShift] in Red Hat's documentation portal.
The main source is the https://docs.redhat.com/en/documentation/red_hat_build_of_microshift/4.17[product documentation for MicroShift^] in Red Hat's documentation portal.

We also recommend that you use the product documentation for https://docs.redhat.com/en/documentation/openshift_container_platform/4.17[Red Hat OpenShift Container Platform] for general Kubernetes topics, OpenShift extension APIs, and add-on operators which may be supported in MicroShift.
We also recommend that you use the product documentation for https://docs.redhat.com/en/documentation/openshift_container_platform/4.17[Red Hat OpenShift Container Platform^] for general Kubernetes topics, OpenShift extension APIs, and add-on operators which may be supported in MicroShift.

The Red Hat Build of MicroShift is supported as part of Red Hat Device Edge, check its https://docs.redhat.com/en/documentation/red_hat_device_edge/4/html/overview/index[overview document] for pointers to MicroShift, RHEL for Edge, and other components of Red Hat Device Edge.
The Red Hat Build of MicroShift is supported as part of Red Hat Device Edge, check its https://docs.redhat.com/en/documentation/red_hat_device_edge/4/html/overview/index[overview document^] for pointers to MicroShift, RHEL for Edge, and other components of Red Hat Device Edge.

For documentation about RHEL image mode, see the https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html-single/using_image_mode_for_rhel_to_build_deploy_and_manage_operating_systems/index[RHEL product documentation].
For documentation about RHEL image mode, see the https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html-single/using_image_mode_for_rhel_to_build_deploy_and_manage_operating_systems/index[RHEL product documentation^].

It is not expected that you need to use the https://microshift.io/[open source upstream] of MicroShift and its community documentation for day to day use of the Red Hat Build of MicroShift.
It is not expected that you need to use the https://microshift.io/[open source upstream^] of MicroShift and its community documentation for day to day use of the Red Hat Build of MicroShift.

== Author

Expand Down
3 changes: 2 additions & 1 deletion modules/ch1-microshift/pages/index.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ IMPORTANT: Pending review of content that is specific to RHEL for Edge.

== Introduction

This chapter introduces MicroShift as part of both Red Hat Device Edge and Red Hat OpenShift families of products. It offers an overview of which components are shared between MicroShift and OpenShift, which components are unique to MicroShift, and which components of OpenShift are not supported in MicroShift.
This chapter introduces MicroShift as part of both Red Hat Device Edge and Red Hat OpenShift families of products.
It offers an overview of which components are shared between MicroShift and OpenShift, which components are unique to MicroShift, and which components of OpenShift are not supported in MicroShift.

The hands-on activities prepare a virtual labs environment with all prerequisites required to deploy MicroShift on either traditional RHEL, also known as package-based RHEL and RHEL for Edge systems.
16 changes: 10 additions & 6 deletions modules/ch1-microshift/pages/s2-prepare-lab.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ WARNING: Pending Review

// Minimally changed from rhde-microshift to remove references to ostree

You need a few machines to perform the hands-on activities in this course.
You need a few machines to perform the hands-on activities in this course.

* A _development machine_ with RHEL and unrestricted `sudo`, where you will create test VMs using Libvirt, and also run the OpenShift client to access your MicroShift instances in other machines.

Expand All @@ -24,17 +24,21 @@ You need a few machines to perform the hands-on activities in this course.

* A _web server machine_ with RHEL and unrestricted `sudo`, to share files such as public keys.

* A _mirror registry machine_ with RHEL and unrestricted `sudo`, to host a https://www.redhat.com/en/blog/introducing-mirror-registry-for-red-hat-openshift[mirror registry for Red Hat OpenShift].
* A _mirror registry machine_ with RHEL and unrestricted `sudo`, to host a https://www.redhat.com/en/blog/introducing-mirror-registry-for-red-hat-openshift[mirror registry for Red Hat OpenShift^].

These instructions were tested on RHEL 9.5 but should work with minimal or no change on newer and older RHEL 9.x releases.

If you are using the course environment, you will log in to the `workstation` VM as the user `student` with password `student`. The `workstation` VM is your _development machine_. You will start SSH sessions from the `workstation` VM to the `servera` VM, which is your _web server machine_ and also your _mirror registry machine_, using the same user.
If you are using the course environment, you will log in to the `workstation` VM as the user `student` with password `student`.
The `workstation` VM is your _development machine_.
You will start SSH sessions from the `workstation` VM to the `servera` VM, which is your _web server machine_ and also your _mirror registry machine_, using the same user.

IMPORTANT: Be sure you execute each step on the correct machine. If a step is not explicit about the machine it should be performed, it is using the same machine as its previous step.
IMPORTANT: Be sure you execute each step on the correct machine.
If a step is not explicit about the machine it should be performed, it is using the same machine as its previous step.

In the course environment, the `classroom` VM, with the `materials` alias, is your _package server machine_ but you are _not_ expected to start SSH sessions nor perform any activity on it.

NOTE: It should be possible to perform all activities in this course using a https://developers.redhat.com/products/rhel/download[free Red Hat Developers free subscription], which gives you access to installation media, RPM packages, and container images for RHEL and Red Hat OpenShift. If you ignore the requirements for air-gaped installation of MicroShift, you could use a single RHEL VM and adapt the steps to your own environment.
NOTE: It should be possible to perform all activities in this course using a https://developers.redhat.com/products/rhel/download[free Red Hat Developers free subscription^], which gives you access to installation media, RPM packages, and container images for RHEL and Red Hat OpenShift.
If you ignore the requirements for air-gaped installation of MicroShift, you could use a single RHEL VM and adapt the steps to your own environment.

== Instructions

Expand All @@ -44,7 +48,7 @@ include::rhde-microshift:ch1-microshift:partial$s2-prepare-lab-libvirt.adoc[]

include::rhde-microshift:ch1-microshift:partial$s2-prepare-lab-apache.adoc[]

You now have your _development machine_ ready to test bootc containers using Libvirt VMs, and your _web server machine_ ready to store and distribute files for your edge devices.
You now have your _development machine_ ready to test bootc containers using Libvirt VMs, and your _web server machine_ ready to store and distribute files for your edge devices.

== What's Next

Expand Down
34 changes: 20 additions & 14 deletions modules/ch1-microshift/pages/s3-air-gapped-lab.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ WARNING: Work In Progress.

== Before you Begin

You need a few machines to perform the hands-on activities in this course.
You need a few machines to perform the hands-on activities in this course.

* A _development machine_ with RHEL and unrestricted `sudo`, where you will create test VMs using Libvirt, and also run the OpenShift client to access your MicroShift instances in other machines.

Expand All @@ -22,17 +22,21 @@ You need a few machines to perform the hands-on activities in this course.

* A _web server machine_ with RHEL and unrestricted `sudo`, to share files such as public keys.

* A _mirror registry machine_ with RHEL and unrestricted `sudo`, to host a https://www.redhat.com/en/blog/introducing-mirror-registry-for-red-hat-openshift[mirror registry for Red Hat OpenShift].
* A _mirror registry machine_ with RHEL and unrestricted `sudo`, to host a https://www.redhat.com/en/blog/introducing-mirror-registry-for-red-hat-openshift[mirror registry for Red Hat OpenShift^].

These instructions were tested on RHEL 9.5 but should work with minimal or no change on newer and older RHEL 9.x releases.

If you are using the course environment, you will log in to the `workstation` VM as the user `student` with password `student`. The `workstation` VM is your _development machine_. You will start SSH sessions from the `workstation` VM to the `servera` VM, which is your _web server machine_ and also your _mirror registry machine_, using the same user.
If you are using the course environment, you will log in to the `workstation` VM as the user `student` with password `student`.
The `workstation` VM is your _development machine_.
You will start SSH sessions from the `workstation` VM to the `servera` VM, which is your _web server machine_ and also your _mirror registry machine_, using the same user.

IMPORTANT: Be sure you execute each step on the correct machine. If a step is not explicit about the machine it should be performed, it is using the same machine as its previous step.
IMPORTANT: Be sure you execute each step on the correct machine.
If a step is not explicit about the machine it should be performed, it is using the same machine as its previous step.

In the course environment, the `classroom` VM, with the `materials` alias, is your _package server machine_ but you are _not_ expected to start SSH sessions nor perform any activity on it.

NOTE: It should be possible to perform all activities in this course using a https://developers.redhat.com/products/rhel/download[free Red Hat Developers free subscrition], which gives you access to installation media, RPM packages, and container images for RHEL and Red Hat OpenShift. If you ignore the requirements for air-gaped installation of MicroShift, you could use a single RHEL VM and adapt the steps to your own environment.
NOTE: It should be possible to perform all activities in this course using a https://developers.redhat.com/products/rhel/download[free Red Hat Developers free subscrition^], which gives you access to installation media, RPM packages, and container images for RHEL and Red Hat OpenShift.
If you ignore the requirements for air-gaped installation of MicroShift, you could use a single RHEL VM and adapt the steps to your own environment.

== Instructions

Expand All @@ -52,15 +56,17 @@ $ *ls bootc-containers/rhel9/*
bootc-image-builder:9.5 rhel-bootc:9.5
--

.. Download the bootc images upload script. It is very similar to the application images upload script.
.. Download the bootc images upload script.
It is very similar to the application images upload script.

+
[source,subs="verbatim,quotes"]
--
$ *wget -q https://raw.githubusercontent.com/RedHatQuickCourses/rhde-build-samples/refs/heads/main/sh/upload-bootc.sh*
--

.. Run the application images upload script. Check carefully that its output does not indicate any errors.
.. Run the application images upload script.
Review carefully that its output does not indicate any errors.

+
[source,subs="verbatim,quotes"]
Expand All @@ -74,13 +80,13 @@ $ *sh upload-bootc.sh*
--
$ *podman search servera.lab.example.com:8443/*
NAME DESCRIPTION
servera.lab.example.com:8443/lvms4/lvms-rhel9-operator
servera.lab.example.com:8443/openshift-release-dev/ocp-v4.0-art-dev
servera.lab.example.com:8443/flozanorht/php-ubi
servera.lab.example.com:8443/rhel9/mysql-80
servera.lab.example.com:8443/ubi9/ubi
servera.lab.example.com:8443/rhel9/rhel-bootc
servera.lab.example.com:8443/rhel9/bootc-image-builder
servera.lab.example.com:8443/lvms4/lvms-rhel9-operator
servera.lab.example.com:8443/openshift-release-dev/ocp-v4.0-art-dev
servera.lab.example.com:8443/flozanorht/php-ubi
servera.lab.example.com:8443/rhel9/mysql-80
servera.lab.example.com:8443/ubi9/ubi
servera.lab.example.com:8443/rhel9/rhel-bootc
servera.lab.example.com:8443/rhel9/bootc-image-builder
--

include::rhde-microshift:ch1-microshift:partial$s3-air-gapped-lab-dnf.adoc[]
Expand Down
Loading