bcdevops / devops-platform-workshops

OCP Training Workshop Material and Labs

OpenShift 101

• Slide deck
• Lab Exercises

OpenShift 201

• Slide deck
• Lab Exercises

devops-platform-workshops's Issues

101 Lab Questions/Bugs

Lab Questions or Bugs

It looks like some of the yaml scripting tags are not processing correctly in the Persistent Configurations

Information for debugging

• namespace(s):
• link to lab slide: https://ocp101-labs-lab-pilot-ocp101-labs-pilot-tools.apps.platform-services.aro.devops.gov.bc.ca/openshift101/10_persistent_configurations.html

Error Messages or Screen Shots

In the Deployment Lab, add a reminder that BuildConfig is in the tools project

OCP101 Labs - Resoure Requests Limits incorrect image

the image for the lab is a mongodb pod although its talking about rc pods.

OCP101 comparison and alignment with MOU

Review the language and descriptions in the Memorandum of understand, and look for opportunities to align the language and content in [OCP101 deck] (https://app.mural.co/invitation/mural/platformservices5977/1646945371597?sender=uf0df5317d8dbea9ee48c7230&key=53ce5618-7a78-4548-b12c-c3495babe255).

Definition of done

• Review MOU
• Make any changes necessary to align OCP101 content with MOU

Migrate OCP101 content from Miro to Mural

Duplicate OCP101 content from Miro OCP 101 Deck into a Mural Deck

Miro only exports slides as images or PDFs, so text and graphics must be recreated allow editing in Mural.

Definition of done:

• Mural deck is ready to use for OCP101 Workshop delivery
• New deck retains all previous information and functionality, check off with team

OCP 201 Lab: Kibana Logging Auth Error

Please add auth troubleshooting SO answer to: https://github.com/BCDevOps/devops-platform-workshops/blob/master/openshift-201/logging.md

SO link: https://stackoverflow.developer.gov.bc.ca/questions/118

Update the route section

Make it clear that user should open the URL exposed by the route and refresh it, not the route page itself.

101 Lab Questions/Bugs

Lab Questions or Bugs

In the Deployment section, under General, when another application exists, it defaults to adding the new deployment to that application. It is not clear in the documentation if everything should be created under a single app or a new one should be created.

Information for debugging

• namespace(s): ocp101-labs-pilot-dev
• link to lab slide: https://ocp101-labs-lab-pilot-ocp101-labs-pilot-tools.apps.platform-services.aro.devops.gov.bc.ca/openshift101/03_deployment.html

Error Messages or Screen Shots

Provide Complete Template for RocketChat + MongoDb

OCP 201: Outreach to Community

Summary

In the effort of a new 201 course we are reaching out to the community to see what the majority wants to see in the workshop. The workshop will undoubtedly cover concepts of CI/CD and how it integrates into our platform services such as Sysdig/Aqua etc.

To Do

• send a correspondence to the community via most likely survey but will need to confer with Martha.
• receive feedback from community and covert it into a small report here so that it is easily consumed.

oc export <...> is deprecated

found in workshop lab 07_persistent_configurations.html

oc export secret rocketchat-sheastewart-secret -o yaml

System Set Up , CA Certificates Unable to Install

CA Certificates During System Set Up

Unable to Download and Install the CA Certificates for openshift-cli

I am preparing for the upcoming Openshift 101 training. During the system set up, I was unable to move forward because I got an error shown in the attached snip. While I tried to read the details in sslcerts documents, do not understand and was unable to solve. I installed the system into my office workstation which is in the bc government network. Your support would be appreciated. Thanks and looking forward to hearing from you.

Error Messages or Screen Shots

OCP101 Lab Playbook

This issue tracks the steps needed to run an ocp101 lab. We will want to transfer any info here into an actual playbook (a markdown file) and store in this repo.

Scheduling

The lab is held over two weeks. Attendees are given a set of namespaces to work with. The lab material itself should take 2 to 6 hours to complete.

Day 1

• Introduce the Lab
  • explain the goal of the lab
  • explain what they will be working on
  • explain kibana is not available on aro as of yet
• Build the Lab in the working namespaces for the students as a demonstration
• Create the rocket chat channel
• Declare someone the devops lead for the lab
• Make sure everyone has been granted atleast edit access to the namespaces
• Schedule the touch point mid way through the workshop

Touch Point

• discuss issues/see where everyones at

Last Day

• at this point everyone should be done
• close off by answering questions
• delete namespaces

101 Lab Questions/Bugs

Lab Questions or Bugs

1. Adding Team Members Section:

Once in the project, switch to Developer view and then navigate to More -> Project Access

Select Add Access

This is now the 'Projects button'

Update Slack references to RocketChat

clean up naming conventions

currently courses are named openshift, openshift 201.
code has these as developer operations or developer ops 201

This issue is simply to align the code with the course name and update readmes.

OCP101 - dev labs - missing images in a few sections

In 'Changing Deployment Configurations' Section there is a broken image here:..

In just above 'Exploring Health Checks' there is a broken image.

101 Lab Questions/Bugs

Lab Questions or Bugs

The process for deleting the existing Volume has changed. It no longer gives the option to delete from Add Storage.
Need to navigate to Deployment Config Details for mongodb-[username] to view existing volume and delete it.

Also, in Adding Storage to Existing Deployment Configurations, the image is correct, but under it says to "Select the azure-file storage class.", which does not work, it should be the managed-premium (default).

Information for debugging

• namespace(s): ocp101-labs-pilot-dev
• link to lab slide: https://ocp101-labs-lab-pilot-ocp101-labs-pilot-tools.apps.platform-services.aro.devops.gov.bc.ca/openshift101/09_persistent_storage.html

Error Messages or Screen Shots

OCP 101 Lab & Scheduling

• grant access to aro (non prod cluster) to shelly's personal gh account

• shelly test out ocp101 lab content as a student

• create the ocp101 lab event brite event

  • add pre reqs to event (have completed ocp101, working on cluster, and has technical skills)

• create a playbook to provision namespaces/access (split into groups of 10) and a rc channel for the ocp 101 study lab group

• communicate to Dea the ocp101 lab eventbrite so that it can be included into the newsletter

• test aro cluster for load during multiple rocketchat builds/deploys (15 paralle/builds/deploys)

• add ocp101 holds and add dates to event brite for Oct 7th and Nov 18th

101 Lab Questions/Bugs

Lab Questions or Bugs

1. Adding Team Members Section:

Once in the project, switch to Developer view and then navigate to More -> Project Access

Select Add Access

This is now the 'Projects button'

OCP 101 Lab: Prepare Lab for running on ARO

Summary

Some services have changed since we last deployed the lab. This includes the decomissioning of aporeto (to be replaced by KNPs).

Ensure the labs work without KNPs.

To do

• test lab without aporeto on CLAB
• test if 101 lab needs knps
• test that lab works

OCP101/lab scheduling with team

To Do

• setup a schedule for the next quarter (june to september)
• send schedule to Ari

OCP 201 - confusing instructions for GitFlow Labs

The instructions regarding to branch creation should identify that you can create a branch via cli or the gui. Doing these instructions in conjunction is not possible since the branch would already exist in the upstream.

Update 101 workshop content

Tasks:

• include a brief introduction on the lab content (rocketchat app + mongodb)
• add title for route section
• make mongo URL available in text form (tbd)
• Typo in Autoscaling lab: 'Review the deployment configuraiton and try to add or remove repicas'
• Error in Persitant Storage Lab: Scale down mongodb-[username] to 1 pods
• explain why rolling deployment will fail for db

Meeting: OpenShift 101 Review

• Move Resource Requests and Limits lab earlier as part of troubleshooting deployment issues before deploying mongoDB

• Remove Registry Console Lab

• Start session with creating a branch of the docs/labs, and make changes on the fly

• Create a RocketChat base images caching dependencies to help speed up build time

• Create a diagram of the the lifecycle of application (from Build to Pod)

• Look into maybe move away from gitbook into something else (e.g.: Gastby)

Nice to have:

• A slide about container and images and relationship to docker/docker hub. Comparing to traditional way

OCP201 Labs - Using Helm Templates - Incorrect prometheus version reference

This example code

helm template ./prometheus-8.11.1.tgz \
  --name [username]-prometheus \
  --set \
server.persistentVolume.size=1Gi,\
server.name=[username]-prometheus,\
alertmanager.enabled=false,\
pushgateway.enabled=false,\
kubeStateMetrics.enabled=false,\
nodeExporter.enabled=false,\
serviceAccounts.server.create=false,\
rbac.create=false \
> [username]-prometheus.yaml

incorrectly references prometheus-8.11.1.tgz
Because helm fetches the latest stable prometheus release, it is better to just leave that as a placeholder value

Create training project set in Prod cluster

Now that training is running on such a regular basis, having a prod project space and pipeline will allow for a more stable training experience.

• create project set
• create pipeline for training builds and deployments and deploy courses/labs
• update link references

OCP101 - update rocketchat convention

update the information on how to make requests for project set/realms/access...

Summary of Openshift 101 May 23-24

Feedback

Openshift 101 Feedback									Total Forms	10
Feedback (common theme)	Votes
Provide a list of common oc commands used during the lecture (in rocketchat)	2
Increase Performance Of Builds/Deploys (speed up lab tasks)	3
Prefer Smaller Groups	1
Have helpers be more engaged	1

Tips for Facilitators

• go over using --dry-run flag for several oc options to test things out :)

