From ad288967440a06356c67bddfbf117c079c88e814 Mon Sep 17 00:00:00 2001 From: Sean Roberts Date: Fri, 9 Aug 2013 16:54:29 -0700 Subject: [PATCH] publishing cleanup made all the pages flow beter. included some missing pages. prep for the community to start adding user stories. blueprint training-manuals Change-Id: Ib7985392fc149b4e0ffb79e6535301bdf39d9f9f --- ...te-what-does-this-book-intend-to-teach.xml | 2 +- .../bk001-ch002-associate-getting-started.xml | 9 +- .../bk001-ch003-associate-general.xml | 2 +- .../bk001-ch004-associate-assessment.xml | 50 ++++- ...or-what-does-this-book-intend-to-teach.xml | 2 +- .../bk002-ch002-operator-getting-started.xml | 11 +- .../bk002-ch003-operator-general.xml | 4 +- .../bk002-ch008-operator-assessment.xml | 185 +++--------------- ...er-what-does-this-book-intend-to-teach.xml | 2 +- .../bk003-ch002-developer-getting-started.xml | 7 +- .../bk003-ch003-developer-general.xml | 9 + .../bk003-ch010-developer-assessment.xml | 49 ++++- ...ps-what-does-this-book-intend-to-teach.xml | 2 +- .../bk004-ch002-devops-getting-started.xml | 7 +- .../bk004-ch003-devops-general.xml | 9 + .../bk004-ch010-devops-assessment.xml | 49 ++++- ...xml => operator-fix-documentation-bug.xml} | 34 ++-- .../openstack-training/st-training-guides.xml | 2 + .../userstory-includes-template.xml | 4 +- 19 files changed, 230 insertions(+), 209 deletions(-) create mode 100644 doc/src/docbkx/openstack-training/bk003-ch003-developer-general.xml create mode 100644 doc/src/docbkx/openstack-training/bk004-ch003-devops-general.xml rename doc/src/docbkx/openstack-training/{operator-fix-bug.xml => operator-fix-documentation-bug.xml} (92%) diff --git a/doc/src/docbkx/openstack-training/bk001-ch001-associate-what-does-this-book-intend-to-teach.xml b/doc/src/docbkx/openstack-training/bk001-ch001-associate-what-does-this-book-intend-to-teach.xml index 39c1226cc6..46f4729b62 100644 --- a/doc/src/docbkx/openstack-training/bk001-ch001-associate-what-does-this-book-intend-to-teach.xml +++ b/doc/src/docbkx/openstack-training/bk001-ch001-associate-what-does-this-book-intend-to-teach.xml @@ -2,7 +2,7 @@ - Associate What Does This Book Intend to Teach + OpenStack Associate Engineer, What Does This Book Intend to Teach diff --git a/doc/src/docbkx/openstack-training/bk001-ch002-associate-getting-started.xml b/doc/src/docbkx/openstack-training/bk001-ch002-associate-getting-started.xml index b95469cdb3..3460b2144c 100644 --- a/doc/src/docbkx/openstack-training/bk001-ch002-associate-getting-started.xml +++ b/doc/src/docbkx/openstack-training/bk001-ch002-associate-getting-started.xml @@ -2,12 +2,15 @@ - Associate Getting Started + OpenStack Associate Engineer, Getting Started - - + Knowledge and skills + + + Materials and equipment + diff --git a/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml b/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml index 3de50e7b06..d63548d578 100644 --- a/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml +++ b/doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml @@ -4,6 +4,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="bk001-ch003-associate-general"> - Associate General + OpenStack Associate Engineer, General Material To Learn User Stories are referenced here diff --git a/doc/src/docbkx/openstack-training/bk001-ch004-associate-assessment.xml b/doc/src/docbkx/openstack-training/bk001-ch004-associate-assessment.xml index 6c6ff45cb4..a122b0b31d 100644 --- a/doc/src/docbkx/openstack-training/bk001-ch004-associate-assessment.xml +++ b/doc/src/docbkx/openstack-training/bk001-ch004-associate-assessment.xml @@ -2,12 +2,48 @@ - Associate Assessment - - - + OpenStack Associate Engineer, Assessment + + + + + + + + + + + + + + + + +
Assessment Question 1
TaskCompleted?
+ Configure a .... + - - - +
+ + + + + + + + + + + + + + + + +
Assessment Question 2
TaskCompleted?
+ Configure a .... + + +
+ diff --git a/doc/src/docbkx/openstack-training/bk002-ch001-operator-what-does-this-book-intend-to-teach.xml b/doc/src/docbkx/openstack-training/bk002-ch001-operator-what-does-this-book-intend-to-teach.xml index c762ad6922..367aa75d45 100644 --- a/doc/src/docbkx/openstack-training/bk002-ch001-operator-what-does-this-book-intend-to-teach.xml +++ b/doc/src/docbkx/openstack-training/bk002-ch001-operator-what-does-this-book-intend-to-teach.xml @@ -2,7 +2,7 @@ - Operator What Does This Book Intend to Teach + OpenStack Operations Engineer, What Does This Book Intend to Teach diff --git a/doc/src/docbkx/openstack-training/bk002-ch002-operator-getting-started.xml b/doc/src/docbkx/openstack-training/bk002-ch002-operator-getting-started.xml index 34fdb18a1a..e526200036 100644 --- a/doc/src/docbkx/openstack-training/bk002-ch002-operator-getting-started.xml +++ b/doc/src/docbkx/openstack-training/bk002-ch002-operator-getting-started.xml @@ -2,12 +2,15 @@ - Operator Getting Started + OpenStack Operations Engineer, Getting Started - - - + + Knowledge and skills + + + Materials and equipment + diff --git a/doc/src/docbkx/openstack-training/bk002-ch003-operator-general.xml b/doc/src/docbkx/openstack-training/bk002-ch003-operator-general.xml index 5e52bfebe3..7d2e1ff7ce 100644 --- a/doc/src/docbkx/openstack-training/bk002-ch003-operator-general.xml +++ b/doc/src/docbkx/openstack-training/bk002-ch003-operator-general.xml @@ -3,7 +3,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="bk003-ch002-operator-fix-bug"> - Operator General + OpenStack Operations Engineer, General Material To Learn User Stories are referenced here - + \ No newline at end of file diff --git a/doc/src/docbkx/openstack-training/bk002-ch008-operator-assessment.xml b/doc/src/docbkx/openstack-training/bk002-ch008-operator-assessment.xml index 1b5d49b2d2..3c16d25ae2 100644 --- a/doc/src/docbkx/openstack-training/bk002-ch008-operator-assessment.xml +++ b/doc/src/docbkx/openstack-training/bk002-ch008-operator-assessment.xml @@ -2,9 +2,33 @@ - Operator Assessment + OpenStack Operations Engineer, Assessment - +
Trainee tasks
+ + + + + + + + + + + + + + + +
Assessment Question 1
TaskCompleted?
+ Configure a .... + + +
+ + + + @@ -13,159 +37,14 @@ - - + +
Assessment Question 2
Task
Configure a .... + Configure a .... + + +
- - - As a trainee I must configure a virtual environment to accomplish the - configuration tasks - - - As a trainee I must understand the basic overview of OpenStack core projects - - - As a trainee I must understand the architecture the RefStack architecture described - in the Basic Install Guide - - - As a trainee I must understand how to install Ubuntu 12.04 (or 13.04 in later - versions) - - - As a trainee I must understand the role of the Controller Node in The RefStack - architecture described in the basic install guide - - - As a trainee I must understand the role of MySql server in the Controller Node - - - As a trainee I must install MySql server in the Controller Node - - - As a trainee I must understand the role of RabbitMQ Messaging Service in the - Controller Node - - - As a trainee I must install and configure RabbitMQ Messaging Service in the - Controller Node - - - As a trainee I must understand the role of OpenStack Identity Service in the - Controller Node - - - As a trainee I must Install and Configure OpenStack Identity Service in the - Controller Node - - - As a trainee I must understand the role of OpenStack Image Service in the Controller - Node - - - As a trainee I must Install and configure OpenStack Identity Service in the - Controller Node - - - As a trainee I must understand the role of OpenStack Compute (Cloud Controller - Services) in the Controller Node - - - As a trainee I must install and configure OpenStack Compute (Cloud Controller - Services) in the Controller Node - - - As a trainee I must understand the role of OpenStack Block Storage Service in the - Controller Node - - - As a trainee I must install and configure OpenStack Block Storage Service in the - Controller Node - - - As a trainee I must understand the role of OpenStack Network Service (cloud - controller) in the Controller Node - - - As a trainee I must install and configure OpenStack Network Service (cloud - controller) in the Controller Node - - - As trainee I must verify the proper configuration and operation of the Controller - node within the RefStack architecture described in the Basic Install Guide - - - As a trainee I must understand the role of Network Node within the RefStack - architecture described in the Basic Install Guide - - - As a trainee I must understand the role of Open vSwitch in the Network Node - - - As a trainee I must install and configure Open vSwitch in the Network Node - - - As a trainee I must understand the role of Neutron (formerly Quantum) in the Network - Node - - - As a trainee I must install and configure Neutron (formerly Quantum) in the Network - Node - - - As a trainee I must understand the how to create virtual networking in the Network - Node - - - As a trainee I must configure virtual networking in the Network Node - - - As a trainee I must understand L3 Configuration in the Network Node - - - As a trainee I must configure L3 Configuration in the Network Node - - - As a trainee I must verify the proper configuration and operation of the Network - Node within the Reference Architecture described in the basic install guide - - - As a trainee I must understand the role of Compute Node within the RefStack - architecture described in the Basic Install Guide - - - As a trainee I must understand Nova (compute node services) in the Compute Node - - - As a trainee I must install and configure Nova (compute node services) in the - Compute Node - - - As a trainee I must understand OpenStack Networking using Open vSwitch in the - Compute Node - - - As a trainee I must install and configure OpenStack Networking using Open vSwitch in - the Compute Node - - - As a trainee I must understand OpenStack Networking using Neutron (formerly Quantum) - in the Compute Node - - - As a trainee I must install and configure OpenStack Networking using Open Neutron - (formerly Quantum) n the Compute Node - - - As a trainee I must understand instantiation of a Virtual Machine (Instance) using - OpenStack Dashboard (Horizon) - - - As a trainee I must instantiate of a Virtual Machine (Instance) using OpenStack - Dashboard (Horizon) - - diff --git a/doc/src/docbkx/openstack-training/bk003-ch001-developer-what-does-this-book-intend-to-teach.xml b/doc/src/docbkx/openstack-training/bk003-ch001-developer-what-does-this-book-intend-to-teach.xml index ba00ab0ea7..b32948b36d 100644 --- a/doc/src/docbkx/openstack-training/bk003-ch001-developer-what-does-this-book-intend-to-teach.xml +++ b/doc/src/docbkx/openstack-training/bk003-ch001-developer-what-does-this-book-intend-to-teach.xml @@ -2,7 +2,7 @@ - Developer What Does This Book Intend to Teach + OpenStack Development Engineer, What Does This Book Intend to Teach diff --git a/doc/src/docbkx/openstack-training/bk003-ch002-developer-getting-started.xml b/doc/src/docbkx/openstack-training/bk003-ch002-developer-getting-started.xml index ae53c39e70..70d04b7078 100644 --- a/doc/src/docbkx/openstack-training/bk003-ch002-developer-getting-started.xml +++ b/doc/src/docbkx/openstack-training/bk003-ch002-developer-getting-started.xml @@ -2,12 +2,15 @@ - Developer Getting Started + OpenStack Development Engineer, Getting Started - + Knowledge and skills + + Materials and equipment + diff --git a/doc/src/docbkx/openstack-training/bk003-ch003-developer-general.xml b/doc/src/docbkx/openstack-training/bk003-ch003-developer-general.xml new file mode 100644 index 0000000000..ada40c16c6 --- /dev/null +++ b/doc/src/docbkx/openstack-training/bk003-ch003-developer-general.xml @@ -0,0 +1,9 @@ + + + OpenStack Development Engineer, General Material To Learn +User Stories are referenced here + diff --git a/doc/src/docbkx/openstack-training/bk003-ch010-developer-assessment.xml b/doc/src/docbkx/openstack-training/bk003-ch010-developer-assessment.xml index dfe374077f..96947778e1 100644 --- a/doc/src/docbkx/openstack-training/bk003-ch010-developer-assessment.xml +++ b/doc/src/docbkx/openstack-training/bk003-ch010-developer-assessment.xml @@ -2,12 +2,49 @@ - Developer Assessment + OpenStack Development Engineer, Assessment - - - - - + + + + + + + + + + + + + + + + +
Assessment Question 1
TaskCompleted?
+ Configure a .... + + +
+ + + + + + + + + + + + + + + + +
Assessment Question 2
TaskCompleted?
+ Configure a .... + + +
diff --git a/doc/src/docbkx/openstack-training/bk004-ch001-devops-what-does-this-book-intend-to-teach.xml b/doc/src/docbkx/openstack-training/bk004-ch001-devops-what-does-this-book-intend-to-teach.xml index dade9a177e..787d9ff92b 100644 --- a/doc/src/docbkx/openstack-training/bk004-ch001-devops-what-does-this-book-intend-to-teach.xml +++ b/doc/src/docbkx/openstack-training/bk004-ch001-devops-what-does-this-book-intend-to-teach.xml @@ -2,7 +2,7 @@ - DevOps What Does This Book Intend to Teach + OpenStack DevOps Architect, What Does This Book Intend to Teach Combination of Operator and Developer training diff --git a/doc/src/docbkx/openstack-training/bk004-ch002-devops-getting-started.xml b/doc/src/docbkx/openstack-training/bk004-ch002-devops-getting-started.xml index 3e2b81cf33..fce844054e 100644 --- a/doc/src/docbkx/openstack-training/bk004-ch002-devops-getting-started.xml +++ b/doc/src/docbkx/openstack-training/bk004-ch002-devops-getting-started.xml @@ -2,12 +2,15 @@ - DevOps Getting Started + OpenStack DevOps Architect, Getting Started - + Knowledge and skills + + Materials and equipment + diff --git a/doc/src/docbkx/openstack-training/bk004-ch003-devops-general.xml b/doc/src/docbkx/openstack-training/bk004-ch003-devops-general.xml new file mode 100644 index 0000000000..9034981c2f --- /dev/null +++ b/doc/src/docbkx/openstack-training/bk004-ch003-devops-general.xml @@ -0,0 +1,9 @@ + + + OpenStack DevOps Architect, General Material To Learn +User Stories are referenced here + diff --git a/doc/src/docbkx/openstack-training/bk004-ch010-devops-assessment.xml b/doc/src/docbkx/openstack-training/bk004-ch010-devops-assessment.xml index 2e8c0e6487..44ed2a32bf 100644 --- a/doc/src/docbkx/openstack-training/bk004-ch010-devops-assessment.xml +++ b/doc/src/docbkx/openstack-training/bk004-ch010-devops-assessment.xml @@ -2,12 +2,49 @@ - DevOps Assessment + OpenStack DevOps Architect, Assessment - - - - - + + + + + + + + + + + + + + + + +
Assessment Question 1
TaskCompleted?
+ Configure a .... + + +
+ + + + + + + + + + + + + + + + +
Assessment Question 2
TaskCompleted?
+ Configure a .... + + +
diff --git a/doc/src/docbkx/openstack-training/operator-fix-bug.xml b/doc/src/docbkx/openstack-training/operator-fix-documentation-bug.xml similarity index 92% rename from doc/src/docbkx/openstack-training/operator-fix-bug.xml rename to doc/src/docbkx/openstack-training/operator-fix-documentation-bug.xml index 8215d5ac62..d9d5a3063b 100644 --- a/doc/src/docbkx/openstack-training/operator-fix-bug.xml +++ b/doc/src/docbkx/openstack-training/operator-fix-documentation-bug.xml @@ -3,8 +3,8 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" - xml:id="operator-fix-bug"> - Fix a Bug + xml:id="operator-fix-documentation-bug"> + Fix a Documentation Bug
Get Tools and Accounts @@ -13,6 +13,9 @@ Create a GitHub account at github.com. + + Download and install Git from GitHub + Create your local repository directory $mkdir /Users/yourusername/code/ @@ -31,7 +34,7 @@ Add your GitHub username and password - Set your local + Set your local repository location @@ -72,9 +75,7 @@ /usr/local/apache-maven - create variables - - + Set your maven user profile settings export M2_HOME=/usr/local/apache-maven/apache-maven-3.0.5 export M2=$M2_HOME/bin export PATH=$M2:$PATH @@ -110,18 +111,17 @@ export MAVEN_OPTS='-Xms256m -XX:MaxPermSize=1024m -Xmx1024m' - Create a Github account and add SSH keys to your - account profile (same one as used in Launchpad, they must - match). When you copy and paste the SSH key, include the - ssh-rsa algorithm and computer identifier. If this is your - first time setting up git and Github, be sure to run these - steps in a Terminal window: + Add your SSH keys to your GitHub account profile (same one as used in + Launchpad, they must match). When you copy and paste the SSH key, include + the ssh-rsa algorithm and computer identifier. If this is your first time + setting up git and Github, be sure to run these steps in a Terminal + window: $git config --global user.name "Firstname Lastname" $ git config --global user.email "your_email@youremail.com" - Install git-review. If pip is not already installed, - use "sudo easy_install pip" to install it on a Mac or + Install git-review. If pip is not already installed, use "sudo easy_install pip" to install it on a Mac or Ubuntu $sudo pip install git-review @@ -204,8 +204,8 @@ $ git config --global user.email "your_email@youremail.com" Commit the changes - $git commit -a -m " Removed reference to volume scheduler in the computer scheduler - config and admin pages, bug 1188522, author sean roberts" + $git commit -a -m "Removed reference to volume scheduler in the computer scheduler + config and admin pages, bug 1188522" Submit the bug fix to Gerrit @@ -248,7 +248,7 @@ $ git config --global user.email "your_email@youremail.com" Final commit - $git review -v + $git review Update the Jenkins status to change completed diff --git a/doc/src/docbkx/openstack-training/st-training-guides.xml b/doc/src/docbkx/openstack-training/st-training-guides.xml index 9ddf91c303..12dfde61ee 100644 --- a/doc/src/docbkx/openstack-training/st-training-guides.xml +++ b/doc/src/docbkx/openstack-training/st-training-guides.xml @@ -80,8 +80,10 @@ + + diff --git a/doc/src/docbkx/openstack-training/userstory-includes-template.xml b/doc/src/docbkx/openstack-training/userstory-includes-template.xml index 83efd807c2..708810c3b1 100644 --- a/doc/src/docbkx/openstack-training/userstory-includes-template.xml +++ b/doc/src/docbkx/openstack-training/userstory-includes-template.xml @@ -3,8 +3,8 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" - xml:id="userstory-includes-template"> - Including external content for user stories + xml:id="userstory-includes-template_version_1.0"> + Including external content for user stories, version 1.0 Save your user story file as associate-my-user-story, operator-my-user-story, etc. For example my user story that I assigned myself is operator bug fix so the file name would be operator-bug-fix.xml. See the operator-bug-fix.xml file in the repository for more