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

Last Openstack version supported on Ubuntu 14.04 is Mitaka. Hence Ubuntu
14.04 related documentation can be remove since Kolla Newton release.

Change-Id: Ibedd9dea659fc787660e44909573a59339b870c3

Currently the project-deploy-guide links to the entire dev
doc repo for Kolla-Ansible. This is incorrect. It should link
only to installation information that can be found in the quick
start guide. This patch remedies that change, and ensures that
there is a link to the kolla deploy guide published at
docs.o.o.

Change-Id: I43738e341e996cb5a589a09c4c59c0dc8b058458

Change-Id: Id4fb97107c8a01f1b5e95a6fcdee3bed1f385b76

With libvirt 2.0, when using qemu cpu mode is not properly
evaluated and need to be set to cpu_mode = none.

Add this option when kvm is not supported, otherwise user
will still facing errors when launching instances over qemu.

Change-Id: Ic970e3de74817ce4e17bb4e15d130e1e82d595cc

Two lines that where too long and on trailing
whitespace.

Closes-Bug: #1669305
Change-Id: I4dda1a27feab4d66af6d35690ede025e8d7607c8

When import rc file into openstack, use "." rather than "source".

Change-Id: I8d115db48bb152acc0b5e54b218684d0d4b4384e

Change-Id: I72e14bd2bb306498f5e010e8f9309e23243db00e

Get follwing error when running tox -edocs

doc/bifrost.rst:91: D001 Line too long
doc/manila-hnas-guide.rst:28: D000 Title underline too short.
doc/manila-hnas-guide.rst:28: D000 Title underline too short.
doc/networking-guide.rst:93: D000 Title underline too short.
doc/networking-guide.rst:93: D000 Title underline too short.
doc/multinode.rst:14: D001 Line too long
doc/quickstart.rst:474: D001 Line too long
doc/vagrant-dev-env.rst:129: D001 Line too long

Change-Id: I88090487a4710547224361d29aaf8371f8340c28

Change-Id: I3832d41260849adc4bb24de287c1dbb624cbe7eb

Docker version 1.13.0 is broken with the kolla-ansible deliverlable.

Mark it as such in the documentation.

Change-Id: I91da906cfa2a4552739749b27b41006fbc06215d

Update documents reference image-building documents correctly after
image-building.rst was deleted from kolla-ansible directory.

Change-Id: Ib66475e1f0f3055f2e38fc33ae649cae300c9c36

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