openstack/openstack-manuals
Code Issues Proposed changes

Merge "publishing cleanup"

Browse Source
This commit is contained in:
Jenkins 2013-08-10 00:51:42 +00:00 committed by Gerrit Code Review
commit d9668ef862
19 changed files with 230 additions and 209 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/docbkx/openstack-training/bk001-ch001-associate-what-does-this-book-intend-to-teach.xml
View File

@ -2,7 +2,7 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk001-ch001-associate-what-does-this-book-intend-to-teach">
<title>Associate What Does This Book Intend to Teach</title>
<title>OpenStack Associate Engineer, What Does This Book Intend to Teach</title>
<para>
<orderedlist>
<listitem>

9
doc/src/docbkx/openstack-training/bk001-ch002-associate-getting-started.xml
View File

@ -2,12 +2,15 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk002-ch001-associate-getting-started">
<title>Associate Getting Started</title>
<title>OpenStack Associate Engineer, Getting Started</title>
<para>
<orderedlist>
<listitem>
<para/>
</listitem>
<para>Knowledge and skills</para>
</listitem>
<listitem>
<para>Materials and equipment</para>
</listitem>
</orderedlist>
</para>
</chapter>

2
doc/src/docbkx/openstack-training/bk001-ch003-associate-general.xml
View File

@ -4,6 +4,6 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="bk001-ch003-associate-general">
<title>Associate General</title>
<title>OpenStack Associate Engineer, General Material To Learn</title>
<para>User Stories are referenced here</para>
</chapter>

50
doc/src/docbkx/openstack-training/bk001-ch004-associate-assessment.xml
View File

@ -2,12 +2,48 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk002-ch050-associate-assessment">
<title>Associate Assessment</title>
<para>
<orderedlist>
<listitem>
<title>OpenStack Associate Engineer, Assessment</title>
<para><table rules="all" width="1011">
<caption>Assessment Question 1</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</listitem>
</orderedlist>
</para>
</td>
</tr>
</tbody>
</table>
<table rules="all" width="1011">
<caption>Assessment Question 2</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
</para>
</chapter>

2
doc/src/docbkx/openstack-training/bk002-ch001-operator-what-does-this-book-intend-to-teach.xml
View File

@ -2,7 +2,7 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk002-ch001-operator-what-does-this-book-intend-to-teach">
<title>Operator What Does This Book Intend to Teach</title>
<title>OpenStack Operations Engineer, What Does This Book Intend to Teach</title>
<para>
<orderedlist>
<listitem>

11
doc/src/docbkx/openstack-training/bk002-ch002-operator-getting-started.xml
View File

@ -2,12 +2,15 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk003-ch002-operator-getting-started">
<title>Operator Getting Started</title>
<title>OpenStack Operations Engineer, Getting Started</title>
<para>
<orderedlist>
<listitem>
<para/>
</listitem>
<listitem>
<para>Knowledge and skills</para>
</listitem>
<listitem>
<para>Materials and equipment</para>
</listitem>
</orderedlist>
</para>
</chapter>

4
doc/src/docbkx/openstack-training/bk002-ch003-operator-general.xml
View File

@ -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">
<title>Operator General</title>
<title>OpenStack Operations Engineer, General Material To Learn</title>
<para>User Stories are referenced here</para>
<xi:include href="operator-fix-bug.xml"/>
<xi:include href="operator-fix-documentation-bug.xml"/>
</chapter>

185
doc/src/docbkx/openstack-training/bk002-ch008-operator-assessment.xml
View File

