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

Change-Id: I8c340cfe33789badb4f8df93f0c13f56fdea5dbf

The pypi package 'docker-py' [1] has been renamed to 'docker' [2].
It is better to move to the new 'docker' package because the old
package will be deprecated and all the new features will go into
the new package only.

Package 'docker' has been added to requirements [3]. The old
package 'docker-py' is still allowed to be in the global requirements
during the transition period but it should be removed after all or
most of the projects finsih the migration.

[1] https://pypi.python.org/pypi/docker-py
[2] https://pypi.python.org/pypi/docker
[3] https://review.openstack.org/#/c/423715/

Change-Id: Ibcd5a57a1fbf55dcc5a690e41f20917f95b63da0

kolla-ansible needs SELinux python bindings, if
SELinux is activated. CentOS has this as a
standard and it is generally a good idea. So
SELinux python bindings should be installed
together with other dependencies in quickstart
guide.

Change-Id: I6eea626aa281db695d181f96b107b51732bbc647

Different Y stream version in Ansible is not compatible. Since ansible
2.2.0 is released for a while. It is time for kolla-ansible to bump the
min Ansible version. Then we can remove the annoying WARNING message
in deploying logs and use the new features.

Change-Id: I99f3c5678f6d2d1f93d61c660fbd166184ff6422

A missing empty line is causing the warning to no
be rst formated.

Change-Id: Ib1de45b514834bd863c1adf38b5412cb065dddaa

Existing statement was little vague, so improved it.

Change-Id: I57371a7b63650d41160370c7c5a59e19d03f9e71

Update docker_py_version_min version to 1.8.1.

see:
https://github.com/openstack/kolla-ansible/blob/master/requirements.txt

Change-Id: I0780de04826d50e1bfe749f66ab8fb6dae2a359f

Change-Id: I466f27c3e789f526c229955a81fc4a25f66c5358

mkdir to create /etc/kolla/config/nova fails if config
folder is not created.

This change adds `-p` to create both config and nova folders

Change-Id: Ibceaa437834cbba681b30c418da3c15d75d49945

In quick start added the correct link which can be used
to setup the development environment with vagrant

Change-Id: Id3eabe3da05264058fed3136acc4cd270b5134ae
Closes-Bug: #1681978

Add info about hostname resolution requirement for RabbitMQ on
quickstart page, corresponding to the docimpact resulted from
a previous merged commit https://review.openstack.org/#/c/294713/.

Closes-Bug: #1559809

Change-Id: I671e7d897412859f606ea88e78ac63605bd8824b