101 Lab - typo

Lab Typo

On the overview page it says 'happy bath' but probably was meant to be 'happy path'. I kind of like happy bath though.

Add MONGO_URL as text so people can copy/paste

mongodb://dbuser:dbpass@mongodb-[username]:27017/rocketchat

OCP 201 Lab: Shell assumptions

Note the snippet under: https://github.com/BCDevOps/devops-platform-workshops/blob/master/openshift-201/pipelines.md#running-a-pipeline

Assumes a bash shell I believe. I can create a PR to state that as a note if wanted.

OCP101 Workshops - Resource Tuning

We need to add a slide in the miro board to explain the importance of resource tuning and how to do it. This should be coupled with the lab demonstration of resource tuning.

OCP101 Lab Playbook:

This issue tracks the steps needed to run an ocp101 lab. We will want to transfer any info here into an actual playbook (a markdown file) and store in this repo.

Scheduling

The lab is held over two weeks. Attendees are given a set of namespaces to work with. The lab material itself should take 2 to 6 hours to complete.

Day 1

• Introduce the Lab
  • explain the goal of the lab
  • explain what they will be working on
• Build the Lab in the working namespaces for the students as a demonstration
• Create the rocket chat channel
• Declare someone the devops lead for the lab
• Make sure everyone has been granted atleast edit access to the namespaces
• Schedule the touch point mid way through the workshop

