| Matteo Scandolo | ef5d6f4 | 2020-07-27 16:46:38 -0700 | [diff] [blame] | 1 | VOLTHA Deployment Environment |
| 2 | ============================= |
| 3 | |
| 4 | All the components in the VOLTHA project are containerized and the default |
| 5 | deployment environment is ``kubernetes``. |
| 6 | |
| 7 | Generally VOLTHA is installed in one of two setups: |
| 8 | |
| 9 | - A physical ``kubernetes`` cluster, generally used for production deployments. |
| 10 | - A virtual ``kind`` cluster, generally used for development. |
| 11 | |
| 12 | Regardless of the chosen environment the deployment process is the same, |
| 13 | more on this later, and the installation can be managed in the same way. |
| 14 | |
| Andrea Campanella | 882cfcc | 2021-02-04 10:53:57 +0100 | [diff] [blame] | 15 | VOLTHA deployment |
| 16 | ----------------- |
| Matteo Scandolo | ef5d6f4 | 2020-07-27 16:46:38 -0700 | [diff] [blame] | 17 | |
| 18 | VOLTHA components on top of ``kubernetes`` are managed via ``helm`` charts. |
| 19 | For more information about ``helm`` please refer to the `Official Documentation |
| 20 | <https://helm.sh>`_. |
| 21 | For the sake of this guide all you need to know is that an |
| 22 | ``helm`` chart describes all the information required to deploy a component on top of |
| 23 | ``kubernetes``, such as: containers, exposed ports and configuration parameters. |
| 24 | |
| 25 | A VOLTHA deployment is composed, at its very minimum, by: |
| 26 | |
| 27 | * Infrastructure |
| 28 | |
| 29 | * A ``kafka`` cluster (can also be a single node) |
| 30 | * An ``etcd`` cluster (can also be a single node) |
| 31 | * ``ONOS`` (single or multi instance) |
| 32 | * [Optional] ``radius`` (for EAPOL based authentication) |
| 33 | * ``VOLTHA`` |
| 34 | |
| 35 | * ``voltha-core`` and ``ofAgent`` (contained in the same ``helm`` chart) |
| 36 | * Adapters |
| 37 | |
| 38 | * [one or more] adapter pair(s) (OLT adapter + ONU Adapter) |
| 39 | |
| 40 | .. figure:: ../_static/voltha_cluster_overview.png |
| 41 | :alt: VOLTHA Component Diagram |
| 42 | :width: 100% |
| 43 | |
| 44 | VOLTHA Kubernetes deployment |
| 45 | |
| 46 | Note that the ``Infrastructure`` components can be deployed outside of the |
| 47 | ``kubernetes`` cluster. |
| 48 | |
| 49 | You can read more about VOLTHA deployments in: |
| 50 | |
| 51 | - :doc:`lab_setup` |
| Andrea Campanella | 882cfcc | 2021-02-04 10:53:57 +0100 | [diff] [blame] | 52 | - `Deployment with HELM <./../voltha-helm-charts/README.md>`_ |
| Matteo Scandolo | ef5d6f4 | 2020-07-27 16:46:38 -0700 | [diff] [blame] | 53 | |
| 54 | .. toctree:: |
| 55 | :maxdepth: 1 |
| 56 | :hidden: |
| 57 | :glob: |
| 58 | |
| 59 | ./lab_setup.rst |
| Andrea Campanella | 882cfcc | 2021-02-04 10:53:57 +0100 | [diff] [blame] | 60 | Deploy VOLTHA <./../voltha-helm-charts/README.md> |