dxc-technology / online-devops-dojo

DevOps hands-on learning modules in your browser

Online DevOps Dojo

This repository contains the sources of the Online DevOps Dojo Katacoda Scenarios and the coach robot.

If you are landing here and just want to get going with the training, please go to about the DevOps Dojo.

Changelog

See a history of the changes to the Online DevOps Dojo.

Files description

Training scenarios

The scenarios run on the Katacoda interactive learning and training platform.

• online-devops-dojo-pathway.json: Index of Katacoda scenarios
• online-devops-dojo/: Katacoda scenarios: one sub-folder for each training
• assets/online-devops-dojo/: Images used in training pages

Dojo coach

• docs/: Documentation about the coach bot
• handler.js: Handler for the Lambda function
• index.js: Coach code
• package.json: Node package dependencies
• package-lock.json: Tested set of Node module dependencies

CI/CD

• serverless.yml: Serverless deployment configuration file
  I have not found a way to isolate the coach files in a sub-folder and execute Serverless there. Help is welcome.

In .github/workflows folder:

• md-links.yml: Validate Katacoda scenarios.
• upload_lambda.yml: GitHub workflow triggered on repository pushes, which uploads the coach lambda function to AWS.
• upload_lambda_from_comment.yml: Same upload as above but triggered by a comment /deploy (was convenient when manual trigger wasn't possible).
• linters.yml: Javascript linter (configuration in /.eslintrc.json).
• md-links.yml: Validate links in MarkDown files.

Contributing

If you want to contribute to the DevOps trainings, see the contribution instructions.

If you are interested in the coach, please read its setup process.

Issues

If you experience some problems with the existing scenarios, please open an issue and let us know.

License

This project is licensed under the Mozilla Public License Version 2.0 - see the LICENSE file for details.

online-devops-dojo's Issues

Need assistance with module continuous-integration

Describe the issue
The message that popped up at the beginning:
"Oops! Sorry, we had a problem. Please refresh and try again.
Error - Request failed with status code 500
We are sorry but we encountered a problem with the connection.
Please refresh and try again.
Tue Sep 06 2022 11:55:01 GMT+0200 (czas środkowoeuropejski letni)
io server disconnect
(reference ID: //ws.europe.katacoda.com/elsy05/none/29105068/none/1662458101"

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Need assistance with module continuous-integration

Describe the issue
i couldn't work on terminal from last 3 days i see same error message with status code 500.

Expected behavior
i would like to practice the provided module.

Screenshots
please find the attached screenshots.

Additional context
i would like to continue my practice from continuous integration i got structed at this stage, couldn't

move forward.

Need assistance with module shift-security-left

Describe the issue
A clear and concise description of what the issue or question is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Pet-clinic shall open in a window with navigation buttons

Is your feature request related to a problem? Please describe.
In the continuous-integration module in step 8 is a link to the pet-clinic app. The app opens in a tab in the katacoda window which has no navigation buttons. Navigating back from a page in the app is only possible through the context menu.

Describe the solution you'd like
If the pet-clinic app would open in a separate browser window, it would make the navigation in the app easier.

Need assistance with module continuous-integration

Getting this error when trying to start the lab.

This environment is no longer available.

Need assistance with module welcome

When opening the welcome/setup module this text appears at line 1 "Scenario not found. Please check your embedding code configuration." I'm not seeing any directions that explain what I may have needed to do prior to opening the module

Need assistance with module continuous-integration

Describe the issue
A clear and concise description of what the issue or question is.

To Reproduce
Steps to reproduce the behavior:

1. Go to 'https://dxc-technology.github.io/about-devops-dojo/katacoda/os4-continuous-integration/'
2. Click on 'start'
3. display shows 'Loading your environment
   This usually takes a minute'
4. See error 'Loading your environment
   This usually takes a minute'

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

How to get the Dojo Belts (White, Green and Yellow) and regarding flow of the course.

I am going through DevOps Dojo sessions. I have followed the sequence and have completed below in the order:

1. Welcome and Setup
2. Leading Change
3. Version Control
4. Continuous Integration
5. Shift Security Left
6. Value Stream Mapping

But, after "Value Stream Mapping" instead of going to "Post Incident Practices", I was taken to "DevOps Kaizen",

I would like to know is it by design or is it a bug in the flow.

I have completed DevOps Kaizen also, but after the same instead of "Value Stream Mapping", I am taken to O'Reilly's KataCode page showing that I do not have access. Attached is its image. Pls let know is it ok or it is an error.

I will complete the "Post Incident Practices" session now directly. Would like to know, now how can I get White, Green and Yellow belts as I have gone through complete session. Pls guide.

Seek a quick response as I wish to complete it today.

Rgds,
Pawan

Need assistance with module welcome

Describe the issue
A clear and concise description of what the issue or question is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Need assistance with module version-control

How do I open data.sql ?

I tried to write open data.sql but nothing happens.

Personal access tokens echoed to screen in URLs

Describe the bug
We added the option to supress the echoing of personal access tokens (PATs) when initially pasted, but those tokens are later formed into URLs that are echoed to the console.

To Reproduce
Steps to reproduce the behavior:

1. Go to https://youtu.be/zNShWuKdWMQ?t=533 - see that token isn't echoed by prepare.sh -s
2. Go to https://youtu.be/zNShWuKdWMQ?t=848 to see token echoed to console as part of the URL

Expected behavior
Tokens should not be echoed to console (by not being placed into URLs in the way they are at the moment).

Screenshot
If applicable, add screenshots to help explain your problem.

Need assistance with module welcome

Describe the issue
I created the new token and trying to go to the next step. When I click the bottom 'CHECKING', it does not take me to any other screen. It always says: "checking".

To Reproduce
Steps to reproduce the behavior:
I am in the first instructions to create a repository section.

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Need assistance with module welcome

Describe the issue
I am using the url to go the page "https://dxc-technology.github.io/about-devops-dojo/katacoda/os1-welcome/"

The Page is empty. It doesn't have anything to display.

Enhance clarity on Verison Control module being required before Continuous Integration

The Version Control module must be completed before the Continuous Integration module, because it includes defining "horse" as a type in the Pet clinic, before then referencing that type in the Continuous Integration module. If students skip straight to CI, the database tests will always fail.

While it's roughly referred to, we should enhance the clarity that in fact you must complete Version Control module as a requirement before attempting the Continuous Integration module; they're not entirely independent.

Originally posted by @rosnermd in #75 (comment)

Need assistance with module continuous-integration

Describe the issue
When I try to start the module I get the following error message in the terminal:

Oops! Sorry, we had a problem. Please refresh and try again.
Error - Request failed with status code 500
We are sorry but we encountered a problem with the connection.
Please refresh and try again.
Mon Sep 19 2022 15:21:25 GMT-0700 (Pacific Daylight Time)
io server disconnect
(reference ID: //ws.us.katacoda.com/elsy05/none/29440545/none/166

To Reproduce
Steps to reproduce the behavior:

1. Go to Continuous Integration Module
2. Click on 'Start'
3. See error

Expected behavior
The code should be running.

Screenshots

Additional context
Add any other context about the problem here.

pull requests

Describe the issue
A clear and concise description of what the issue or question is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Need assistance with module continuous-integration

Describe the issue
Build fails after I fix the missing parenthesis.

To Reproduce
Steps to reproduce the behavior:

1. Step 6/8, after I fix the missing parenthesis a build kicks off
2. Jenkins starts to build
3. Error

Expected behavior
Build is suppose to succeed
Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Need assistance with module continuous-integration

Describe the issue
Hi. I'm stupid man :( Tried to use ngrok inside the provided linux machine in tutor for understanding what that machine can do. Looks like my public IP was banned
62.4.55.86. Could you please return me? I promiss not to do that again and I will just learning DevOps path!
Thank you in advance

To Reproduce
Steps to reproduce the behavior:

1. Go to any page with KVM on right hand side and tutor on the left
2. See white screen

Expected behavior
Working interface of both big tutor elements

Additional context
Sorry again :(

Need assistance with module continuous-integration

Describe the issue
A clear and concise description of what the issue or question is.
It shows that the terminal is no longer available

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.
A terminal to type commands
Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Need assistance with module version-control

.prepare.sh/ command not working

Need assistance with module continuous-integration

Continues integration part is not working upon running the scenario.

Error showing: "This environment is no longer available."

Need assistance with module welcome

Unable to proceed with Shift Left
I started the dojo yesterday and didn't finish. The Shift Left didn't allow me to continue.

To Reproduce
Hard to say... start at 3PM and not get done and try again in the morning.

Expected behavior
progressing through Shift Left with Security.

Screenshots

Additional context
The first failure was with the Jenkins step. My output didn't match the example around step 5 or 6.
I've tried restarting with the Welcome and it isn't working.
Looking at my github, the master is basically empty, but the branches are not. The deps-check is the newest branch as part of Shift Left.

I may need to do a cold restart?

Need assistance with module continuous-integration

Describe the issue
The session doesn't load properly and gives a command prompt error: "This environment is no longer available."

To Reproduce
Steps to reproduce the behavior:

1. Click on link: https://dxc-technology.github.io/about-devops-dojo/katacoda/os4-continuous-integration/ after having completed the steps in the welcome module.
2. Wait for 'hang in there we are creating the environment message'
3. Wait some more.
4. See error

Expected behavior
The module should load

Add a final step in final module to remove PAT

Is your feature request related to a problem? Please describe.

When a student ends all the modules, the GitHub Personal Access Token is no more required. It would be nice to have a final step or maybe a final module to remove the PAT from the account.

Octocats as images for the dojo?

Is your feature request related to a problem? Please describe.
Not problem related

Describe the solution you'd like
DXC Dojo team figure out if we'd like to use Octocat icons for the characters instead of (or in addition to?) their existing cartoon images.

Describe alternatives you've considered
We could replace the cartoons, or we could also maybe create Octocats to be what the characters would choose.

Additional context
From GitHub Universe 2020 Enterprise Track discussion #625 suggested by @iceicys

Need assistance with module welcome

Describe the issue
A clear and concise description of what the issue or question is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Add flag for tokens not to be echoed in prepare.sh for Version Control module

Is your feature request related to a problem? Please describe.
I'd like to be able to do demos without revealing my token to the audience

Describe the solution you'd like
prepare.sh should take a -s flag to be silent and not echo tokens to the terminal

Describe alternatives you've considered
Delete the token really quickly, but the length of the demo is already sufficient time for an attacker

Additional context
We already have this for the Shift Left module (as that was being used more for public demos)