Touch Point

• discuss issues/see where everyones at

Last Day

• at this point everyone should be done
• close off by answering questions
• delete namespaces

Missing screenshots in deployment lab

The following assets used in workshop-labs/docs/developer_operations/03_deployment.md are missing:

• 03_deploy_route.png
• 03_deploy_build_trigger_02.png

101 Lab - Monitoring

Lab Questions or Bugs

Monitoring is no longer found in advanced menu. The screen shot and instructions need changing!

broken link in LAB/DEMO: ACCESS MANAGEMENT slide

the openshift 101 slides has a broken link to the labs in LAB/DEMO: ACCESS MANAGEMENT

OCP4 ARO Cluster requires RWX storage class

What

Currently we only have one storage class that can be utilized as RWO.

@stewartshea

Ask

Have atleast another storage class that can be utilized as RWO or RWX

Impact

The OCP 101 Persistent Configuration Lab asks students to test/debug provisioning storage of those different read/write types. This lab is not usable without the storage class as described above ! :)

Move oc tag out of the registry lab to the deployment lab

201 lab - create content for Vault usage

Create lab material on how to integrate Vault secret for openshift workload. More details to be filled after discussion!

OCP101 Lab: Introduction to Shared Services

Summary

The ocp101 lab should have a good introduction on all the shared services the platform provides. Things like sysdig, artifactory, etc.

