Commit Graph

45 Commits (6320f3aac79e817e766fdcee66108d2204e182bd)

Author SHA1 Message Date
Sébastien Han b511b8679e Merge pull request #2064 from berendt/sphinx-conf-do-not-set-release-version
Do not set release/version in sphinx configuration
2017-10-17 11:06:28 +02:00
Christian Berendt 9a1e789a98 Add missing backticks in docs index 2017-10-17 11:00:02 +02:00
Christian Berendt 611138484d Do not set release/version in sphinx configuration 2017-10-17 10:55:54 +02:00
Guillaume Abrioux ea7a8fb807 Docs: fix error `Unknown target name`
Signed-off-by: Guillaume Abrioux <gabrioux@redhat.com>
2017-10-10 11:36:03 +02:00
Sébastien Han f92eaea0fd Merge pull request #1977 from ktdreyer/doc-master-ansible-version
docs: master requires ansible 2.3.1
2017-10-03 22:55:22 +02:00
Ken Dreyer a1273f3dc8 docs: add instructions for installing Ansible
Add RPM and DEB instructions for installing Ansible.
2017-10-03 11:39:39 -06:00
Ken Dreyer 07edf7e38a docs: master requires ansible 2.3.1
We require Ansible 2.3.1 or greater to run ceph-ansible's master branch.
2017-10-03 11:26:43 -06:00
Sébastien Han ae2fd45994 common: refactor installation method
The installation process is now described as follow:

* you still have to choose a 'ceph_origin' installation method. The
origin can be a 'repository' (add a new repository), distro (it will use
the packages provided by the native repo source of your distribution),
local (only available on redhat system, it installs locally built
packages). This option is not well tested, so use it carefully

* if ceph_origin == 'repository' you will have to decide what kind of
repository you want to enable:
  - community: corresponds to the stable upstream/community version
  - enterprise: corresponds to the stable enterprise/downstream version
    (basically you are a red hat customer)
  - dev: it will install ceph from packages built out of the github
    development branches

Signed-off-by: Sébastien Han <seb@redhat.com>
Co-Authored-by: Guillaume Abrioux <gabrioux@redhat.com>
Signed-off-by: Guillaume Abrioux <gabrioux@redhat.com>
2017-08-30 10:52:01 +02:00
Andrew Schoen 594d5e017a ceph-osd: restructure lvm_volumes variable for more flexiblity
The lvm_volumes variable is now a list of dictionaries that represent
each OSD you'd like to deploy using ceph-volume. Each dictionary must
have the following keys: data, journal and data_vg. Each dictionary also
can optionaly provide a journal_vg key.

The 'data' key represents the lv name used for the OSD and the 'data_vg'
key is the vg name that the given lv resides on. The 'journal' key is
either an lv, device or partition. The 'journal_vg' key is optional and
must be the vg name for the journal lv if given. This key is mainly used
for purging of the journal lv if purge-cluster.yml is run.

