aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorSamuli Silvius <s.silvius@partner.samsung.com>2019-05-30 19:16:27 +0300
committerSamuli Silvius <s.silvius@partner.samsung.com>2019-06-06 07:36:22 +0000
commit0bfd22fabb43a4b13a56eb89e00a2d1ce37581db (patch)
treed5c13f1e472ba72f64706e3595b74626d309665b /docs
parentf83fd0ccbd0949c882cbb19e7c2ee663bde70eb2 (diff)
Documentation update for aio.sh CI change
Update documentation accordingly. Issue-ID: MULTICLOUD-629 Change-Id: I36b65dd270a25d63884d161163cfa8e7a813d241 Signed-off-by: Samuli Silvius <s.silvius@partner.samsung.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/bare_metal_provisioning.rst45
-rw-r--r--docs/index.rst6
-rw-r--r--docs/kud_architecture.rst (renamed from docs/krd_architecture.rst)20
3 files changed, 26 insertions, 45 deletions
diff --git a/docs/bare_metal_provisioning.rst b/docs/bare_metal_provisioning.rst
index 2cb74afe..934cea82 100644
--- a/docs/bare_metal_provisioning.rst
+++ b/docs/bare_metal_provisioning.rst
@@ -13,11 +13,11 @@
Bare-Metal Provisioning
***********************
-The Kubernetes Reference Deployment, aka KRD, has been designed to be consumed
-by Virtual Machines as well as Bare-Metal servers. The *vagrant/aio.sh*
+The Kubernetes Deployment, aka KUD, has been designed to be consumed
+by Virtual Machines as well as Bare-Metal servers. The *baremetal/aio.sh*
script contains the bash instructions for provisioning an All-in-One Kubernetes
deployment in a Bare-Metal server. This document lists the Hardware & Software
-requirements and walkthrough the instructions that *vagrant/aio.sh* contains.
+requirements and walkthrough the instructions that *baremetal/aio.sh* contains.
Hardware Requirements
#####################
@@ -37,8 +37,8 @@ Software Requirements
- Ubuntu Server 16.04 LTS
-vagrant/aio.sh
-##############
+baremetal/aio.sh
+################
This bash script provides an automated process for deploying an All-in-One
Kubernetes cluster. Given that the ansible inventory file created by this
@@ -50,23 +50,17 @@ The following two instructions start the provisioning process.
.. code-block:: bash
$ sudo su
- # wget -O - https://git.onap.org/multicloud/k8s/plain/vagrant/aio.sh | bash
+ # git clone https://git.onap.org/multicloud/k8s/
+ # cd k8s/kud/hosting_providers/baremetal/
+ # ./aio.sh
In overall, this script can be summarized in three general phases:
-1. Cloning and configuring the KRD project.
+1. Generating Inventory.
2. Enabiling Nested-Virtualization.
-3. Deploying KRD services.
+3. Deploying KUD services.
-**Cloning and configuring the KRD project**
-
-KRD requires multiple files(bash scripts and ansible playbooks) to operate.
-Therefore, it's necessary to clone the *ONAP multicloud/k8s* project to get
-access to the *vagrant* folder.
-
-.. code-block:: bash
-
- git clone https://git.onap.org/multicloud/k8s/
+**Inventory**
Ansible works agains multiple systems, the way for selecting them is through the
usage of the inventory. The inventory file is a static source for determining the
@@ -102,17 +96,10 @@ an inventory file for addressing those tasks to localhost.
kube-master
EOL
-KRD consumes kubespray_ for provisioning a Kubernetes base deployment. As part
-of the deployment process, this tool downloads and configures *kubectl* binary.
-This action conflicts with *andrewrothstein.kubectl* ansible role. Therefore is
-necessary to remove those instructions from all the ansible playbooks.
+KUD consumes kubespray_ for provisioning a Kubernetes base deployment.
.. _kubespray: https://github.com/kubernetes-incubator/kubespray
-.. code-block:: bash
-
- # sed -i '/andrewrothstein.kubectl/d' playbooks/configure-*.yml
-
Ansible uses SSH protocol for executing remote instructions. The following
instructions create and register ssh keys which avoid the usage of passwords.
@@ -124,7 +111,7 @@ instructions create and register ssh keys which avoid the usage of passwords.
**Enabling Nested-Virtualization**
-KRD installs Virtlet_ Kubernetes CRI for running Virtual Machine workloads.
+KUD installs Virtlet_ Kubernetes CRI for running Virtual Machine workloads.
Nested-virtualization gives the ability of running a Virtual Machine within
another. The *node.sh* bash script contains the instructions for enabling
Nested-Virtualization.
@@ -135,14 +122,14 @@ Nested-Virtualization.
# ./node.sh
-**Deploying KRD services**
+**Deploying KUD services**
Finally, the KRD provisioning process can be started through the use of
*installer.sh* bash script. The output of this script is collected in the
-*krd_installer.log* file for future reference.
+*kud_installer.log* file for future reference.
.. code-block:: bash
- # ./installer.sh | tee krd_installer.log
+ # ./installer.sh | tee kud_installer.log
.. image:: ./img/installer_workflow.png
diff --git a/docs/index.rst b/docs/index.rst
index 173076b4..7a49b6d1 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,7 +8,7 @@ over cloud regions that support Kubernetes as the orchestrator.
Kubernetes Reference Deployment
===============================
-The Kubernetes Reference Deployment(KRD) provides an
+The Kubernetes Reference Deployment(KUD) provides an
automated mechanism to install and configure the Kubernetes
services required for the MultiCloud Kubernetes plugin.
@@ -18,6 +18,6 @@ Table of contents
.. toctree::
:maxdepth: 3
- KRD Project Architecture <krd_architecture>
- Bare Metal All-in-One KRD deployment<bare_metal_provisioning>
+ KUD Project Architecture <kud_architecture>
+ Bare Metal All-in-One KUD deployment<bare_metal_provisioning>
Kubernetes MultiCloud API sample ommands <sampleCommands>
diff --git a/docs/krd_architecture.rst b/docs/kud_architecture.rst
index f188135e..f56b72a5 100644
--- a/docs/krd_architecture.rst
+++ b/docs/kud_architecture.rst
@@ -10,7 +10,7 @@
limitations under the License.
****************
-KRD Architecture
+KUD Architecture
****************
This document explains the different components of the Kubernetes
@@ -78,13 +78,7 @@ installer.sh
############
Main bash script that installs dependencies and executes ansible
-playbooks for provisioning KRD components on external nodes. This
-script uses some arguments for the additional installation of
-components. For more information about its usage:
-
-.. code-block:: bash
-
- ./installer.sh -h
+playbooks for provisioning KUD components on external nodes.
inventory/
##########
@@ -116,17 +110,17 @@ This folder contains a set of Ansible playbooks which perform the
tasks required for configuring services like Multus, Virtlet and/or
OVN.
-playbooks/configure-krd.yml
+playbooks/configure-kud.yml
***************************
This ansible playbook collects the common actions among all the
-Kubernetes AddOns offered by the KRD.
+Kubernetes AddOns offered by the KUD.
-playbooks/krd-vars.yml
+playbooks/kud-vars.yml
************************
This file centralizes the version numbers and source URLs used for
-different components offered by the KRD. Bumping a version requires
+different components offered by the KUD. Bumping a version requires
extensive testing to ensure compatibility.
setup.sh
@@ -158,5 +152,5 @@ tests/
This folder contains the health check scripts that guarantee the
proper installation/configuration of Kubernetes AddOns. Its
execution is disabled by default. In order to enable it, it's
-necessary to pass the *-t* argument to the **installer.sh** bash
+necessary to export KUD_ENABLE_TESTS=true environment variable before calling the **installer.sh** bash
script, usually through changing the arguments in the *Vagrantfile*.