Merge "Adding Beijing Documentation"

1 files changed, 64 insertions, 0 deletions

diff --git a/docs/oom_cloud_setup_guide.rst b/docs/oom_cloud_setup_guide.rst
new file mode 100644
index 0000000000..9cccc91431
--- /dev/null
+++ b/docs/oom_cloud_setup_guide.rst
@@ -0,0 +1,64 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2018 Amdocs, Bell Canada
+
+.. figure:: oomLogoV2-medium.png
+   :align: right
+
+.. _cloud-setup-guide-label:
+
+OOM Cloud Setup Guide
+#####################
+
+OOM deploys and manages ONAP on a pre-established Kubernetes_ cluster - the
+creation of this cluster is outside of the scope of the OOM project as there
+are many options including public clouds with pre-established environments.
+However, this guide includes instructions for how to create and use some of the
+more popular environments which could be used to host ONAP. If creation of a
+Kubernetes cluster is required, the life-cycle of this cluster is independent
+of the life-cycle of the ONAP components themselves. Much like an OpenStack
+environment, the Kubernetes environment may be used for an extended period of
+time, possibly spanning multiple ONAP releases.
+
+.. note::
+  Inclusion of a cloud technology or provider in this guide does not imply any
+  endorsement of this technology.
+
+.. _Kubernetes: https://kubernetes.io/
+
+The versions of Kubernetes that are supported by OOM are as follows:
+
+.. table:: OOM Software Requirements
+
+  ==============  ==========  =====  =======  ========
+  Release         Kubernetes  Helm   kubectl  Docker
+  ==============  ==========  =====  =======  ========
+  amsterdam       1.7.x       2.3.x  1.7.x    1.12.x
+  beijing/master  1.8.5       2.7.x  1.8.5    1.12.x
+  ==============  ==========  =====  =======  ========
+
+Minimum Hardware Requirements
+=============================
+
+
+Cloud Installation
+==================
+
+#. OOM supports deployment on major public clouds. The following guides
+   provide instructions on how to deploy ONAP on these clouds:
+
+   - Microsoft Azure,
+   - Amazon AWS,
+   - Google GCD,
+   - VMware VIO,
+   - IBM, and
+   - Openstack
+
+#. Alternatively, OOM can be deployed on a private set of physical hosts or VMs
+   (or even a combination of the two). The following guides describe how to
+   create a Kubernetes cluster with popular tools:
+
+   - Setting up Kubernetes with Rancher (recommended)
+   - Setting up Kubernetes with Kubeadm
+   - Setting up Kubernetes with Cloudify
+