For example:

  lvm_volumes:
    - data: data_lv1
      journal: journal_lv1
      data_vg: vg1
      journal_vg: vg2
    - data: data_lv2
      journal: /dev/sdc
      data_vg: vg1

Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-23 10:14:14 -05:00
Andrew Schoen 482114e9c5 docs: add examples for collocated and non-collocated osd scenarios
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-18 11:08:56 -05:00
Andrew Schoen 90efa30e27 docs: move testing/glossary after index in glossary.rst
We want the usage docs before the testing docs on this page.

Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-18 11:06:59 -05:00
Andrew Schoen 16faf78ce2 docs: add docs for dev contributions
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-17 16:03:04 -05:00
Andrew Schoen da4a42de0a docs: add docs for ceph_conf_overrides usage
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-17 16:03:04 -05:00
Andrew Schoen a5116b2ff1 docs: add links to example videos
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-17 16:03:04 -05:00
Andrew Schoen ae60030c6c docs: collocated and non-collocated scenario docs
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-17 16:03:04 -05:00
Andrew Schoen 4d85560a5d docs: docs for installation and basic config
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-17 11:02:14 -05:00
Andrew Schoen e597628be9 lvm: update scenario for new osd_scenario variable
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-04 06:38:36 -05:00
Andrew Schoen fd4a021051 docs: add docs for the lvm_osds OSD scenario
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-08-04 06:13:09 -05:00
Andrew Schoen 7293c40c40 tests: run all existing tests with shaman repos
If you use the 'dev' factor, the testing scenario will
use repos from shaman.ceph.com. You can define CEPH_DEV_BRANCH
and CEPH_DEV_SHA1 to specify which repo you'd like to test.

Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-07-17 14:42:32 -05:00
Andrew Schoen 8472472194 docs: update tox docs to reflect the removed environment variables
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-05-02 14:15:42 -05:00
Andrew Schoen e8e4245e43 Merge pull request #1453 from ceph/docs-fixtures
[docs] fixtures and Python tests
2017-04-17 15:46:02 -05:00
Andrew Schoen 03cafa3108 docs: review feedback on testing/tox.rst
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-04-17 15:39:01 -05:00
Andrew Schoen b45209c951 docs: fix rst error in scenarios.rst
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-04-17 15:29:18 -05:00
Andrew Schoen 80142ef3fd docs: write docs for tox.ini file
Signed-off-by: Andrew Schoen <aschoen@redhat.com>
2017-04-17 15:29:18 -05:00
Alfredo Deza 697e7534d0 docs: describe Python tests and fixtures
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-17 16:28:52 -04:00
Alfredo Deza f50494d7be docs: conventions for test layouts
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-17 16:28:52 -04:00
Alfredo Deza edc7872cea docs: describe all required scenario files
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-13 12:03:41 -04:00
Alfredo Deza 7412c085f0 docs: scenario files and section descriptions
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-13 10:17:55 -04:00
Alfredo Deza d26ed99dcc docs: force an empty _static dir so sphinx is happy
Signed-off-by: Alfredo Deza <adeza@redhat.com>
(cherry picked from commit aacbbf0efe)
2017-04-11 09:11:09 -04:00
Alfredo Deza df315fef89 docs: force an empty _templates dir so sphinx is happy
Signed-off-by: Alfredo Deza <adeza@redhat.com>
(cherry picked from commit 66a9817e56)
2017-04-11 09:11:01 -04:00
Alfredo Deza e8ae5c6aaf docs: add missing sections/refs in scenarios.rst
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:18:15 -04:00
Alfredo Deza c768f34219 docs: include testing conventions and testinfra in layout.rst
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:17:53 -04:00
Alfredo Deza 7eb26d1b00 docs: fix typo in testing/index.rst
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:17:31 -04:00
Alfredo Deza 3cde692482 docs: include the tests and tox files in the glossary
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:17:13 -04:00
Alfredo Deza f895b4c376 docs: create a tests doc file
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:07:42 -04:00
Alfredo Deza cb504f6d88 docs: create a separate tox doc file
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:07:26 -04:00
Alfredo Deza 41815f6b53 docs: use glossary for the :doc: directive
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:06:36 -04:00
Alfredo Deza ae6349fd21 docs: add the testing glossary in the toctree
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:06:16 -04:00
Alfredo Deza a5b2ede0ff docs: normalize the glossary vs. contents files
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 12:05:55 -04:00
Alfredo Deza 14d46cb2be docs: create a separate docs tox.ini
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-07 11:41:59 -04:00
Alfredo Deza 1f3d78e6c2 docs: initial structure for tests docs
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-06 13:17:54 -04:00
Alfredo Deza 0d0e427a6c docs create a separate glossary file
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-06 13:17:54 -04:00
Alfredo Deza 20210c35de docs: the master doc is the glossary file
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-06 13:17:54 -04:00
Alfredo Deza 1ad331b026 docs: ignore build contents from git
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-06 13:11:52 -04:00
Alfredo Deza 1a181fff4c docs: initial take on doc structure
Signed-off-by: Alfredo Deza <adeza@redhat.com>
2017-04-06 13:11:52 -04:00