341 Commits

Author SHA1 Message Date
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
Steven Dake
f6e1786563 Update liberty deployment warning
Tell folks about the state of liberty 1.0.0 and to use
1.1.0 for production deployments.

Change-Id: Iea824e8fc6489d8222e089199161ca3fb30a8310
2016-05-11 09:01:11 -07:00
Michal (inc0) Jastrzebski
cafd89cc93 Add docs about config overrides
We don't have docs about major feature kolla offers.

TrivialFix

Co-Authored-By: Swapnil Kulkarni <me@coolsvap.net>
Change-Id: I7c992d2004348d520c019b295b0c5a4378c857ba
2016-05-09 12:52:06 +05:30
Jenkins
0b563fa5b8 Merge "Add Kibana quick start guide" 2016-05-06 10:20:45 +00:00
Mauricio Lima
9024564066 Deleting only images from kolla build
Co-Authored-By: Carlos Cesario <carloscesario@gmail.com>
Change-Id: I3e9652e1cac156f822b388d2b9fd910180b4a892
Closes-Bug: #1551933
2016-05-05 12:15:04 -04:00
Jenkins
0691b0f14e Merge "Add a CONTRIBUTING.rst for Kolla" 2016-05-05 09:49:59 +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
Jenkins
665e6af23e Merge "Update Vagrant docs to ensure libvirt is installed" 2016-05-03 16:23:55 +00:00
Blake Smith
420f8740ea Yum install Ansible 1.9 specified
EPEL has added an Ansible 2.0 rpm.
Version 1.9 needs to be specifically called out.

Change-Id: I4bf296d72cc6eab50213a3a96923bf7e6b5f3399
2016-04-28 18:13:14 -05:00
Ryan Hallisey
9fce1ac981 Document custom-repos
Change-Id: I8777a354acba4395d8ccc48e32cc4178db58461b
2016-04-27 10:48:37 -04:00
Paul Bourke
d0a8579c0e Update Vagrant docs to ensure libvirt is installed
Change-Id: I4c34a30eba0bd56ea3aeb20f18430e266deea773
2016-04-26 14:55:43 +01:00
Swapnil Kulkarni (coolsvap)
fc8d716316 Update remaining files for formatting
Change-Id: Ie9fc941bb48edf86b00fc1f2dba0b83b675a5a1c
Partial-Bug:#1569417
2016-04-21 12:03:42 +00:00
Steven Dake
0786e6b165 Change Jinja2 rquirements to match globals
Global requirements are 2.8.0 for Jinja2, and master will not run
without it.

Change-Id: I91f93736b1e067653840dff219fb8be9359da078
2016-04-15 19:55:47 -07: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
Dave McCowan
c2ccf572d6 Remove Disable HAProxy option from Quick Start Guide
The disable HAProxy option is not commonly used and not
recommended.  This patch moves the section that describes it
out of the Quick Start Guide and into the Advanced Configuration
Guide.

Change-Id: Iccd8a6369d772bd85f304cba0a99300180a369c8
Closes-Bug: #1569560
2016-04-12 16:27:56 -04:00
Jenkins
e2b250f7c3 Merge "Add note about heat being busted for development" 2016-04-12 09:32:04 +00:00
Jenkins
8b0a0f7244 Merge "Add LVM2/iSCSI documentation" 2016-04-12 04:51:41 +00:00
Steven Dake
9119e2e360 Add note about heat being busted for development
Heat development environments don't work at all.

As such document this so folks avoid them unless they want to
work on making them better.

Change-Id: Ibe3296660d30ccc24213c272ef379e6d3e2c21f2
2016-04-11 00:22:33 -07:00
Serguei Bezverkhi
07a5bd9db5 Add LVM2/iSCSI documentation
This patch adds to cinder-guide.rst LVM2/iSCSI related
information.

TrivialFix

Change-Id: I2c7b3090bbf314dd1281ca3d02148490936d5b86
2016-04-08 20:11:43 -04:00
MD NADEEM
976a385075 Update vagrant-dev-env.rst
Fix some minor changes
ruby-dev package required for installing
vagrant-libvirt plugin.

