diff options
author | Kuralamudhan Ramakrishnan <kuralamudhan.ramakrishnan@intel.com> | 2020-05-11 06:44:12 +0000 |
---|---|---|
committer | Kuralamudhan Ramakrishnan <kuralamudhan.ramakrishnan@intel.com> | 2020-05-11 06:44:12 +0000 |
commit | 8e0c00c4c59add2fa03a67081d74cd46934d034e (patch) | |
tree | caf91b2e77b9f33b86aefcad31d2626a8748754f /kud | |
parent | 1449bbe36e44315fa6e74375e7ab0607dd182344 (diff) |
Fixing README.md for containerization installation
Issue-ID: MULTICLOUD-1068
Signed-off-by: Kuralamudhan Ramakrishnan <kuralamudhan.ramakrishnan@intel.com>
Change-Id: I8ced72f4d9f13b9cb2305fc3778cdd65e933d778
Diffstat (limited to 'kud')
-rw-r--r-- | kud/hosting_providers/containerized/README.md | 30 | ||||
-rw-r--r-- | kud/hosting_providers/containerized/testing/Vagrantfile | 16 |
2 files changed, 42 insertions, 4 deletions
diff --git a/kud/hosting_providers/containerized/README.md b/kud/hosting_providers/containerized/README.md index 12ce1a19..2f9a9e52 100644 --- a/kud/hosting_providers/containerized/README.md +++ b/kud/hosting_providers/containerized/README.md @@ -25,6 +25,24 @@ Installer script finds the `hosts.init` for each cluster in `/opt/multi-cluster/ Kubernetes jobs(a cluster per job) are used to install multiple clusters and logs of each cluster deployments are stored in the `/opt/kud/multi-cluster/<cluster-name>/logs` and artifacts are stored as follows `/opt/kud/multi-cluster/<cluster-name>/artifacts` +## Creating TestBed for Testing and Development + +This section creates VM for testing and development work in containerization setup. User can skip this steps, if they have baremetal avaiable for testing or development. + +``` +$ git clone https://github.com/onap/multicloud-k8s.git +$ pushd multicloud-k8s/kud/hosting_providers/vagrant +$ sudo ./setup.sh -p libvirt +$ popd +$ pushd multicloud-k8s/kud/hosting_providers/containerized/testing +$ vagrant up +$ popd +``` +Do following steps to keep note of +1. Get the IP address for the Vagrant machine - <VAGRANT_IP_ADDRESS> +2. Copy the host /root/.ssh/id_rsa.pub into the vagrant /root/.ssh/authorized_keys +3. From host make sure to ssh into vagrant without password ssh root@<VAGRANT_IP_ADDRESS> + ## Quickstart Installation Guide Build the kud docker images as follows, add KUD_ENABLE_TESTS & KUD_PLUGIN_ENABLED for the testing only: @@ -40,7 +58,7 @@ $ docker build --rm \ --build-arg NO_PROXY=${NO_PROXY} \ --build-arg KUD_ENABLE_TESTS=true \ --build-arg KUD_PLUGIN_ENABLED=true \ - -t github.com/onap/multicloud-k8s:latest . -f build/Dockerfile + -t github.com/onap/multicloud-k8s:latest . -f kud/build/Dockerfile ``` Let's create a cluster-101 and cluster-102 hosts.ini as follows @@ -48,12 +66,12 @@ Let's create a cluster-101 and cluster-102 hosts.ini as follows $ mkdir -p /opt/kud/multi-cluster/{cluster-101,cluster-102} ``` -Create hosts.ini as follows in the direcotry cluster-101(c01 IP address 10.10.10.3) and cluster-102(c02 IP address 10.10.10.5) +Create hosts.ini as follows in the direcotry cluster-101(c01 IP address 10.10.10.3) and cluster-102(c02 IP address 10.10.10.5). If user used Vagrant setup as mentioned in the above steps, replace the IP address with vagrant IP address ``` -/opt/kud/multi-cluster/cluster-101/hosts.ini +$ cat /opt/kud/multi-cluster/cluster-101/hosts.ini [all] -c01 ansible_ssh_host=10.10.10.5 ansible_ssh_port=22 +c01 ansible_ssh_host=<VAGRANT_IP_ADDRESS> ansible_ssh_port=22 [kube-master] c01 @@ -117,6 +135,10 @@ spec: EOF ``` +See the logs as follows to see the progress of KUD installation +``` +$ kubectl logs -f kud-$CLUSTER_NAME-<AAAA> +``` Multi - cluster information from the host machine; diff --git a/kud/hosting_providers/containerized/testing/Vagrantfile b/kud/hosting_providers/containerized/testing/Vagrantfile new file mode 100644 index 00000000..547d3084 --- /dev/null +++ b/kud/hosting_providers/containerized/testing/Vagrantfile @@ -0,0 +1,16 @@ +# -*- mode: ruby -*- +# vi: set ft=ruby : + +Vagrant.configure("2") do |config| + config.vm.box = "generic/ubuntu1804" + config.vm.hostname = "ubuntu18" + config.vm.synced_folder ".", "/vagrant" + config.vm.provider :libvirt do |libvirt| + libvirt.graphics_ip = '0.0.0.0' + # add random suffix to allow running multiple jobs + libvirt.random_hostname = 'yes' + libvirt.cpus = 16 + libvirt.memory = 32768 + libvirt.machine_virtual_size = 400 + end +end |