Skip to content
This repository was archived by the owner on Jul 23, 2022. It is now read-only.

Commit c423c35

Browse files
authored
Merge pull request #570 from rh-open-innovation-labs/d0500-review-day-1
Review D0500 Slides for activities in day 1
2 parents ff1b75b + 347b978 commit c423c35

File tree

9 files changed

+61
-23
lines changed

9 files changed

+61
-23
lines changed

README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
# Red Hat Open Innovation Labs Enablement Materials
2+
23
This repo will house all the slides and lab exercises for the Enablement. It will also be used to track issues, features and new additions to the Enablement.
34

45
[Course Content](https://rht-labs.github.io/enablement-docs/#/)
@@ -10,20 +11,25 @@ Please navigate to the "Slides" folder and follow the ReadMe instructions on how
1011
NodeJS is needed to run this project, you can download it from [NodeJS](https://nodejs.org/en/download/)
1112

1213
## Exercises
14+
1315
Exercises are created using [Docsify](https://docsify.js.org/#/). Write docs in Markdown and use [Docsify](https://github.com/QingWei-Li/docsify-cli) cli to serve them. Store your lab exercises in the `exercises/<lab-number>` dir.
1416

1517
A template layout for the lab exercise with headings and what should be included is stored in `exercises/0-docs-template`. Use this as a base point when creating new materials. Add items to the sidebar on the homepage by updating the `_sidebar`
1618

17-
To run and serve the docs
19+
To run and serve the docs:
20+
1821
1. `npm i -g docsify-cli`
1922
2. `cd exercises && docsify serve -p 8085 -P 35727` and open your browser to 8085
2023

2124
## Publishing
25+
2226
The `exercises` folder is served as the root of the gitpages site from master branch. To update the published content run:
27+
2328
1. `git checkout master`
2429
2. `git subtree push --prefix exercises origin gh-pages`
2530

26-
2731
## Contributing & Issues
32+
2833
For tracking of feature development and task management add the ZenHub plugin extension to [Chrome](https://chrome.google.com/webstore/detail/zenhub-for-github/ogcgkffhplmphkaahpmffcafajaocjbd) or [Firefox](https://www.zenhub.com/extension).
34+
2935
To contribute raise an issue and submit a PR to correspond to that feature.

exercises/README.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,22 @@
44
[image-ref](https://www.cloudbees.com/blog/get-ripped-jenkins-docker-industrial-strength-continuous-delivery)
55

66
## Learner Outcomes
7+
78
* Provide an immersive experience for students through practical application of DevOps culture using modern software development practices.
89

910
* Allow students to experience the cultural shift they need to make in order to begin a successful DevOps journey.
1011

1112
## Cluster Information
1213

1314
An OpenShift Cluster is required to complete the lab exercises. Students will receive by email (and by the instructors on site) the following information regarding the OpenShift cluster:
15+
1416
- <**CLUSTER_URL**> -- OpenShift Webconsole/API Server URL
1517
- <**APPS_URL**> -- Wildcard subdomain for the exposed applications deployed in the Cluster
1618

1719
## Learner Pre-requisites
20+
1821
The following are the minimal hardware requirements for running the lab exercises in this course
22+
1923
* 64-bit Intel Core i5/i7 CPU or equivalent with virtualization extensions enabled
2024
* 4GB memory
2125
* 80GB hard disk
@@ -47,49 +51,58 @@ The following table lists the software requirements for running the lab exercise
4751
### Linux
4852

4953
1. Enable the nodejs 8 modules in Fedora and install the latest nodejs 8.x LTS release.
54+
5055
```bash
5156
dnf module enable nodejs:8
5257
dnf module install -y nodejs:8
5358
```
54-
or use the [node-version-manager](https://github.com/nvm-sh/nvm#install--update-script) to control your node versions across multiple projects.
5559

60+
or use the [node-version-manager](https://github.com/nvm-sh/nvm#install--update-script) to control your node versions across multiple projects.
5661

5762
2. Install OpenJDK version 1.8.
63+
5864
```bash
5965
dnf install java-1.8.0-openjdk-devel
6066
```
6167

6268
3. Install Chromium version 70 or higher.
69+
6370
```bash
6471
dnf install chromium
6572
```
6673

6774
4. Install Docker, Git and Ansible.
75+
6876
```bash
6977
dnf install git ansible docker
7078
systemctl enable docker
7179
systemctl start docker
7280
```
7381

7482
5. enable non-root user access to docker
83+
7584
```bash
7685
groupadd docker
7786
systemctl restart docker
7887
usermod -aG docker $USER
7988
```
8089

8190
6. Install the OpenShift 3.11 client binary.
91+
8292
```bash
8393
dnf install origin-clients
8494
```
8595

8696
### macOS
97+
8798
1. Install HomeBrew for macOS by following the installation instructions at https://brew.sh/
8899

89100
2. Install Node.js version 8.x LTS using the brew command, and follow the instructions to add the **node** binary to the **PATH** environment variable.
101+
90102
```bash
91103
brew install node@8
92104
```
105+
93106
or use the [node-version-manager](https://github.com/nvm-sh/nvm#install--update-script) to control your node versions across multiple projects.
94107

95108
3. Install JDK version 1.8 for MacOS by using the installer from the Oracle website at https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
@@ -99,16 +112,19 @@ or use the [node-version-manager](https://github.com/nvm-sh/nvm#install--update-
99112
5. Install Docker for Mac by following the instructions from https://store.docker.com/editions/community/docker-ce-desktop-mac
100113

101114
6. Install Git using brew
115+
102116
```bash
103117
brew install git
104118
```
105119

106120
7. You need Ansible version 2.8 or greater to run the exercise playbooks. If you have not installed Ansible, or have an older version, install or upgrade it using brew
121+
107122
```bash
108123
brew install ansible
109124
```
110125

111126
8. Download and uncompress the OpenShift 3.11 client binary archive. Copy the ***oc*** binary to ***/usr/local/bin*** folder on your system
127+
112128
```bash
113129
curl -L -O https://mirror.openshift.com/pub/openshift-v4/clients/oc/4.5/macosx/oc.tar.gz
114130
tar xzvf oc.tar.gz
@@ -155,23 +171,29 @@ Windows will restart a couple of times after enabling Hyper-V and continue with
155171
11. Execute the following commands in the ***Windows Command Prompt*** to run Ansible playbooks on Windows systems:
156172

157173
* Pull the container image containing the tools and utilities that are required for running Ansible playbooks:
174+
158175
```bash
159176
docker pull quay.io/redhat/do500-toolbox
160177
```
178+
161179
* Create a working directory under your ***C:\*** drive to store the lab exercise files and Ansible playbooks
180+
162181
```bash
163182
mkdir C:\do500-workspace
164183
```
165184

166185
* Launch the container and run a quick test:
186+
167187
```bash
168188
docker run -it -v C:/do500-workspace:/home/tool-box/workarea:Z quay.io/redhat/do500-toolbox /bin/bash
169189
```
190+
170191
<p class="tip">
171192
<b>NOTE</b> - When you launch the container for the very first time, you will be prompted by Docker, as well as the Windows security subsystem to allow read and write access to the ***C:\do500-workspace*** directory. Allow read and write access to this directory by entering your Windows username and password when prompted.
172193
</p>
173194

174195
* Once you are inside the container, you can log in to the OpenShift cluster using the OpenShift ***oc*** command-line client, and verify that Ansible is installed:
196+
175197
```bash
176198
bash-4.4$ oc login -u <username> -p <password> <CLUSTER_URL>
177199
bash-4.4$ oc version
@@ -182,11 +204,14 @@ bash-4.4$ exit
182204
Your instructor will provide the ***username*** and ***password*** information for the OpenShift cluster when you are ready to run the lab exercises.
183205

184206
## Git and Containers 101
207+
185208
- Git tutorial covering the basics - https://try.github.io/
186209
- Handy guide for those new to containers - https://developers.redhat.com/blog/2018/02/22/container-terminology-practical-introduction/
187210

188211
## Setup your IDE
212+
189213
The following plug-ins are useful for providing syntax highlighting for various lab files:
214+
190215
- YAML Syntax Highlighter
191216
- Autosave
192217
- JavaScript Syntax Highlighter

slides/README.adoc

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# DO500 Instructor Slides
22

3-
### Full setup
3+
## Full setup
44

55
Some reveal.js features, like external Markdown and speaker notes, require that
66
presentations run from a local web server. The following instructions will set
@@ -21,23 +21,23 @@ the reveal.js source code.
2121
[source, sh]
2222
[user@host path]$ npm install
2323
24-
1. Serve the presentation and monitor source files for changes:
24+
5. Serve the presentation and monitor source files for changes:
2525
[source, sh]
2626
[user@host path]$ npm start
2727
28-
1. Open <http://localhost:8000> to view your presentation. You can change the
28+
6. Open <http://localhost:8000> to view your presentation. You can change the
2929
port by using:
3030
[source, sh]
3131
[user@host path]$ npm start -- --port=8001
3232
33-
### Folder Structure
33+
## Folder Structure
3434

3535
- **css/** Core styles without which the project does not function
3636
- **js/** Like above but for JavaScript
3737
- **plugin/** Components that have been developed as extensions to reveal.js
3838
- **lib/** All other third party assets (JavaScript, CSS, fonts)
3939
40-
### Printing to PDF
40+
## Printing to PDF
4141

4242
1. Run the slides locally as described above.
4343
2. Open the slides in Chrome or Chromium.
@@ -55,4 +55,3 @@ done
5555
5656
if you are using macOS the Google Chrome path is in
5757
`/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome`
58-

slides/markdown/information_radiators.md

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,6 @@ DO500 <!-- {_class="title-color"} -->
2828

2929

3030

31-
### Exercise - Daily Retrospective
32-
Reflect on the first day of class, and make adjustments to continuously improve
33-
34-
35-
3631
<!-- .slide: data-background-image="images/chef-background.png" class="white-style" -->
3732
### DevOps practices used in this section:
3833
- [Information Radiators](https://openpracticelibrary.com/practice/visualisation-of-work/)

slides/markdown/kick_off.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,5 +30,11 @@ DO500 <!-- {_class="title-color"} -->
3030
- [Backlog](https://openpracticelibrary.com/practice/backlog-refinement/)
3131
- [Work Visualization](https://openpracticelibrary.com/practice/visualisation-of-work/)
3232
- [Burndown](https://openpracticelibrary.com/practice/burndown/)
33-
- [Definition of Done](https://www.scruminc.com/definition-of-done/)
33+
- [Definition of Done](https://openpracticelibrary.com/practice/definition-of-done/)
3434
- [Team Sentiment](https://openpracticelibrary.com/practice/team-sentiment/)
35+
- [Real Time Retro](https://openpracticelibrary.com/practice/realtime-retrospective/)
36+
- [Big Picture](https://openpracticelibrary.com/practice/the-big-picture/)
37+
- Practice Corner
38+
- [Parking Lot (Car Park)](https://openpracticelibrary.com/practice/parking-lot-car-park/)
39+
- [Quote Wall](https://openpracticelibrary.com/practice/quote-wall/)
40+
- [Stop the world](https://openpracticelibrary.com/practice/stop-the-world-event/)

slides/markdown/pairing_and_mobbing.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ DO500 <!-- {_class="title-color"} -->
88
<!--.slide: id="pair-mob" -->
99
### Pair Programming
1010
![Pair Programming](images/PairAndMob/coaching-coders-coding-7374.jpg) <!-- {_class="inline-image"} -->
11-
**Pair programming** is a practice used in eXtreme Programming in which
11+
**Pair programming** is a practice used in e**X**treme **P**rogramming in which
1212
two programmers work together at one computer.
1313

1414

@@ -33,15 +33,15 @@ _Individual Drawing_
3333
### Exercise - Pairing and Mobbing
3434
_Pair Drawing_
3535
1. Assemble in pairs.
36-
2. Each pair grab a medium post-it
36+
2. Each pair grab a medium post-it.
3737
3. Take turns drawing an element of Public Figure.
3838

3939

4040

4141
### Exercise - Pairing and Mobbing
4242
_Mob Drawing_
4343
1. Assemble in table groups.
44-
2. Each table use an easel post-it
44+
2. Each table use an easel post-it.
4545
3. Take turns drawing an element of Public Figure.
4646

4747

slides/markdown/priority_sliders.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,9 @@ DO500 <!-- {_class="title-color"} -->
3333
![Priority Sliders Example](images/example-priority-sliders.jpg) <!-- {_class="inline-image"} -->
3434
#### In table groups, work together to:
3535
1. Draw a 5 heading priority slider chart
36-
2. Consider the areas identified from Target Outcomes practice
36+
2. Consider the areas identified from Target Outcomes practice
3737
3. Discuss where you agree as a team the priorities, 1 to 5
38-
4. Note no priority can be the same level and trade-offs must occur.
38+
4. Note no priority can be the same level and trade-offs must occur
3939

4040

4141

slides/markdown/retrospectives.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Retrospectives are practice used by their teams to **reflect** on their way of w
1717

1818
<!-- {_class="fragment" data-fragment-index="1"} -->"*At regular intervals, the team reflects on how to become more effective, then tunes and adjusts its behavior accordingly*"
1919

20-
<!-- {_class="fragment" data-fragment-index="1"} --> **- 12th Principle of the Agile Manifesto**
20+
<!-- {_class="fragment" data-fragment-index="1"} --> **- 12th Principle of the Agile Manifesto -**
2121

2222

2323

@@ -92,6 +92,12 @@ abilities, the resources available, and the situation at hand."**
9292

9393

9494

95+
### Exercise - Daily Retrospective
96+
Reflect on the first day of class, and make adjustments to continuously improve
97+
98+
99+
100+
<!-- .slide: data-background-image="images/chef-background.png" class="white-style" -->
95101
### DevOps practices used in this section:
96102
- [Retrospectives](https://openpracticelibrary.com/practice/retrospectives/)
97103
- [Realtime Retrospective](https://openpracticelibrary.com/practice/realtime-retrospective/)

slides/markdown/social_contracts.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ DO500 <!-- {_class="title-color"} -->
1515
#### _Effective Social Contracts are:_
1616
- Publicly displayed
1717
- Revisited regularly and amended if required
18-
- Binding on *all* parties
18+
- Binding on *all* parties
1919
- Signatories hold each other accountable
2020

2121

@@ -31,6 +31,7 @@ DO500 <!-- {_class="title-color"} -->
3131
![Example Social Contract](images/Example_Social_Contract.png) <!-- {_class="inline-image"} -->
3232
- Core hours
3333
- No blame culture
34+
- No Rock Stars!
3435
- Timebox debates
3536
- Celebrate success!
3637

@@ -49,4 +50,4 @@ DO500 <!-- {_class="title-color"} -->
4950

5051
<!-- .slide: data-background-image="images/chef-background.png", class="white-style" -->
5152
### DevOps practices used in this section:
52-
- [Social Contracts](https://openpracticelibrary.com/practice/social-contract/)
53+
- [Social Contract](https://openpracticelibrary.com/practice/social-contract/)

0 commit comments

Comments
 (0)