@ -2,9 +2,33 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk003-ch050-operator-assessment">
<title>Operator Assessment</title>
<title>OpenStack Operations Engineer, Assessment</title>
<para>
<table rules="all"><caption>Trainee tasks</caption>
<table rules="all" width="1011">
<caption>Assessment Question 1</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
<table rules="all" width="1011">
<caption>Assessment Question 2</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
@ -13,159 +37,14 @@
</thead>
<tbody>
<tr>
<td><para>Configure a ....</para></td>
<td><para></para></td>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
<orderedlist>
<listitem>
<para>As a trainee I must configure a virtual environment to accomplish the
configuration tasks</para>
</listitem>
<listitem>
<para>As a trainee I must understand the basic overview of OpenStack core projects</para>
</listitem>
<listitem>
<para>As a trainee I must understand the architecture the RefStack architecture described
in the Basic Install Guide</para>
</listitem>
<listitem>
<para>As a trainee I must understand how to install Ubuntu 12.04 (or 13.04 in later
versions)</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of the Controller Node in The RefStack
architecture described in the basic install guide</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of MySql server in the Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must install MySql server in the Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of RabbitMQ Messaging Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure RabbitMQ Messaging Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of OpenStack Identity Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must Install and Configure OpenStack Identity Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of OpenStack Image Service in the Controller
Node</para>
</listitem>
<listitem>
<para>As a trainee I must Install and configure OpenStack Identity Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of OpenStack Compute (Cloud Controller
Services) in the Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure OpenStack Compute (Cloud Controller
Services) in the Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of OpenStack Block Storage Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure OpenStack Block Storage Service in the
Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of OpenStack Network Service (cloud
controller) in the Controller Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure OpenStack Network Service (cloud
controller) in the Controller Node</para>
</listitem>
<listitem>
<para>As trainee I must verify the proper configuration and operation of the Controller
node within the RefStack architecture described in the Basic Install Guide</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of Network Node within the RefStack
architecture described in the Basic Install Guide</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of Open vSwitch in the Network Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure Open vSwitch in the Network Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of Neutron (formerly Quantum) in the Network
Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure Neutron (formerly Quantum) in the Network
Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand the how to create virtual networking in the Network
Node</para>
</listitem>
<listitem>
<para>As a trainee I must configure virtual networking in the Network Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand L3 Configuration in the Network Node</para>
</listitem>
<listitem>
<para>As a trainee I must configure L3 Configuration in the Network Node</para>
</listitem>
<listitem>
<para>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</para>
</listitem>
<listitem>
<para>As a trainee I must understand the role of Compute Node within the RefStack
architecture described in the Basic Install Guide</para>
</listitem>
<listitem>
<para>As a trainee I must understand Nova (compute node services) in the Compute Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure Nova (compute node services) in the
Compute Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand OpenStack Networking using Open vSwitch in the
Compute Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure OpenStack Networking using Open vSwitch in
the Compute Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand OpenStack Networking using Neutron (formerly Quantum)
in the Compute Node</para>
</listitem>
<listitem>
<para>As a trainee I must install and configure OpenStack Networking using Open Neutron
(formerly Quantum) n the Compute Node</para>
</listitem>
<listitem>
<para>As a trainee I must understand instantiation of a Virtual Machine (Instance) using
OpenStack Dashboard (Horizon)</para>
</listitem>
<listitem>
<para>As a trainee I must instantiate of a Virtual Machine (Instance) using OpenStack
Dashboard (Horizon)</para>
</listitem>
</orderedlist>
</para>
</chapter>

2
doc/src/docbkx/openstack-training/bk003-ch001-developer-what-does-this-book-intend-to-teach.xml
View File

@ -2,7 +2,7 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk003-ch001-developer-what-does-this-book-intend-to-teach">
<title>Developer What Does This Book Intend to Teach</title>
<title>OpenStack Development Engineer, What Does This Book Intend to Teach</title>
<para>
<orderedlist>
<listitem>

7
doc/src/docbkx/openstack-training/bk003-ch002-developer-getting-started.xml
View File

@ -2,12 +2,15 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="ch-developer-getting-started">
<title>Developer Getting Started</title>
<title>OpenStack Development Engineer, Getting Started</title>
<para>
<orderedlist>
<listitem>
<para/>
<para>Knowledge and skills</para>
</listitem>
<listitem>
<para>Materials and equipment</para>
</listitem>
</orderedlist>
</para>
</chapter>

9
doc/src/docbkx/openstack-training/bk003-ch003-developer-general.xml Normal file
View File

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="bk003-ch003-developer-general">
<title>OpenStack Development Engineer, General Material To Learn</title>
<para>User Stories are referenced here</para>
</chapter>

49
doc/src/docbkx/openstack-training/bk003-ch010-developer-assessment.xml
View File

@ -2,12 +2,49 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="ch-developer-assessment">
<title>Developer Assessment</title>
<title>OpenStack Development Engineer, Assessment</title>
<para>
<orderedlist>
<listitem>
<para/>
</listitem>
</orderedlist>
<table rules="all" width="1011">
<caption>Assessment Question 1</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
<table rules="all" width="1011">
<caption>Assessment Question 2</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
</para>
</chapter>

2
doc/src/docbkx/openstack-training/bk004-ch001-devops-what-does-this-book-intend-to-teach.xml
View File

@ -2,7 +2,7 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk004-ch001-devops-what-does-this-book-intend-to-teach">
<title>DevOps What Does This Book Intend to Teach</title>
<title>OpenStack DevOps Architect, What Does This Book Intend to Teach</title>
<para>
<orderedlist>
<listitem><para>Combination of Operator and Developer training</para>

7
doc/src/docbkx/openstack-training/bk004-ch002-devops-getting-started.xml
View File

@ -2,12 +2,15 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="ch-devops-getting-started">
<title>DevOps Getting Started</title>
<title>OpenStack DevOps Architect, Getting Started</title>
<para>
<orderedlist>
<listitem>
<para/>
<para>Knowledge and skills</para>
</listitem>
<listitem>
<para>Materials and equipment</para>
</listitem>
</orderedlist>
</para>
</chapter>

