Add virtual environemnt deployment scripts

This adds two sets of deployments scripts to aid in setting up virtual
environments for testing StarligX, for libvirt/qemu and VirtualBox.

This is the first exposure of an internal project and is not fully
error-proofed, it should be examined carefully to understand what
the scripts will do to your system before running them.

The first set of fixes for this to make it less instrusive and work
in a shared server follow in https://review.openstack.org/#/c/597643.

There are also a couple of bashate errors fixed since that is now a voting job...

[NOTE(dtroyer): I converted the original commit message into a README
because that's information that needs to be with the scripts.]

Needed-by: https://review.openstack.org/#/c/597643
Change-Id: I0a6a148720b7a239380fd48f7ffdab272472e664
Co-authored-by: Lianhao Lu <lianhao.lu@intel.com>
Co-authored-by: Brian Avery <brian.avery@intel.com>
Co-authored-by: Nakul Dahiwade <nakul.dahiwade@intel.com>
Co-authored-by: Yan Chen <yan.chen@intel.com>
Co-authored-by: Ruijing Guo<ruijing.guo@intel.com>
Co-authored-by: Shuicheng Lin <shuicheng.lin@intel.com>
Co-authored-by: Felipe de Jesus Ruiz Garcia <felipe.de.jesus.ruiz.garcia@intel.com>
Co-authored-by: Jose Perez Carranza <jose.perez.carranza@intel.com>
Co-authored-by: Eddie Ramirez <eddie.ramirez@intel.com>
Co-authored-by: Kailun Qin <kailun.qin@intel.com>
Co-authored-by: Forrest Zhao <forrest.zhao@intel.com>
Co-authored-by: Kailun Qin <kailun.qin@intel.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Signed-off-by: Dean Troyer <dtroyer@gmail.com>

deployment/README.rst

@@ -0,0 +1,141 @@
+StarlingX Deployment in Virtualized Environments
+================================================
+
+A StarlingX system can be installed in a variety of platforms with the following
+deployment options:
+
+- Standard Controller
+
+  - Dedicated Storage
+  - Controller Storage
+
+- All-in-one
+
+  - Duplex
+  - Simplex
+
+Deployment options uses a variety of configurations based on 3 node identities:
+
+- Controller
+- Storage
+- Compute
+
+Standard Controller :: Dedicated Storage
+----------------------------------------
+
+The software installation workflow for an initial Ceph-backed block
+storage on dedicated storage nodes is:
+
+- Controller-0 Installation and Provisioning
+- Controller-1 / Compute Host / Storage Host Installation
+- Controller-1 Provisioning
+- Provider Network Configuration
+- Compute Host Provisioning
+- Storage Host Provisioning
+
+Standard Controller :: Controller Storage
+-----------------------------------------
+
+The software installation workflow for an initial LVM-backed block
+storage on controller nodes is:
+
+- Controller-0 Installation
+- Controller-0 and System Provisioning
+- Controller-1 / Compute Host Installation
+- Controller-1 Provisioning
+- Compute Host Provisioning
+
+All-in-one :: Duplex
+--------------------
+
+The software installation workflow for two combined controller / compute
+nodes is:
+
+- Controller-0 Installation and Provisioning
+- Controller-1 Installation and Provisioning
+
+All-in-one :: Simplex
+---------------------
+
+The software installation workflow for a single combined controller / compute
+node is:
+
+- Controller-0 Installation and Provisioning
+
+Virtualization Environments
+---------------------------
+
+The available virtualization products where StarlingX has been deployed
+are:
+
+- VirtualBox
+- Libvirt/QEMU
+
+Directory Structure
+-------------------
+
+Deployment directory hosts a total of 3 directories and 18 files::
+
+    $ tree -L 3 deployment/
+    deployment/
+    ├── libvirt
+    │   ├── compute.xml
+    │   ├── controller_allinone.xml
+    │   ├── controller.xml
+    │   ├── destroy_allinone.sh
+    │   ├── destroy_standard_controller.sh
+    │   ├── install_packages.sh
+    │   ├── setup_allinone.sh
+    │   └── setup_standard_controller.sh
+    ├── provision
+    │   ├── simplex_stage_1.sh
+    │   └── simplex_stage_2.sh
+    └── virtualbox
+        ├── all_in_one.conf
+        ├── serial_vm.sh
+        ├── setup_vm.sh
+        ├── standard_controller.conf
+        ├── start_vm.sh
+        └── stop_vm.sh
+
+Directory: libvirt
+~~~~~~~~~~~~~~~~~~
+
+Deployment under Libvirt/QEMU uses a set of xml files to define the node
+identity:
+
+- Controller All-in-one
+- Controller
+- Compute
+
+These nodes are used to create the virtual machines and the network interfaces
+to setup the StarlingX system:
+
+- Setup All-in-one
+
+  - 2 Controllers
+
+- Setup Standard Controller
+
+  - 2 Controllers
+  - 2 Computes
+
+Directory: virtualbox
+~~~~~~~~~~~~~~~~~~~~~
+
+Deployment under VirtualBox uses a set of configuration files to define the
+StarlingX system:
+
+- All-in-one Configuration
+- Standard Controller Configuration
+
+These configurations files are used to create the virtual machines and the
+network interfaces from a single script:
+
+- Setup VM
+
+Directory: provision
+~~~~~~~~~~~~~~~~~~~~
+
+A set of scripts are provided to automate the provisioning of data interfaces and
+local storage resources for the compute function for StarlingX Duplex or Simplex.