TrivialFix

Change-Id: Id6d3552275ee28ab49804fe6cd1b00d2e8e3c1f4
2016-04-08 10:46:21 +05:30
Rajath Agasthya
0e6fcdb591 Added Kibana instructions to quickstart.rst
Kibana requires creating an index for the first time when you log
in since we don't have a default dashboard yet. Documenting that
step in quickstart.rst.

Change-Id: I82ecd228c61e2affa5c8f9f9c93f8845728f707f
2016-04-06 22:12:32 -07:00
Ryan Hallisey
bf6cae2c24 Add remove apparmor reminder to the quickstart
Change-Id: I1333bf4352aa559f3f9ee5c78ff85533e27c7716
2016-04-05 02:06:54 -04:00
Davanum Srinivas
f0be9c736c Update Quickstart with example for distro and install type
Make it a bit more clear on how to switch distro if needed

TrivialFix

Change-Id: I888c8310d11c8bc65f579df2cdc9d32f3928dc23
2016-03-31 14:42:18 +00:00
Gerard Braad
674ff439fd Change CentOS in documentation
Change-Id: Ic4725a4cef02a57e837c727378a99bf7575d4ebd
2016-03-24 06:59:24 +00:00
Gerard Braad — 吉拉德
4d58ef5d43 Include docker python install
Change-Id: I5a55f6798d73b289b02232dd26f5e5fb72da9e4c
2016-03-24 04:07:10 +00:00
Jenkins
a3a43e7b92 Merge "Add PBR generation of version information" 2016-03-23 12:33:03 +00:00
Jenkins
ada9ac95a0 Merge "Added note about nested environment" 2016-03-23 07:13:15 +00:00
Steven Dake
31634c4df4 Add PBR generation of version information
Change-Id: I6391392645d8608a92c885071b26210eed3f5466
Partially-Implements: blueprint add-reno
2016-03-22 20:45:46 -07:00
Carlos Cesario
8e2423a388 Added note about nested environment
Added information when using nested environment for Kolla deployment.

Added check command to verify hardware acceleration

Change-Id: I6cb43ebbf11b5cf34f866fdccb550e9641a47f6c
2016-03-22 10:20:01 -03:00
SamYaple
f03e06e09b Add generate_passwords.py to generate passwords
As with all tools, this is a first pass at the generation. Perhaps we
even want to move this into kolla/kolla/cmd and be generated with tox
itself in the future.

This tool, when run, will only populate empty fields that have no
values meaning that it is safe to run repeatedly on the same file.

Of note, there is no way to preserve comments in the file after it has
been processed by the yaml parser in python. Comments and sections
will remain in the passwords.yml template for additional documentation
if the user wishes to populate the file themselves.

Use SystemRandom and clean up the docs a bit to not use pronouns.

Co-Authored-By: Steven Dake <stdake@cisco.com>

Closes-Bug: #1559266
Change-Id: I2932d592df8871f1b7811059206d0b4d0553a687
2016-03-21 17:02:23 +00:00
Jenkins
37e67ef3ed Merge "Update quickstart doc to use drop-in unit files" 2016-03-21 00:24:37 +00:00
Maru Newby
b9205399c5 Update quickstart doc to use drop-in unit files
While it's possible to edit distro/package unit files installed to
/lib/systemd/system, a cleaner solution exists.  systemd will pick up
'drop-in' unit files located in '/etc/systemd/system/[unit name].d/'.
A drop-in unit file only has to include fields that override those in
the main unit file, and the drop-in unit and main unit file can change
independently.

This change updates the quickstart doc to use drop-in unit files to
configure docker.service instead of editing the main unit file.

See: https://coreos.com/os/docs/latest/using-systemd-drop-in-units.html

Change-Id: Iddbebf658741937e3c4157fc0a021751f10fabd2
2016-03-19 05:10:35 +00:00
Steven Dake
50c52081de Explain how to use kolla-ansible pull
During multi-node, it is possible for master target node images to
be older then the Ansible master playboks if the repository is
updated.  Add documentation to explain this situation.

