openstack-manuals/doc/common/ch_using_openstack_overview.xml
Stephen Gordon cf9fd1eadc ch_overview.xml is now shared between user guides.
ch_overview.xml is now shared between both user guides. As such it has
been moved to common, given a more descriptive name, and the relevant
xi:includes updated.

Change-Id: Iaf8e09364d3b2174045c775440fb45ca7162c908
2013-09-27 15:11:26 -04:00

52 lines
2.5 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<preface xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns:m="http://www.w3.org/1998/Math/MathML"
xmlns:html="http://www.w3.org/1999/xhtml"
xmlns:db="http://docbook.org/ns/docbook" version="5.0"
xml:id="openstack_user_guide">
<title>How can I <phrase os="enduser">use</phrase><phrase
os="adminuser">administer</phrase> an OpenStack
cloud?</title>
<?dbhtml stop-chunking?>
<para os="enduser">As an OpenStack cloud end user, you can
provision your own resources within the limits set by
administrators.</para>
<para os="adminuser">As an OpenStack cloud administrative user,
you can manage tenants, known as
<firstterm>projects</firstterm>, users, services, images,
flavors, and quotas.</para>
<para>The examples in this guide show you how to complete these
tasks with either:</para>
<itemizedlist>
<listitem>
<para>The OpenStack dashboard. Use this Web-based
graphical interface, code named <link
xlink:href="https://github.com/openstack/horizon/"
>horizon</link>, to view,
create, and manage resources<phrase os="adminuser"> and services</phrase>.</para>
</listitem>
<listitem>
<para>The OpenStack command-line clients. Each core
OpenStack project has a command-line client that lets
you run simple commands to view, create, and manage
resources<phrase os="adminuser"> and services</phrase> in a cloud and automate tasks by using
scripts.</para>
</listitem>
</itemizedlist>
<para>You can modify these examples for your specific use
cases.</para>
<para>In addition to these ways of interacting with a cloud, you
can access the OpenStack APIs directly or indirectly through
<link xlink:href="http://curl.haxx.se/">cURL</link>
commands or open SDKs. You can automate access or build tools
to manage resources and services by using the native OpenStack
APIs or the EC2 compatibility API.</para>
<para>To use the OpenStack APIs, it helps to be familiar with
HTTP/1.1, RESTful web services, the OpenStack services, and
JSON or XML data serialization formats.</para>
<xi:include href="../common/section_dochistory.xml"/>
</preface>