* Recommend using a virtual environment
* Fix reference to multinode inventory
* Add explicit use of sudo where necessary
* Change ownership of /etc/kolla to current user

These changes should make it possible to copy/paste from the quickstart
to get a working deployment.

Change-Id: Ib3990f9e16eaa1e19a4ad5bfea5bdb2e4bc1c333

To avoid links to OpenStack docs getting out of date in our docs, use
the latest version.

Ideally after cutting each stable branch we should change these links to
use the current release.

Co-Authored-By: Isaiah Inuwa
Change-Id: Ia1e3c720f4e688861b8f76874a3943b0f4e50b17

Change-Id: Ia1b29ca85e8ddb4d9bc740888d92bb2378a44fbf
Closes-Bug: #1803874

Following by https://review.openstack.org/#/c/605097/
These were used by now-dead tooling. We can remove them.

Change-Id: I0953751044f038a3fdd1acd49b3d2b053ac4bec8

Now, kolla-ansible support non-root to deploy[0], the note is
outdated and inaccuracy, remove it is necessary

[0]: https://github.com/openstack/kolla-ansible/blob/master/ansible/group_vars/all.yml#L18

Change-Id: I4fc005949afd64389bc2be68161426c6a2590ca4

Change-Id: I6875cde5c3cc7775c39011816c513e73df3396db

ansible command need assign hosts to run.

Change-Id: Ifadc48ba06ef1726aa73b21ff37366360cfffbbe

Change-Id: Ib9b9440ce56ab2632d2a17c04be7c786b0b3688f

Change-Id: I0e3c098db9d1f0a8fda383910c05ed5efc929994

setuptools should be used as a base dependency package that deployment kolla-ansible.

Change-Id: I4737fcd157342b37a8304cadfb20e24fe585a8b4
Closes-Bug: #1776426

Currently, to run kolla-ansible inventory files, wrong
path was followed. So this patch correct use of invetory file path.

Change-Id: Id1526c3d9df54e7f456f5af1089a393f296d3be9

the path of globals.yml should be `/etc/kolla/globals`, not be
`/etc/kolla/kolla/globals`

Change-Id: I49d91c4dab13b197402844ac74f87b5dd2adbfca

"clausule" is dutch,should be "Clause"

Change-Id: I0c92b26db0876ce3622b67317b7f0bd85564e881

For compliance with the Project Testing Interface [1]
as described in [2]

[1]
https://governance.openstack.org/tc/reference/project-testing-interface.html
[2]
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

doc8 command is dropped from docs tox envs.
So this affect nothing and run in PEP8.

Related-Bug: #1765348

Depends-On: Icc7fe3a8f9716281de88825e9d5b2fd84de3d00a
Change-Id: Idf9a16111479ccc64004eac9508da575822a3df5

Doc says use pike for latest stable branch.
Currently we are in queens

Change-Id: I3983682475b4abf141784c25e117b24cfd38cf29

the path should be "/etc/kolla/globals.yml" rather than
"/etc/kolla/kolla/globals.yml"

Change-Id: I119095bb63fc2af7eb34f16de43ce82f864dd8a4

when run ansible command, the inventory should be added, or
ansible will use /etc/ansible/hosts by default, but it does't
we wanted.

Change-Id: I7f2a05c27ddfa95d0747abb9ba931ee1c5714dc0

- Add the requirements installation step for development
- Add step number for some section, to make step more clear
- Some format issues fix

Change-Id: I78deee5f4ae424eec06876168cbdfdf8d25d6bcc

Change-Id: I5585561f9bfa42ea54c992e38dda4b9a89568553

Change-Id: Ib47345d54c9cf1077a24b50a358d5e41c0bf696a

We upgrade the rst convention by following Documentation Contributor
Guide[1].

[1] https://docs.openstack.org/doc-contrib-guide

Change-Id: Ieceb3942073512fb10670a48d258c4055909496e
Partially-Implements: blueprint optimize-the-documentation-format

This is mainly kolla-ansible installation part

Change-Id: Iab14884cfc037bc3cb8055db487c53aa14da070f

doc/source/user/quickstart.rst:194: D001 Line too long
doc/source/user/quickstart.rst:337: D001 Line too long
doc/source/user/quickstart.rst:339: D001 Line too long

Change-Id: Ibbb3588bddf3bfe9d49c2b2b6909f80c36ec2aff

Nearly full rewrite of our QSG to make it more 2017.

