47 Commits

Author SHA1 Message Date
caoyuan
b9378126e9 Fix the "tox -e docs" failed
doc/running-tests.rst:64: D001 Line too long
doc/bifrost.rst:164: D000 Unknown target name: "edit-inventory".
doc/nova-fake-driver.rst:: WARNING: document isn't included in any
toctree

Change-Id: I83bb44ed10cb464f87e5235a423a475151ace208
2017-04-03 15:53:28 +08:00
Jenkins
b5a0ed3280 Merge "Remove image building related docs from kolla-ansible" 2017-03-30 13:20:45 +00:00
Paul Bourke
ab83caeba0 Remove image building related docs from kolla-ansible
Add links to refer to the main Kolla documentation. Also fix minor
formatting errors that were preventing the docs from building.

Change-Id: I8759b9e995097d221900441bd001a1234ae007fd
Depends-On: Ia7959c71a241b9d7139ec50b34e36b24fbcf76e6
Co-Authored-By: Mauricio Lima <mauriciolimab@gmail.com>
2017-03-30 13:07:55 +00:00
Jenkins
225bc54f07 Merge "Improved documentation for central logging." 2017-03-23 09:03:26 +00:00
Alicja Kwasniewska
e11c6b0d71 Improved documentation for central logging.
Added a note about Elasticsearch using volume space.
Renamed Kibana guide to central-logging guide.

Change-Id: I0a451b5316a53815a53c62faa2bf993ca34f27e0
Closes-Bug: #1614572
2017-03-22 15:31:22 +00:00
rcherrueau
dcdbe44190
Multi-regions Support
Add support for basic multiple regions, that is to say, many OpenStack
with a shared Keystone (same users) and Horizon. The shared Keystone
and Horizon are deployed into one region, for instance RegionOne.
Services of other regions have an access to this Keystone. This
support assumes that the operator knows the name of all OpenStack
regions in advance, and considers as many Kolla runs as there are
regions.

The new variable, multiple_regions_names, contains the name of
regions. It is needed by the region that includes Keystone and
Horizon. In register.yml, it specifies to create as many Keystone
endpoints as there are regiones, so that services of other regions can
connect to Keystone. In local_settings.j2, it changes the render to
support multiple regions in Horizon. The multi-regions.rst explains
how to perform a multiple regions deployment.

Implements: blueprint multi-kolla-config
Change-Id: Icab2aebfc4de0e3bc609950956e0af397705f403
2017-03-10 14:24:42 +01:00
Eduardo Gonzalez
e516ea5099 Integrate designate with neutron
Integrate designate service with neutron to allow instances
and floatingip resolve designate dns.
MDNS service need to be reachable from nova instances
in order to resolve DNS queries.
Added new dns_interface to make this configurable.
Add designate guide.

Closes-Bug: #1661330

