Comment 0 for bug 1766159

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [x] This doc is inaccurate in this way:

reason being that pip-python is only accessible after epel-release repo is available.

2. instructions to generate configs for kolla-ansible are inaccurate, and need to be refactored:
`ansible-playbook -e ansible_python_interpreter=/usr/bin/python -e @/etc/kolla/globals.yml -e @/etc/kolla/passwords.yml -e CONFIG_DIR=/etc/kolla /kolla-ansible/ansible/site.yml`

since the instructions don't work when run from the `kolla-bringup` dir.

3. Instructions to register kolla config maps turn up the following error

- [ ] This is a doc addition request.
- [x] I have a fix to the document that I can paste below including example: input and output.
Input:

Install repositories necessary to install packaging:

sudo yum install -y epel-release ansible python-pip python-devel

1. Instructions to install python-pip produces errors. Fix is as such:

Output:

Install repositories necessary to install packaging:

sudo yum install -y epel-release
sudo yum install -y ansible python-pip python-devel

---

reason being that pip-python is only accessible after epel-release repo is available.

2. Instructions to generate default config for kolla-ansible produces errors. Fix:

Input:

Generate the default configuration:

ansible-playbook -e ansible_python_interpreter=/usr/bin/python -e @/etc/kolla/globals.yml -e @/etc/kolla/passwords.yml -e CONFIG_DIR=/etc/kolla ansible/site.yml

Output:

Generate the default configuration:

ansible-playbook -e ansible_python_interpreter=/usr/bin/python -e @/etc/kolla/globals.yml -e @/etc/kolla/passwords.yml -e CONFIG_DIR=/etc/kolla kolla-ansible/ansible/site.yml

3. No instructions to disable swap even though it fails on baremetal centos environments during kubectl init. Fix:

Input:

Enable and start docker and kubelet:

sudo systemctl enable kubelet
sudo systemctl start kubelet
Deploy Kubernetes with kubeadm:

sudo kubeadm init --pod-network-cidr=10.1.0.0/16 --service-cidr=10.3.3.0/24

Output:

Enable and start docker and kubelet:

sudo systemctl enable kubelet
sudo systemctl start kubelet

Disable swap if currently enabled:
swapoff -a

Deploy Kubernetes with kubeadm:

sudo kubeadm init --pod-network-cidr=10.1.0.0/16 --service-cidr=10.3.3.0/24

If you have a troubleshooting or support issue, use the following resources:

 - Ask OpenStack: http://ask.openstack.org
 - The mailing list: http://lists.openstack.org
 - IRC: 'openstack' channel on Freenode

-----------------------------------
Release: on 2018-04-20 05:52
SHA: 9870692e7995ab2eb2e6422fda581b2d69e2f1aa
Source: https://git.openstack.org/cgit/openstack/kolla-kubernetes/tree/doc/source/deployment-guide.rst
URL: https://docs.openstack.org/kolla-kubernetes/latest/deployment-guide.html