Co-Authored-By: chenxing <chason.chan@foxmail.com>
Partially-Implements: blueprint ka-queens-doc-restructure
Change-Id: Ie558e1121438a502611c7c0e6c0e5ac0f6574827

Currently init-runonce script changes directory to the
script's base directory (/usr/...) before doing anything else.
This unnecessarily _forces_ a non-root user to use sudo for
running this script thereby raising privileges for code which
doesn't want it. Also downloading temporary stuff in places like
/usr... seems not a good choice.

Hence deleting the said code part and letting the deployer work
comfortably from any directory.

Made documentation changes accordingly.

Change-Id: Ib3c7ed97aa5f53c115b6337aaf572b5fdc7a71f3
Closes-Bug: #1732963

This warning message mentions PBR, but this is the first
instance of this acronym in the documentation. Use the full
name can be made clear what PBR stands for in its first usage.

Change-Id: I46c7db79eb330e7f58d71afd6c749dd27e2c0f80
Closes-Bug: 1729476

Mitaka and newton are deprecated and no longer maintained
by OpenStack comunity.

Users can check specific documentation for old releases.

Change-Id: I43fd1d40bc2f094fee4c1547879f798a92593df4

The text "Docker Hub Image Registry" is supposed to be assciated with
the link defined at the end of quickstart.rst. This patch ensures that.

Change-Id: I840413520473b1cc3eb7685254d8d133d4c8d497

Change-Id: I2a6ee471b1029bcc2fe1ce76917faf925f1ad239
Closes-Bug: #1723886

for reference: https://docs.openstack.org/python-openstackclient/latest/index.html#getting-started

Change-Id: Iacb29585ad89c08de24ea49dfefe7d0d0f5a1815

In the quickstart guide, the min version of docker is 1.10.0,
and the max version is none. But the `docker daemon` doesn't work
since v1.13.0. Please refer to:
https://docs.docker.com/engine/deprecated/#docker-daemon-subcommand
"docker daemon subcommand
Deprecated In Release: v1.13.0
Target For Removal In Release: v17.12
The daemon is moved to a separate binary (dockerd), and should
be used instead."
I think it's better to let the readers know it.

Change-Id: I92882a3860704acdc31ff0c89e21ab2793e0b268

Change-Id: I138000951d75894cc5eb01a8b364ed8293940c40
Closes-Bug: #1720095

since the pike is release, the multinode.html should update

Change-Id: I5122477b9209cd483ae682032c1949fa5a5cc985

Change-Id: I3ee35c6faf2b824d889c4ccadde4d6f8ba9c8cca

Deploy guides includes quickstart guide.
Includes respect relative paths, but when
quickstart includes vagrant doc, deploy-guide
tries to locate the doc in its doctree (deploy-guide/source).

This causes error 404 and deploy-guide post-gates to fail

Change-Id: I05e49bbcef564ad4f3d80f0649ccf191d9f8b59d

Checking http://files.openstack.org/docs-404s/2017-09-08.txt the link
/kolla-ansible/latest/quickstart.html gives a 404 and is most wanted.

The link now is /kolla-ansible/latest/user/quickstart.html - let's
update in tree docs for this.

Fix other broken links as well - with using intra-links instead of
external links - this will make it easier to notice breakage when files
are moved.

Change-Id: I62655afd9f270fa83c07d86aa91346af6337ca32

For more detail, see the doc migration spec.
http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html



Co-Authored-By: Eduardo Gonzalez <dabarren@gmail.com>
Change-Id: I3a7c0ed204ee1e9060b5325f20622afe9a5e3040

The current example for including mtu is not suitable for all docker
version and distros. Fox example, the latest docker-ce 17.06 does not
support docker "docker daemon" command. And also docker doesn't
support socket parameter "fd://" on rpm based systems. We need to add
a note to remind user not copy that configuration straightly.

Change-Id: I8f2e0697eefe89abbe7da29612a625c4094c954e

The docker-py python module is now called docker and has an
incompatible api. Running latest kolla-ansible with docker-py
will throw an error like this:
AttributeError: 'module' object has no attribute 'APIClient'

Change-Id: Idd10735c764717cf711f62b3243d39d8c8ed263f

Quickstart guide can be confusing when pulling images if not using
all-in-one deployment.
Ansible will try to pull images in localhost rather than target nodes.
Issue: https://ask.openstack.org/en/question/109026/kolla-ansible-pull-error/

Change-Id: Ib7e767ee814041d1939c49731092695485dd2870