153 lines
10 KiB
XML
153 lines
10 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<book 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-preface">
|
|
<title>Start Here</title>
|
|
<preface xml:id="preface">
|
|
<title>Preface</title>
|
|
<?dbhtml stop-chunking?>
|
|
<xi:include href="../common/section_dochistory.xml"/>
|
|
</preface>
|
|
<appendix xml:id="under-construction">
|
|
<title>OpenStack Training Guides Are Under Construction</title>
|
|
<para>We need your help! This is a community driven project to provide the user group community
|
|
access to OpenStack training materials. We cannot make this work without your help.</para>
|
|
<para>There are a few ways to get involved. The easiest way is to use the training guides. Look at
|
|
the end of each section and you will see the Submit a Bug link. When you find something that can
|
|
be improved or fixed, submit a bug by clicking on the link.</para>
|
|
<para>If you want to get involved with the effort around OpenStack community training, read on,
|
|
here are the options:</para>
|
|
<para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<formalpara><title>Attending a user group using the training materials</title>
|
|
<para>The OpenStack community training started at the SFBay OpenStack User Group. More
|
|
information on this user group and others using the training guides on the <link
|
|
xlink:href="https://wiki.openstack.org/wiki/OpenStackUserGroups">OpenStack User Groups
|
|
page</link>.</para>
|
|
</formalpara>
|
|
</listitem>
|
|
<listitem>
|
|
<formalpara><title>Teach / Lead a user group using the training materials</title>
|
|
<para>Awesome! Your experience will not only give you more experience with OpenStack, but
|
|
you will help some people find new jobs. We have put all the information about <link
|
|
xlink:href="https://wiki.openstack.org/wiki/OpenStackUserGroups/HowTo#Running_a_Hackathon"
|
|
>How To Run An OpenStack Hackathon</link> here.</para></formalpara>
|
|
</listitem>
|
|
<listitem>
|
|
<formalpara>
|
|
<title>Help create the training pages</title>
|
|
<para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>We are currently working on creating the Associate Training Guide. It is the
|
|
first of four training guides. We are using the Install Guide, Administration
|
|
Guides, Developer Documentation, and Aptira supplied content as the sources for
|
|
most of the Associate Training Guide. The basic idea is that we use XML include
|
|
statements to actually use the source content to create new pages. We aim to use
|
|
as much of the material as possible from existing documentation. By doing this
|
|
we reuse and improve the existing docs. The topics in the Associate Training
|
|
Guide are in a bunch of KanBan story board cards. Each card in the story board
|
|
represents something that an Associate trainee needs to learn. But first things
|
|
first, you need to get some basic tools and accounts installed and configured
|
|
before you can really start.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold">Getting Accounts and Tools:</emphasis> We can't do
|
|
this without operators and developers using and creating the content. Anyone can
|
|
contribute content. You will need the tools to get started. Go to the <link
|
|
xlink:href="operator-getting-started-lab.html#getting-tools-and-accounts"
|
|
>Getting Tools and Accounts</link> page.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold">Pick a Card:</emphasis> Once you have your tools ready
|
|
to go, you can assign some work to yourself. Go to the <link
|
|
xlink:href="https://trello.com/board/openstack-training/51d6e5fee37248fd5b003de9"
|
|
>Training Trello/KanBan storyboard</link> and assign a card / user story from
|
|
the Sprint Backlog to yourself. If you do not have a Trello account, no problem,
|
|
just create one. Email seanrob@yahoo-inc.com and you will have access.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold">Create the Content:</emphasis> Each card / user story
|
|
from the KanBan story board will be a separate chunk of content that you will
|
|
add to the openstack-manuals repository openstack-training sub-project.
|
|
<link xlink:href="operator-getting-started-lab.html#operator-add-training-content">
|
|
More details on creating training content here.</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</formalpara>
|
|
<note>
|
|
<para>Here are more details on committing changes to OpenStack <link
|
|
xlink:href="operator-getting-started-lab.html#submit-doc-bug">fixing a documentation bug</link>
|
|
, <link xlink:href="https://wiki.openstack.org/wiki/Gerrit_Workflow">OpenStack Gerrit
|
|
Workflow</link>, <link xlink:href="https://wiki.openstack.org/wiki/Documentation/HowTo">OpenStack
|
|
Documentation HowTo</link> and , <link xlink:href="http://git-scm.com/doc">Git Documentation</link></para>
|
|
</note>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
<para>More details on the OpenStack Training project.</para>
|
|
<para>
|
|
<orderedlist>
|
|
<listitem>
|
|
<para><link xlink:href="https://wiki.openstack.org/wiki/Training-manuals">OpenStack Training
|
|
Wiki</link> (describes the project in detail)</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://blueprints.launchpad.net/openstack-manuals/+spec/training-manuals"
|
|
>OpenStack Training blueprint</link>(this is the key project page)</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link xlink:href="http://www.meetup.com/openstack/">Bi-Weekly SFBay Hackathon meetup
|
|
page</link>(we discuss project details with all team members)</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link xlink:href="https://etherpad.openstack.org/sfbay-openstack">Bi-Weekly SFBay
|
|
Hackathon Etherpad</link>(meetup notes)</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link xlink:href="https://wiki.openstack.org/wiki/Meetings/training-manuals">Core
|
|
Training Weekly Meeting Agenda</link>(we review project action items here)</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link
|
|
xlink:href="https://trello.com/board/openstack-training/51d6e5fee37248fd5b003de9"
|
|
>Training Trello/KanBan storyboard</link>(we develop high level project action items
|
|
here)</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</para>
|
|
<para><link xlink:href="https://blueprints.launchpad.net/openstack-manuals/+filebug" xlink:show="new">Submit a bug. Enter the summary as "Training, " with a few words. Be descriptive as possible in the description field. Open the tag pull-down and enter training-manuals.</link>
|
|
</para>
|
|
</appendix>
|
|
<appendix xml:id="building-training-cluster">
|
|
<title>Building the Training Cluster</title>
|
|
<?dbhtml stop-chunking?>
|
|
<section xml:id="important-terms">
|
|
<title>Important Terms</title>
|
|
<xi:include href="./lab000-important-terms.xml"
|
|
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'lab000-important-terms']/*[not(self::db:title)])">
|
|
<xi:fallback><para><mediaobject><imageobject><imagedata fileref="figures/openstack-training-remote-content-not-available.png" format="PNG"/></imageobject></mediaobject>Remote content not available</para><para>image source</para><para><link xlink:href="https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing">https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing</link></para></xi:fallback>
|
|
</xi:include>
|
|
</section>
|
|
<section xml:id="virtualbox-scripted">
|
|
<title>Building the Training Cluster, Scripted</title>
|
|
<xi:include href="./training-cluster-by-script.xml"
|
|
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'training-cluster-by-script']/*[not(self::db:title)])">
|
|
<xi:fallback><para><mediaobject><imageobject><imagedata fileref="figures/openstack-training-remote-content-not-available.png" format="PNG"/></imageobject></mediaobject>Remote content not available</para><para>image source</para><para><link xlink:href="https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing">https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing</link></para></xi:fallback>
|
|
</xi:include>
|
|
</section>
|
|
<section xml:id="virtualbox-manual">
|
|
<title>Building the Training Cluster, Manually</title>
|
|
<xi:include href="./lab000-virtualbox-basics.xml"
|
|
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'lab000-virtualbox-basics']/*[not(self::db:title)])">
|
|
<xi:fallback><para><mediaobject><imageobject><imagedata fileref="figures/openstack-training-remote-content-not-available.png" format="PNG"/></imageobject></mediaobject>Remote content not available</para><para>image source</para><para><link xlink:href="https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing">https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing</link></para></xi:fallback>
|
|
</xi:include>
|
|
</section>
|
|
</appendix>
|
|
<xi:include href="../common/app_support.xml"/>
|
|
</book>
|