Bare Metal Deployment Guide for kolla-kubernetes in kolla-kubernetes: Some of the steps are outdated or doesn't make sense

[vishal yadav]

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: ______
- [ ] This is a doc addition request.
- [ ] I have a fix to the document that I can paste below including example: input and output.

1) Instance #1:
Centos and Ubuntu
Setup the DNS server with the service CIDR:
# sudo sed -i 's/10.96.0.10/10.3.3.10/g' /etc/systemd/system/kubelet.service.d/10-kubeadm.conf

Correction: With kubernetes v1.11+ above step does not make sense as 10-kubeadm.conf file no more contains 10.96.0.10 rather it exists in /var/lib/kubelet/config.yaml as clusterDNS parameter. There can be special note for kubernetes v1.11+ versions.

2) Instance #2:
Deploy the Canal CNI driver:
curl -L https://raw.githubusercontent.com/projectcalico/canal/master/k8s-install/1.6/rbac.yaml -o rbac.yaml
kubectl apply -f rbac.yaml

curl -L https://raw.githubusercontent.com/projectcalico/canal/master/k8s-install/1.6/canal.yaml -o canal.yaml
sed -i "s@10.244.0.0/16@10.1.0.0/16@" canal.yaml
kubectl apply -f canal.yaml

Correction:
- Above installs older versions of canal images which is not supported with kubernetes >= 1.8 and leads to https://github.com/projectcalico/canal/issues/108.
- https://github.com/projectcalico/canal/tree/master/k8s-install repository is deprecated, rather steps need to be updated with respect to https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/#tabs-pod-install-2 or https://docs.projectcalico.org/v3.2/getting-started/kubernetes/installation/flannel