9
doc/src/docbkx/openstack-training/bk004-ch003-devops-general.xml Normal file
View File

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="bk004-ch003-devops-general">
<title>OpenStack DevOps Architect, General Material To Learn</title>
<para>User Stories are referenced here</para>
</chapter>

49
doc/src/docbkx/openstack-training/bk004-ch010-devops-assessment.xml
View File

@ -2,12 +2,49 @@
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="ch-devops-assessment">
<title>DevOps Assessment</title>
<title>OpenStack DevOps Architect, Assessment</title>
<para>
<orderedlist>
<listitem>
<para/>
</listitem>
</orderedlist>
<table rules="all" width="1011">
<caption>Assessment Question 1</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
<table rules="all" width="1011">
<caption>Assessment Question 2</caption>
<col width="95%"/>
<col width="05%"/>
<thead>
<tr>
<th>Task</th>
<th>Completed?</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Configure a ....</para>
</td>
<td>
<para/>
</td>
</tr>
</tbody>
</table>
</para>
</chapter>

34
doc/src/docbkx/openstack-training/operator-fix-bug.xml → doc/src/docbkx/openstack-training/operator-fix-documentation-bug.xml
View File

@ -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">
<title>Fix a Bug</title>
xml:id="operator-fix-documentation-bug">
<title>Fix a Documentation Bug</title>
<section xml:id="getting-tools-and-accounts">
<title>Get Tools and Accounts</title>
<para>
@ -13,6 +13,9 @@
<step>
<para>Create a GitHub account at github.com.</para>
</step>
<step>
<para>Download and install Git from GitHub</para>
</step>
<step>
<para>Create your local repository directory</para>
<screen><prompt>$</prompt><userinput>mkdir /Users/yourusername/code/</userinput></screen>
@ -31,7 +34,7 @@
<para>Add your GitHub username and password</para>
</step>
<step>
<para>Set your local</para>
<para>Set your local repository location</para>
</step>
</substeps>
</step>
@ -72,9 +75,7 @@
/usr/local/apache-maven</para>
</step>
<step>
<para>create variables</para>
</step>
<step>
<para>Set your maven user profile settings</para>
<screen><userinput>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'</userinput></screen
CLA.</para>
</step>
<step>
<para>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:</para>
<para>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:</para>
<screen><prompt>$</prompt><userinput>git config --global user.name "Firstname Lastname"
$ git config --global user.email "your_email@youremail.com" </userinput></screen>
</step>
<step>
<para>Install git-review. If pip is not already installed,
use "sudo easy_install pip" to install it on a Mac or
<para>Install git-review. If pip is not already installed, use "<emphasis
role="bold">sudo easy_install pip</emphasis>" to install it on a Mac or
Ubuntu</para>
<screen><prompt>$</prompt><userinput>sudo pip install git-review</userinput></screen>
</step>
@ -204,8 +204,8 @@ $ git config --global user.email "your_email@youremail.com" </userinput></screen
</step>
<step>
<para>Commit the changes</para>
<screen><prompt>$</prompt><userinput>git commit -a -m " Removed reference to volume scheduler in the computer scheduler
config and admin pages, bug 1188522, author sean roberts"</userinput></screen>
<screen><prompt>$</prompt><userinput>git commit -a -m "Removed reference to volume scheduler in the computer scheduler
config and admin pages, bug 1188522"</userinput></screen>
</step>
<step>
<para>Submit the bug fix to Gerrit</para>
@ -248,7 +248,7 @@ $ git config --global user.email "your_email@youremail.com" </userinput></screen
</step>
<step>
<para>Final commit</para>
<screen><prompt>$</prompt><userinput>git review -v</userinput></screen>
<screen><prompt>$</prompt><userinput>git review</userinput></screen>
</step>
<step>
<para>Update the Jenkins status to change completed</para>

2
doc/src/docbkx/openstack-training/st-training-guides.xml
View File

@ -80,8 +80,10 @@
<xi:include href="bk002-ch008-operator-assessment.xml"/>
<xi:include href="bk003-ch001-developer-what-does-this-book-intend-to-teach.xml"/>
<xi:include href="bk003-ch002-developer-getting-started.xml"/>
<xi:include href="bk003-ch003-developer-general.xml"/>
<xi:include href="bk003-ch010-developer-assessment.xml"/>
<xi:include href="bk004-ch001-devops-what-does-this-book-intend-to-teach.xml"/>
<xi:include href="bk004-ch002-devops-getting-started.xml"/>
<xi:include href="bk004-ch003-devops-general.xml"/>
<xi:include href="bk004-ch010-devops-assessment.xml"/>
</book>

4
doc/src/docbkx/openstack-training/userstory-includes-template.xml
View File

@ -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">
<title>Including external content for user stories</title>
xml:id="userstory-includes-template_version_1.0">
<title>Including external content for user stories, version 1.0</title>
<para>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