552ed9399a
Detail conventions used in all books. First and only conventions detailed for now: prompts and admonitions. Use a common ch_preface.xml for all books. Change-Id: I7ed5c8b63ed9277dfdbccc55eb76e97e364118c8
55 lines
2.7 KiB
XML
55 lines
2.7 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 audience="enduser">use</phrase><phrase
|
|
audience="adminuser">administer</phrase> an OpenStack
|
|
cloud?</title>
|
|
<?dbhtml stop-chunking?>
|
|
<para audience="enduser">As an OpenStack cloud end user, you can
|
|
provision your own resources within the limits set by
|
|
administrators.</para>
|
|
<para audience="adminuser">As an OpenStack cloud administrative
|
|
user, you can manage tenants, known as
|
|
<glossterm baseform="project">projects</glossterm>, 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 audience="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 audience="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_conventions.xml"/>
|
|
<xi:include href="../common/section_dochistory.xml"/>
|
|
</preface>
|