Change-Id: I5a2ac5cf2a9aa0977ae42d53dd64699623ddf3ed
2017-02-03 11:06:59 +00:00
Jenkins
5ad227ad67 Merge "Update Kolla-Ansible documents" 2017-01-30 16:18:56 +00:00
Francisco Edigleison Barbosa
46b9952441 Add how configure backend to cinder HNAS iSCSI driver guide
Change-Id: I11f93fd1aa7926b568fba355da3cb5fec3badbd8
2017-01-30 11:04:57 -03:00
Sayantani Goswami
5b35e3898f Update Kolla-Ansible documents
Kolla-ansible related documents existed on both Kolla and Kolla-Ansible
repositories. A lot of Kolla-ansible related documents were updated in
the Kolla repository. Porting the changes made to these documents in
Kolla repo to Kolla-Ansible repo so that the Kolla-ansible documents can
be removed (Refer to patch https://review.openstack.org/#/c/425749/)

Change-Id: I7c53626ce551189acdb0dcbabe9369b81eed3347
2017-01-28 06:20:37 +00:00
Mauricio Lima
f11a50457c Add guide for Hitachi NAS Platform Driver for Manila
Co-Authored-By: Francisco Edigleison Barbosa <barbosaedigleison@gmail.com>
Change-Id: Ib4fab8a3a83ec71152a526383ad58fc3e52d326e
2016-10-17 09:30:15 -03:00
Jeffrey Zhang
55f0642c14 Add a note for how to get prior release kolla doc
Change-Id: Iff8185ebd39f633512a20a07889bd01b6ee4e037
2016-09-27 14:56:28 +00:00
Christian Berendt
b5d1b3a5df Document bug triage
Change-Id: I909d92f8f67e5dbe0d697e05cc2f8f7424add25d
2016-09-22 15:26:44 +02:00
Michal (inc0) Jastrzebski
43307904dd Add architecture guide back to index.rst
It was removed in some of patches (probably bad rebase?)

TrivialFix
Change-Id: Ie9542012c1c6cb0252284196389eb6618862a148
2016-09-21 14:34:14 +00:00
prithiv
ef9d6ea8be Add networking guide for Neutron extensions
With Kolla supporting Neutron extensions, it is
essential to have networking guide to describe the
installation and configuration of these extensions.

Partial-Bug: #1603391

Change-Id: I78ff5b17e4024d96f8083c96ac5b5b608a7c0015
2016-09-16 10:18:26 +01:00
Hui Kang
0d28b311eb Add Kuryr ansible role
Change-Id: I7134bffab940ee780e5f5010d639af56f97b41d6
Co-authored-by: Mohammad Banikazemi <mb@us.ibm.com>
Co-Authored-By: zhubingbing <zhubingbing10@gmail.com>
Co-Authored-By: Antoni Segura Puimedon <antonisp@celebdor.com>
Partially-implements: bp kuryr-docker-plugin
2016-09-15 23:47:22 +00:00
Steven Dake
28b80a08cf Revert "Build a more organized doc structure"
Our philosophy document is one of our most important documents
in he documentation repository.  I appreciate in general the notion
of reorganizing many of our docs, but this one should be left alone
and possibly protected by a roll-call vote in the future.

This reverts commit aa517c4bf965f06dc9bcb20220d675ff6e77e94c.

Change-Id: Ic17861e823095a1891ac25ddaf429b66e352e30e
2016-09-12 12:13:48 -07:00
Jenkins
970eff43f3 Merge "introduce bifrost-deploy container" 2016-08-31 12:45:50 +00:00
Sean Mooney
a9e16c8bde introduce bifrost-deploy container
- This change adds support for building and deploying
  a bifrost container for baremetal provisioning.
- This change documents how to manually deploy and bootstrap
  the bifrost container.

Implements: blueprint bifrost-support
Change-Id: I7d895839b11cbf916be33225875465c3358b5aa4
2016-08-31 09:24:24 +00:00
Michal (inc0) Jastrzebski
906c074901 Architecture guide doc
First few paragraphs with richer description on choices deployers can
make while deploy of production kolla

Co-Authored-By: Paul Bourke <paul.bourke@oracle.com>

Change-Id: I3a2d3cf2cbb3678db2dc100e9a63b4992817cc3b
2016-08-29 19:46:01 +00:00
Jenkins
7bf87dddec Merge "Remove heat dev environment" 2016-08-19 02:25:51 +00:00
Ryan Hallisey
aa517c4bf9 Build a more organized doc structure
Use directories to further organize the path a user would
take through the docs.

Change-Id: I8e3885c7ac3a72eaadbf547efedf0de477aa0a9f
Partially-implements: blueprint documentation-rework
2016-08-17 06:28:29 -04:00
Christian Berendt
608f6c7571 Remove heat dev environment
The heat dev environment is not functional, remove it to avoid confusions.

Change-Id: I05ac25294516270328ca1fe88f15defeea570306
Partial-bug: #1562334
2016-08-09 15:25:35 +02:00
Mathias Ewald
3894883871 External Ceph - Implementation Cinder
This patch adds support for external Ceph clusters for Cinder.

For clean integration the backend configuration mechanism had to be
slightly adjusted.

We now have the option to enable multiple backends for Cinder
independently.

Currently, the flags cinder_backend_iscsi and cinder_backend_ceph are
used to toggle backends.

Documentation on how to use external ceph was added.

Change-Id: I7e0267b90d62d6d881f24f063cdb894422ec8618
Partially-Implements: Blueprint: external-ceph
2016-07-19 12:45:48 +00:00
Jenkins
19e9585ffb Merge "Added test document" 2016-06-14 09:06:39 +00:00
MD NADEEM
66b6eccd1b Added test document
This doc explain how to run kolla tests.

Change-Id: I498e18187c2c69bbd37c490ce4e1a8548f933791
Partially-implements: blueprint documentation-rework
2016-06-13 11:26:20 +00:00
Michal (inc0) Jastrzebski
775a4c27fd Remove liberty warning
Since it's no longer relevant as liberty 1.0.0 is not there any more

TrivialFix

Change-Id: Id2b2404d76c82444418c00162b1abab2e1a64eed
2016-06-09 15:45:45 +00:00
Paul Bourke
340326f0e9 Move developer related docs into their own section
Change-Id: Ie34bda2a93f92958ea929f305a0e16d1b8ee5566
2016-05-31 12:30:04 +01:00
Christian Berendt
a7433cdced Add title to index page of developer documentation
At the moment the title of the index page of the developer documentation is
"Kolla’s Mission". Other projects use "Welcome to X’s developer documentation!".

Change-Id: Iadddc7fbe3d1eeafe5ed1926a3e090b5de70e7ee
2016-05-25 17:40:00 +00:00
Ryan Hallisey
47d7ed2bbf Change the SELinux doc to a security doc
Kolla should have a doc with an overview of security within
the project.

Partially implements: blueprint documentation-rework

Change-Id: I0a8b902fe1b9adf6617779646bf0bbaee1a36c4f
2016-05-18 09:02:33 -04:00
Ryan Hallisey
1c29522553 Doc rework for quickstart, multinode, and image-building
Our quickstart guide is way too complex.  We need to simplify
the quickstart guide by pulling out the overwhelming amount of
information and splitting it into other docs.

Change-Id: Iec175ee7f60bfd11ce06b22c861e51e180c188a9
Partially-implements: blueprint documentation-rework
2016-05-14 12:24:44 -04:00
Jenkins
0b563fa5b8 Merge "Add Kibana quick start guide" 2016-05-06 10:20:45 +00:00
Mauricio Lima
6dfc1ef650 Add a CONTRIBUTING.rst for Kolla
Change-Id: I9910b4fba5ef11c26e687af3273e4fccaf5f235f
Closes-Bug: #1570017
2016-05-04 08:10:33 -04:00
akwasniewska
732ef0e715 Add Kibana quick start guide
Includes basic information about how to search, visualize and analyse logs,
create a Dashboard and export/import created items.

Closes-Bug: #1570544

Change-Id: I70ce5d28a6bb719a94570d23e85d5ba4aa0b114e
2016-04-15 15:16:37 +02:00
Thiago Gomes
d5c79a2487 Add Manila deployment document
Deploy Manila in kolla

Co-Authored-By: Mauricio Lima <mauriciolimab@gmail.com>
Change-Id: I1397e0f10dcbcfd182497fbaf0ebe9d5de718cc5
2016-03-16 09:11:42 -04:00
Steven Dake
13a6062260 Add documentation about critical data loss
There is a critical data loss in Liberty 1.0.0.  It is only fair we
warn Operators not to use 1.0.0 and then revert this change once
1.1.0 is released.

Change-Id: I65a18ddbbdbf2fc5f62f62ff7a1650049b61fada
2016-03-08 22:05:22 -07:00
SamYaple
89cb146ac1 Add docs to explain why we disabling selinux
Change-Id: Iadbd4a0d77aee692abd9ab4f81ba67ead8949b1e
2016-02-18 16:04:03 +00:00
Proskurin Kirill
58ee9c4b84 Updated quickstart doc
I merged "quickstart" doc with "ansible-deployment" and
"deploy-all-in-one-node". All three of them was covering same topic and
added a lot of confusion for new users.

I added some clarification lines from myself, with main goal to recive one
straightforward document for new users.

Change-Id: I793244c47ffbe0ba304e79bacf708494e59d99c4
2015-11-03 13:00:46 +03:00
Steven Dake
ef046ee940 Fix broken link
quickstart got busted in a previous commit

Change-Id: I8affb6e0ecc3250eabe276aab401222dc6239349
2015-11-02 15:17:51 -07:00
Steven Dake
83e540cca3 Tidy up index.rst
Include our full mission statement and tidy up the documentation
landing page so it looks more professional and has shorter
titles that communicate the same information.

Change-Id: If54acbfa817e9a9a71e9f16f923094248b2f62f0
2015-11-02 11:25:27 -07:00
Steven Dake
426e637724 Implement Mitaka ODS Documentation structure
From this etherpad:
https://etherpad.openstack.org/p/kolla-mitaka-documentation

Lay groundwork for structure of new documentation layout.

Further work will finish the job on this doc work.

Note in a later change I793244c47ffbe0ba304e79bacf708494e59d99c4
ansible-deployment, deploy-all-in-one-node, and quickstart.rst
will be merged into one document.

Change-Id: I42b576ffab796da6e27adc9dbf55b2ceed641c16
2015-11-02 08:22:58 -07:00
Michal Jastrzebski
2eb16d2f0a Add ceph and ironic to index
Adding link to missing guides to our docs index page.

TrivialFix

Change-Id: I6704a59ef7e010d5ffec762325bd4442362a093c
2015-10-11 10:38:02 +02:00
Steven Dake
bdad07d2de Rename swift-readme.rst to swift-guide.rst
All services should have a guide that follows the same style as
cinder-guide.rst or swift-guide.rst and all should be named
service-guie.rst.

Change-Id: Iaa75d137d4e159452153f9fe572fe017fe988be4
2015-09-25 08:54:44 -07:00
Steven Dake
5e83b6d369 Add a customize deployment document
Explain how to customize the deployment with an example and rationale
that is anti-templating :)

Change-Id: I148c89b0608211864d18b60ed7c7082c0b468931
2015-09-18 14:12:21 -07:00
Kuo-tung Kao
26eee6404e Add deploy all in one node document
Add deploy all in one node document.
Use ubuntu host and ubuntu docker image as example.

Change-Id: I8bc0862827e192b63ff3cbf7be9f7227e4f7b1bd
2015-09-10 13:56:00 +08:00
Steven Dake
501d6da665 Add image-buliding.rst to index.rst
Also tidy up title for the main deployment documentation.

Change-Id: Ibd137f01077565ece7cf87affe4200f414a0dce6
2015-09-03 22:21:41 -07:00
Steven Dake
233864ff32 Rename docs dir to doc for publishing
The publishing docs expect the documentation to be present in the
/doc directory not the /docs directory.  If the documentation is in
the /docs directory, according to fungi the docs won't be published
properly.

Change-Id: I718fec7e69d298a5cb2376ca4e2455e12169566e
Partially-Implements: blueprint kola-tox-doc
2015-09-02 22:37:36 -07:00