utherp0 / workshop4 Goto Github PK

Investigate https://mrhaki.blogspot.com/2014/06/awesome-asciidoc-use-link-attributes.html

Include information on :

Headings
Body text
Code
Boxed text
Tables
Images
Links

Add the Etherpad install and config to the Ansible playbook

Initial playbook added but not working as it should.

Service Mesh lab has instructions to clone the github.

cd /workspace
git clone https://github.com/utherp0/workshop4.git
cd workshop4/attendee/service-mesh

Suggest these are removed as they are in the prereqs set up already. Might be confusing for the attendee.

Essentials and Innovation?

Use the JAVA example as a base

Need a number of people to go through each chapter without distraction and reading all of the text while performing the tasks to get accurate timing information for each chapter. This can be used in estimates for how long users will take to complete each step.

Update the health probes chapter to include examples of adding probes using the UK as per : https://developers.redhat.com/blog/2020/07/20/best-practices-using-health-checks-in-the-openshift-4-5-web-console/

There is an inconsistency of style across the first few labs I’ve done. Sometimes general text is bold, sometimes not. Sometimes commands are shown in separate boxes, sometimes not. The way for navigating menus also varies. This is a good place to start from, https://www.stylepedia.net/

Need to decide what style to use for body, text, instructions and code etc.

1. Small typo on page 67 - "titmed" instead of "titled"
2. When creating the probes1 project (p. 67), must specify that the user selects 'Deployment Config'

Rather than having basic and advanced courses make it a single course with a highly configurable selection method for chapters, i.e. a shopping list

An online registrations service that hands out the userx users - would be nice if:

1: We can change the password in the htpasswd secret so each user can have their own password - if we do we'd probably need to add a feature to update or reset the password in the situation a user forgets as well

2: The App should perform an SCC controlled update of the User object to add the User name metadata to the user - in order to do this the user must be logged in once, so the process would be register, log on for them, change the label, logoff.

Worth testing if this is consistent and if so simplifying the instructions

"The application has started up and will be running at the URL indicated in the output above. Copy the URL from your command window and paste it into a new browser tab. You should see an output similar to that shown below."

Lots of issues in workshops with attendees copying and pasting YAML and getting indentation errors, even when it looks right

Copy + paste button on webpages

Suggestions below

Need developer / operations / QA scenarios to be covered by the use of Argo CD. How does this fit alongside Tekton / Jenkins?

Alter the workshop material to allow branding of external customer

It would be nice if the docs could be a: personalised correctly for users (to avoid the userx issue) and b: broken down so the chapters are individual documents, similar to:

https://github.com/integr8ly/tutorial-web-app

Ensure that users create a 'standard' sandbox project at the start of the workshop and then tidy up by deleting applications as they complete a chapter.

Additional projects can the created as necessary for the RBAC and SDN (for example) and then those projects can be deleted at the end of the chapter.

Going to produce a lab which introduces the Events, Logging and Metrics

As part of the essentials/innovations I'm going to write a chapter purely around oc (with fun stuff like the jsonpath)

Intention is to add a bot as a containerised application that can be run within the cluster and serve responses to webservices that operate within the OCP cluster (i.e. the service account used to execute the app will have capabilities to act as a user in terms of project creation, RBAC setups)

Some users are confused by the instructions to create the DevEx terminal in a container and the information on the optional installation of oc locally.

There are too many command line tools to list them all with installation instructions so we should remove the optional information and expect all users to use the terminal in a container.

Change : Event Consumers can be scaled to zero when no events are following through the system.

to

Event Consumers can be scaled to zero when no events are flowing through the system.

Spelling correction : subsribe to subscribe

Cluster wide chat for virtual workshops

Send email to Bex in marketing proposing an open-enrollment DevEx workshop for a morning to act as an introduction to OpenShift.

Proposal is for a 10 person limit to ensure that the experience works well and to promote via Linked in.

May 27th Selected.

A few people have got stuck with this previously.

Under 'A Summary of Application Interactions', there is an instruction

Click on 'Workloads' and then select Pods to see the list of pods for the project as shown in the image below.

There are sometimes two 'Workloads' links - one in the left hand menu and one in the top menu, and they don't appear to do the same thing

Knative lab using the Knative CLI. This will be based around a very simple restful API

Under chapter - Application Deployment Configurations and DevOps Approaches

Goto http://basic-docs.apps.cluster-devex1-4789.devex1-4789.example.opentlc.com/#creating-the-applications

change:
git clone https://github.com/utherp0/workshop4.git
cd attendee/myholiday

to:
git clone https://github.com/utherp0/workshop4.git
cd workshop4/attendee/myholiday

The five things that you won't have to do again.

Slides created and reviewed here :

https://docs.google.com/presentation/d/1Pq0vo95mGE9ZFppdLr44nVf7S-5-hqTzC0qFpo2HpG8/edit#slide=id.g3d946fe0a1_0_0

Route management through istio and visualisation through kiali.

It appears that the Strimzi operator is now needed (if you manually add it the playbook completes). The kafka.strimzi.io/v1beta1.Kafka CRD is added by that Operator.