Change-Id: I2ccf57004147873e89f23fbb996d01f550e90c3f
2016-03-18 11:57:27 -07: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
Jenkins
8407c8a95a Merge "Stop shipping broken openrc in vagrant" 2016-03-13 23:06:33 +00:00
Steven Dake
812b27867e RST syntax error in quickstart.rst
Change-Id: I3c5b6f73b19968c9ae26b12e64864c72a5e2b7f2
2016-03-12 22:14:51 +00:00
Swapnil Kulkarni (coolsvap)
333ee4e742 Restructuring the Quickstart guide
We need the gcc and other dependencies
installed before we can do any tox related
commands.

Installation of git was never checked in QSG.
I happened to create a baremetal CentOS server
with minimal install and there was no git.
Added steps to install git.

Moved the steps related to git clone and other
kolla configuration after basic installation.
since tox fails for gcc.

In the quickstart guide we are generating
the configuration using tox but tox is not
installed before doing so. Adding steps to
install tox before generating conf.

Change-Id: Ic8a756e66d33963e47607ed60c4c768e0859152d
2016-03-11 22:20:58 +05:30
Martin André
29b4e8756d Stop shipping broken openrc in vagrant
Instead, rely on kolla-ansible post-deploy to generate a configuration
file with valid environment variables.

Change-Id: Ie62932afc96e2486410a1d4e14162a88b1733c22
Closes-Bug: #1555972
2016-03-11 17:14:03 +09:00
Jenkins
2469425a8a Merge "Document required libvirt python bindings" 2016-03-10 11:50:25 +00:00
Jenkins
4cb6d83fea Merge "Document the new 'local' type for source build" 2016-03-10 11:49:37 +00:00
Martin André
ce408a26f7 Document required libvirt python bindings
We added a requirement on libvirt python bindings with the script to
retrieve the latest DHCP lease for vagrant developers' environment.

Add it to the vagrant documentation.

Change-Id: I3e7e97922f5b855155fda96b914a4947af007c47
2016-03-10 16:58:24 +09:00
Martin André
3105580d39 Provide instruction to generate kolla-build.conf
Although not strictly mandatory, it's less confusing to have
a kolla-build.conf file in /etc/kolla that users can modify it they
want to customize their builds, rather than to rely on defaults
settings and command line options.

The `tox -e genconfig` was already documented in "Image building" doc.

Change-Id: Ia44e6f28ce18601cdaba5109ea12cd50fa8372b2
Closes-Bug: #1532066
2016-03-10 15:25:56 +09:00
Martin André
18f1971144 Document the new 'local' type for source build
Change-Id: Ia385364e3fd8fc3441ebd07adcd981154f34ebb8
2016-03-10 15:19:16 +09:00
Jenkins
395bb2e3aa Merge "Fix a few small typos and formatting." 2016-03-09 21:14:49 +00:00
Katie McEwen
8af51c7af6 Fix a few small typos and formatting.
Fix a few small typos and formatting.

Change-Id: I5bf1f1aba518aa4df605b9e9133953f9fa256c4c
2016-03-09 12:33:08 -08: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
Jenkins
1015993808 Merge "Document how to use loopback devices for Swift" 2016-03-08 18:33:32 +00:00
Jenkins
0af1df1eb7 Merge "Add documentation for two-VIP and TLS blueprints" 2016-03-08 16:48:14 +00:00
Paul Bourke
9588fd1d99 Document how to use loopback devices for Swift
People commonly want to use loopback devices to evaulate or develop on
Swift.  The steps for this are slightly different than those for
physical block devices.

Also make some small fix ups to the title formatting.

Change-Id: I0c1cb4a261f264dc56bd065ab137e5ee79e773f8
2016-03-08 16:37:36 +00:00
Dave McCowan
6d9cf739ca Add documentation for two-VIP and TLS blueprints
Relates-to: blueprint kolla-ssl

Change-Id: Id82d22c2195be5d897c781f28087a1ea422b8bea
2016-03-08 09:27:26 -05:00