doc: Common graph used in 2 quick start files

The graph in quick-ceph-deploy.rst applies to
quick-start-preflight.rst.
The graph in deploy seems more complete, so I put the common
documentation in quick-common.rst and had it included.
doc/conf.py has 'start/quick-common.rst' in exclude patterns so that
sphinx does not complain about this file not being in toc.

Signed-off-by: Kevin Dalley <kevin@kelphead.org>

diff --git a/doc/conf.py b/doc/conf.py
index 62feb564655fd4de344f3ab752cd3d4dc5ff3b37..98ce7d861b3a64a2aa5b75ccbed919f7f72f9da8 100644 (file)
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -9,7 +9,7 @@ release = 'dev'
 templates_path = ['_templates']
 source_suffix = '.rst'
 master_doc = 'index'
-exclude_patterns = ['**/.#*', '**/*~']
+exclude_patterns = ['**/.#*', '**/*~', 'start/quick-common.rst']
 pygments_style = 'sphinx'
 
 html_theme = 'ceph'

diff --git a/doc/start/quick-ceph-deploy.rst b/doc/start/quick-ceph-deploy.rst
index 74635aede2786c78bb65f8160c40eb96d5e113c3..f2ad9ceddcbeccced56cfdb7777c96964b56490e 100644 (file)
--- a/doc/start/quick-ceph-deploy.rst
+++ b/doc/start/quick-ceph-deploy.rst
@@ -7,34 +7,7 @@ If you haven't completed your `Preflight Checklist`_, do that first. This
 on your admin node. Create a three Ceph Node cluster so you can 
 explore Ceph functionality. 
 
-.. ditaa:: 
-           /------------------\         /----------------\
-           |    Admin Node    |         |      node1     |
-           |                  +-------->+ cCCC           |
-           |    ceph–deploy   |         |    mon.node1   |
-           \---------+--------/         \----------------/
-                     |
-                     |                  /----------------\
-                     |                  |      node2     |
-                     +----------------->+ cCCC           |
-                     |                  |     osd.0      |
-                     |                  \----------------/
-                     |
-                     |                  /----------------\
-                     |                  |      node3     |
-                     +----------------->| cCCC           |
-                                        |     osd.1      |
-                                        \----------------/
-
-For best results, create a directory on your admin node node for maintaining the
-configuration that ``ceph-deploy`` generates for your cluster. ::
-
-       mkdir my-cluster
-       cd my-cluster
-
-.. tip:: The ``ceph-deploy`` utility will output files to the 
-   current directory. Ensure you are in this directory when executing
-   ``ceph-deploy``.
+.. include:: quick-common.rst
 
 As a first exercise, create a Ceph Storage Cluster with one Ceph Monitor and two
 Ceph OSD Daemons. Once the cluster reaches a ``active + clean`` state, expand it 
@@ -382,4 +355,4 @@ the migration manually.
 .. _placement group: ../../rados/operations/placement-groups
 .. _Monitoring a Cluster: ../../rados/operations/monitoring
 .. _Monitoring OSDs and PGs: ../../rados/operations/monitoring-osd-pg
-.. _Network Configuration Reference: ../../rados/configuration/network-config-ref
\ No newline at end of file
+.. _Network Configuration Reference: ../../rados/configuration/network-config-ref

diff --git a/doc/start/quick-common.rst b/doc/start/quick-common.rst
new file mode 100644 (file)
index 0000000..b30a336
--- /dev/null
+++ b/doc/start/quick-common.rst
@@ -0,0 +1,28 @@
+.. ditaa:: 
+           /------------------\         /----------------\
+           |    Admin Node    |         |      node1     |
+           |                  +-------->+ cCCC           |
+           |    ceph–deploy   |         |    mon.node1   |
+           \---------+--------/         \----------------/
+                     |
+                     |                  /----------------\
+                     |                  |      node2     |
+                     +----------------->+ cCCC           |
+                     |                  |     osd.0      |
+                     |                  \----------------/
+                     |
+                     |                  /----------------\
+                     |                  |      node3     |
+                     +----------------->| cCCC           |
+                                        |     osd.1      |
+                                        \----------------/
+
+For best results, create a directory on your admin node node for maintaining the
+configuration that ``ceph-deploy`` generates for your cluster. ::
+
+       mkdir my-cluster
+       cd my-cluster
+
+.. tip:: The ``ceph-deploy`` utility will output files to the 
+   current directory. Ensure you are in this directory when executing
+   ``ceph-deploy``.

diff --git a/doc/start/quick-start-preflight.rst b/doc/start/quick-start-preflight.rst
index 7118936c934054d02e41d6e5ce358817bf6d29e4..18cad204ad113435ba9fdb192baef7bcc553a72a 100644 (file)
--- a/doc/start/quick-start-preflight.rst
+++ b/doc/start/quick-start-preflight.rst
@@ -11,25 +11,10 @@ three Ceph Nodes (or virtual machines) that will host your Ceph Storage Cluster.
 Before proceeding any further, see `OS Recommendations`_ to verify that you have
 a supported distribution and version of Linux.
 
+In the descriptions below, :term:`Node` refers to a single machine.
+
+.. include:: quick-common.rst
 
-.. ditaa:: 
-           /------------------\         /----------------\
-           |    Admin Node    |         |     node1      |
-           |                  +-------->+                |
-           |    ceph–deploy   |         | cCCC           |
-           \---------+--------/         \----------------/
-                     |
-                     |                  /----------------\
-                     |                  |     node2      |
-                     +----------------->+                |
-                     |                  | cCCC           |
-                     |                  \----------------/
-                     |
-                     |                  /----------------\
-                     |                  |     node3      |
-                     +----------------->|                |
-                                        | cCCC           |
-                                        \----------------/
 
 
 Ceph Deploy Setup