To do:

• add content to create a sysdig team
• update rc deploy content to view metrics through sysdig
• demonstrate how to create alerts with sysdig
• add content on creating artifact repos
• unknowns (this sounds like an epic)

chat-tool integration for students to check things off

it would be nice to have a method of sending a TOC to slack / rocketchat that students could manually check off when they are done certain labs.

Fix wording on Templates Lab

On page https://ocp201-labs.pathfinder.gov.bc.ca/openshift201/02_templates_openshift.html

The page says "From the CLI, the template can also be viewed" yet has a screen shot of the GUI, it should likely say "From the GUI, the template can also be viewed"

101 Lab Questions/Bugs - "unable to connect to the server"

Lab Questions or Bugs

Working through the Lab instructions (Setup page) I install OC then run oc version which returns a version number and an "unable to connect to the server" error.

The next page (Adding User Access) instructs us to run oc projects, which returns "unable to connect to the server" error.

I resolved this by running oc login <>, but this instruction is not in the Lab instructions

Information for debugging

Please add instructions on how to login to the OC server on the Setup page of the Lab instructions.

Error Messages or Screen Shots

unable to connect to the server

101 Lab Questions/Bugs - Git installations

Lab Questions or Bugs

It would be great to have a quick summary on how to install git

• links to the git homepage

OpenShift 101 slide links are out-of-date

The OpenShift 101 Lab README references OpenShift 101 mural slides. The correct slides are OpenShift 101 Workshop Google Slides.

101 workshop lab content missing

OCP101 - Lab - Deployments/Triggers Section (content confusion)

Pertaining to this section:

start of section

Versioning a Deployment Configuration

At this point in time, your deployment configuration has undergone many changes, such as adding environment variables and adding health checks. Review the deployment configuration History tab:

• Select Deployment #1, right-click, and open in a new tab
• Select your latest deployment version, right-click, and open in a new tab
• Compare the differences - this can be done through the UI or by comparing the YAML

Changing Deployment Configuration Triggers

While reviewing the different deployment versions, take note of the Trigger column.

end of section

---

It looks like this instruction is a bit misleading. A student explaining that while viewing the replication controllers the triggers column is not visible.

Based on this instruction: " While reviewing the different deployment versions, take note of the Trigger column."

I'd suggest changing this to something like:

"After reviewing the different deployment versions (aka replication controllers), view the Deployment Config and take note of the Trigger Column"

Transition OCP101 Eventbrite and Zoom responsibilities

Transition of responsibilities for creating, scheduling and advertising OCP101 Eventbrite events, OCP101 Zoom meetings.

Rosa Montgomery providing handoff information and transition support to Matt Spencer.

Definition of done

• Review process documentation provided by Rosa
• Recreate Eventbrite templates from Digital Academy account onto Exchange Lab Account
• Produce draft events and zoom links for next 3 months of OCP101 sessions
• Rosa + Matt to meet to confirm correct setup
• Publish and advertise next round of OCP101 events

101 Lab Questions/Bugs - run through lab and fix deployment specific issues

Lab Questions or Bugs

The lab was changed from DC to deployment which caused several issues. Some were corrected but some have slipped through.

Information for debugging

• run through lab step by step and find and rectify the issues

• you can use #ocp101-lab-march rocketchat channel for reference