...
The Kubernetes Deployment, aka KUD, has been designed to be consumed by Virtual Machines as well as Bare-Metal servers. The kud/hosting_providers/vagrantbaremetal/aio.sh script contains the bash instructions for provisioning an All-in-One Kubernetes deployment on a Bare-Metal server.
This document lists the Hardware & Software requirements and provides a walkthrough to set up all-in-one deployment (a.i.o) using aio.sh.
Hardware Requirements
Concept | Amount |
CPUs | 8 |
Memory | 32GB |
Hard Disk | 150GB |
Software Requirements
- Ubuntu Server 1618.04 LTS
Instructions to run KUD on Baremetal environment
Prepare the environment and clone the repo
$ sudo apt-get update -y $ git clone https://git.onap.org/multicloud/k8s/ |
$ git fetch "https://gerrit.onap.org/r/multicloud/k8s" refs/changes/34/84734/6 && git checkout FETCH_HEAD
$ cd#Run script to setup KUD $k8s/kud/hosting_providers/ |
$ ./installer.sh | tee kud_installer.log
...
baremetal/aio.sh |
Aio.sh explained
This bash script provides an automated process for deploying an All-in-One Kubernetes cluster. Given that the ansible inventory file created by this script doesn't specify any information about user and password, it's necessary to execute this script as the root user.
...
Create the host.ini file for Kubespray and Ansible
cat <<EOL > inventory/hosts.ini |
KUD consumes kubespray for provisioning a Kubernetes base deployment. As part of the deployment process, this tool downloads and configures kubectl binary.
Ansible uses SSH protocol for executing remote instructions. The following instructions create and register ssh keys which avoid the usage of passwords.
Generate ssh-keys
$ echo -e "\n\n\n" | ssh-keygen -t rsa -N "" |
Enabling Nested-Virtualization
...
Enable nested virtualization
$sudo ./node.sh |
Deploying KUD Services
Finally, the KUD provisioning process can be started through the use of the installer.sh bash script. The output of this script is collected in the kud_installer.log file for future reference.
Bring the cluster up by running the following
$ ./installer.sh | tee kud_installer.log |
Running test cases
The kud/tests folder contain the health check scripts that guarantee the proper installation/configuration of Kubernetes add-ons. Some of the examples for test scripts are virtlet.sh, multus.sh, ovn4nfv.sh etc.
...