Info |
---|
Steps described in this page are run by "ubuntu", a non-root user. |
ONAP deployment in Kubernetes is modeled in the oom project as a one-to-one set of service to pod sets (one pod per docker container).
...
# | Purpose | Command and Example | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | Add host name to /etc/hosts filenote-1 | sudo vi /etc/hosts
| ||||||||||
2 | Clone the OOM project from ONAP gerrit | git clone http://gerrit.onap.org/r/oom | ||||||||||
3 | Install Docker 1.12note-2 | curl https://releases.rancher.com/install-docker/1.12.sh | sh
| ||||||||||
4 | Install/Start Rancher server 3 | Only on master node (if you are installing more than one Kubernetes nodes), Use port 8880 instead of 8080. docker run -d --restart=unless-stopped -p 8880:8080 rancher/server:v1.6.10
|
Notes:
- Adding all cluster nodes to /etc/hosts file on each node is optional
- Check out compartible versions among Rancher, Kubernetes and Docker
- There may be issues with the DNS pod in Rancher after a reboot or when running clustered hosts as described in ONAP bug OOM-236 (Rancher DNS pod non-functional after system reboot - only in cluster mode). A clean system is OK.
Configure Rancher Client
You can access the Rancher UI through http:<master host IP>:8880 ; it takes you to the apps/stacks page.
For example,
You can access Rancher from http://10.147.132.10:8880/; the page will be opened to http://10.147.132.10:8880/env/1a5/apps/stacks.
From here, follow the steps below to configure the Rancher:
sudo usermod -aG docker ubuntu logout log back in and validate docker command is usable
| ||||||||||||
4 | Install/Start Rancher servernote-3 | Only on one node (if you are installing more than one Kubernetes nodes, choose one node to run the Rancher). Use port 8880 instead of 8080. docker run -d --restart=unless-stopped -p 8880:8080 rancher/server:v1.6.10
|
Notes:
- Adding all cluster nodes to /etc/hosts file on each node is optional
- Check out compartible versions among Rancher, Kubernetes and Docker
- There may be issues with the DNS pod in Rancher after a reboot or when running clustered hosts as described in ONAP bug OOM-236 (Rancher DNS pod non-functional after system reboot - only in cluster mode). A clean system is OK.
Configure Rancher Client
You can access the Rancher UI through http:<master host IP>:8880 ; it takes you to the apps/stacks page.
For example,
You can access Rancher from http://10.147.132.10:8880/; the page will be opened to http://10.147.132.10:8880/env/1a5/apps/stacks.
From here, follow the steps below to configure the Rancher:
# | Purpose | Script shots illustrated steps | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | Create Rancher environment: |
| ||||||||||||||||||||
2 | Add host to INFRASTRUCTURE |
| ||||||||||||||||||||
# | Purpose | Script shots illustrated steps | ||||||||||||||||||||
1 | Create Rancher environment: |
| ||||||||||||||||||||
2 | Add host to INFRASTRUCTURE |
| ||||||||||||||||||||
3 | Confirm that the host process has completed | The end of adding the host operation is indicated by the CLI option shown under the KUBERNETES dropdown menu:
|
...
# | Purpose | Command and Example | |||||
---|---|---|---|---|---|---|---|
1 | Download kubectl on the server | curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl
| |||||
2 | Enable the kubectl command | chmod +x ./ kubectl sudo mv ./ kubectl /usr/local/bin/kubectl | |||||
3 | Generate Config from the Rancher UI |
| |||||
4 | Create the kube config on the server | mkdir ~/.kube vi ~/.kube/config Paste the generated config from rancher UI (from last step) to this file, then save the file. | |||||
5 | Validate the kube config | kubectl cluster-info |
Install Helm
Helm is used by OOM for package and configuration management. Hence, we are installing Helm (use 2.3.0 not current 2.6.0) on the server where we have mounted the OOM project.
...
# | Purpose | Command and Example | |||||
---|---|---|---|---|---|---|---|
1 | Download the Helm tar file | wget http://storage.googleapis.com/kubernetes-helm/helm-v2.3.0-linux-amd64.tar.gz
| |||||
2 | Untar the Helm tar file | tar -zxvf helm-v2.3.0-linux-amd64.tar.gz
| |||||
3 | Enable the Helm command | sudo mv linux-amd64/helm /usr/local/bin/helm | |||||
Tip of viewing helm command menu |
|
...