X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Foom_cloud_setup_guide.rst;h=f43531a03a1f41dba9a26d4cf7a762e5ab1d3ef3;hb=refs%2Fheads%2Fmaster;hp=9a34036727da8f3c0c7747c3ead6a0258ec743b5;hpb=f5620211cd946fdddf6cfab4c4551394668c7491;p=oom.git diff --git a/docs/oom_cloud_setup_guide.rst b/docs/oom_cloud_setup_guide.rst deleted file mode 100644 index 9a34036727..0000000000 --- a/docs/oom_cloud_setup_guide.rst +++ /dev/null @@ -1,108 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 -.. International License. -.. http://creativecommons.org/licenses/by/4.0 -.. Copyright 2019-2020 Amdocs, Bell Canada, Orange, Samsung -.. _oom_cloud_setup_guide: - -.. Links -.. _Microsoft Azure: https://wiki.onap.org/display/DW/Cloud+Native+Deployment#CloudNativeDeployment-MicrosoftAzure -.. _Amazon AWS: https://wiki.onap.org/display/DW/Cloud+Native+Deployment#CloudNativeDeployment-AmazonAWS -.. _Google GCE: https://wiki.onap.org/display/DW/Cloud+Native+Deployment#CloudNativeDeployment-GoogleGCE -.. _VMware VIO: https://wiki.onap.org/display/DW/ONAP+on+VMware+Integrated+OpenStack+-+Container+Orchestration -.. _OpenStack: https://wiki.onap.org/display/DW/ONAP+on+Kubernetes+on+OpenStack?src=contextnavpagetreemode -.. _Setting Up Kubernetes with Rancher: https://wiki.onap.org/display/DW/Cloud+Native+Deployment -.. _Setting Up Kubernetes with Kubeadm: https://wiki.onap.org/display/DW/Deploying+Kubernetes+Cluster+with+kubeadm -.. _Cloud Native Deployment Wiki: https://wiki.onap.org/display/DW/Cloud+Native+Deployment -.. _ONAP Development - 110 pod limit Wiki: https://wiki.onap.org/display/DW/ONAP+Development#ONAPDevelopment-Changemax-podsfromdefault110podlimit - -.. 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 an - endorsement. - -.. _Kubernetes: https://kubernetes.io/ - -Software Requirements -===================== - -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 1.8.10 2.8.2 1.8.10 17.03.x - casablanca 1.11.5 2.9.1 1.11.5 17.03.x - dublin 1.13.5 2.12.3 1.13.5 18.09.5 - el alto 1.15.2 2.14.2 1.15.2 18.09.x - frankfurt 1.15.9 2.16.6 1.15.11 18.09.x - ============== =========== ====== ======== ======== - -Minimum Hardware Configuration -============================== - -The hardware requirements are provided below. Note that this is for a -full ONAP deployment (all components). Customizing ONAP to deploy only -components that are needed will drastically reduce the requirements. - -.. table:: OOM Hardware Requirements - - ===== ===== ====== ==================== - RAM HD vCores Ports - ===== ===== ====== ==================== - 224GB 160GB 112 0.0.0.0/0 (all open) - ===== ===== ====== ==================== - -.. note:: - Kubernetes supports a maximum of 110 pods per node - configurable in the --max-pods=n setting off the - "additional kubelet flags" box in the kubernetes template window described in 'ONAP Development - 110 pod limit Wiki' - - this limit does not need to be modified . The use of many small - nodes is preferred over a few larger nodes (for example 14x16GB - 8 vCores each). - Subsets of ONAP may still be deployed on a single node. - -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 GCE`_, -.. - `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`_ - -OOM can be deployed on a private set of physical hosts or VMs (or even a -combination of the two). The following guide describe the recommended method to -setup a Kubernetes cluster: :ref:`onap-on-kubernetes-with-rancher`. - -There are alternative deployment methods described on the -`Cloud Native Deployment Wiki`_