From d5c50f3e5cb47ee33d783f5f7ea5b9b3f2b4404f Mon Sep 17 00:00:00 2001 From: Ravi Srinivasan Date: Tue, 9 Jan 2024 18:21:08 +0530 Subject: [PATCH] added classroom instructions for partners (#33) * added classroom instructions for partners * fixed broken xref in upgrade section * updated control plane and worker node count and capacity * expanded details for filling out RHDP form --- modules/ROOT/pages/index.adoc | 45 +++++++++++++++++++-- modules/chapter1/pages/upgrading-rhods.adoc | 4 +- 2 files changed, 42 insertions(+), 7 deletions(-) diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index dfd10c7..32d23ca 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -23,18 +23,26 @@ The PTL team acknowledges the valuable contributions of the following Red Hat as * John Hurlocker * Ravi Srinivasan -== Classroom Environment +== Classroom Environment for Red Hat Associates + +Red Hat associates should use the Red Hat Demo Platform to provision a classroom. Use the https://demo.redhat.com/catalog?search=Red+Hat+OpenShift+Container+Platform+4.13+Workshop&item=babylon-catalog-prod%2Fopenshift-cnv.ocp413-wksp-cnv.prod[Red Hat OpenShift Container Platform 4.13 Workshop] catalog item from Red Hat Demo Platform (RHDP). When ordering this demo item: -* Select at least two users in the `User Count` field. -Having two users is required for the user management exercise. +* Select `Practice/Enablement` for the `Activity` field, and `Learning about the product` for the `Purpose`. + +* Leave the `Salesforce ID` blank. + +* Select *5* users in the `User Count` field. +Having at least two users is required for the user management exercise. * In the `OpenShift worker memory size` field, select `64Gi`. This size might be required if you run multiple workbenches and pipelines simultaneously. +* Review the auto-stop and auto-destroy timers. You can change this later after classroom provisioning by opening a ticket with the RHDP team. + [IMPORTANT] ==== RHOAI workbenches and pipelines use large container images. @@ -47,14 +55,23 @@ Make sure that your worker nodes have enough memory to accommodate pods that con This classroom does *NOT* have RHOAI pre-installed. You install and configure a basic RHOAI instance, and then continue using this instance with other courses in the learning path. -=== Alternative classroom environment on AWS +=== Alternative classroom environment on AWS for Red Hat Associates You can also use an AWS cluster by ordering the https://demo.redhat.com/catalog?search=AWS+with+OpenShift+Open+Environment&item=babylon-catalog-prod%2Fsandboxes-gpte.sandbox-ocp.prod[AWS with OpenShift Open Environment]. +This classroom does *NOT* have RHOAI pre-installed. +You install and configure a basic RHOAI instance, and then continue using this instance with other courses in the learning path. + If you use this item, you must: +* Select `Practice/Enablement` for the `Activity` field, and `Learning about the product` for the `Purpose`. + +* Leave the `Salesforce ID` blank. + * Make sure that you select `3` as the control plane count and `4.13` as the OpenShift version. +* Review the auto-stop and auto-destroy timers. You can change this later after classroom provisioning by opening a ticket with the RHDP team. + * Configure users and authentication. The AWS item is only preconfigured with the `kubeadmin` user, which does not have the `cluster-admin` role assigned. The exercises in this course, however, assume the existence of an `admin` user with the `cluster-admin` role and five non-admin users (`user1...user5`). @@ -70,6 +87,26 @@ $ *oc replace -f authentication.yaml* The password for the `admin` and `user1...user5` users is `openshift23`. ==== +== Classroom Environment for Red Hat Partners + +Red Hat partners should provision their own Red Hat OpenShift cluster using the Red Hat Hybrid Cloud Console at https://console.redhat.com/openshift/overview. + +* Ensure that you provision an OpenShift 4.13 cluster with a minimum of 3 control plane nodes (each with 4vCPU and 16GB RAM), and 3 worker nodes (each with 8 vCPU, and 64GB of RAM). + +* Configure users and authentication. +The exercises in this course assume the existence of an `admin` user with the `cluster-admin` role and five non-admin users (`user1...user5`). You need to create an *admin* user along with the users *user1...user5*. +To configure authentication for these users, use the sample xref:attachment$authentication.yaml[authentication.yaml] file and customize it for your environment. ++ +[subs=+quotes] +---- +$ *oc replace -f authentication.yaml* +---- + +[INFO] +==== +The password for the `admin` and `user1...user5` should be `openshift23`. +==== + == Prerequisites * Basic knowledge of OpenShift (or Kubernetes) administration diff --git a/modules/chapter1/pages/upgrading-rhods.adoc b/modules/chapter1/pages/upgrading-rhods.adoc index 9ccfc4a..8a9d99d 100644 --- a/modules/chapter1/pages/upgrading-rhods.adoc +++ b/modules/chapter1/pages/upgrading-rhods.adoc @@ -18,12 +18,10 @@ install-w6lqv rhods-operator.2.1.0 Manual true <2> <2> *Installplan* for the currently installed version. It's been approved and the version is currently installed. -Installplan is approved either automatically when a new version is available without user's intervention or requires a manual approval. Whether the approval is automatic or manual depends on the value of the xref:rhods-install-cli.adoc#subscription[installPlanApproval] attribute of the operator's subscription. When it is set to _Automatic_ the *installplan* is approved automaticaly and installation starts without user's intervention. _Manual_ value requires a manual approval. +Installplan is approved either automatically when a new version is available without user's intervention or requires a manual approval. Whether the approval is automatic or manual depends on the value of the *installPlanApproval* attribute of the operator's subscription. When it is set to _Automatic_ the *installplan* is approved automaticaly and installation starts without user's intervention. _Manual_ value requires a manual approval. Approvals can be set from the web console as well as from the CLI. -Manual approvals done from the CLI are discussed in the xref:rhods-install-cli.adoc#manual_approval[Approving Installation Manualy] section and are exactly the same as for the installation. - The following demonstration shows an upgrade with a manual approval done from the web console. == Demo: Upgrading Red{nbsp}Hat OpenShift AI