| ajay | d19711c | 2021-12-07 12:07:04 -0800 | [diff] [blame] | 1 | .. |
| 2 | SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org> |
| 3 | SPDX-License-Identifier: Apache-2.0 |
| 4 | |
| ajay | 0751498 | 2021-12-07 22:24:32 -0800 | [diff] [blame] | 5 | .. _deployment_5G_guide: |
| ajay | d19711c | 2021-12-07 12:07:04 -0800 | [diff] [blame] | 6 | |
| ajay | 0751498 | 2021-12-07 22:24:32 -0800 | [diff] [blame] | 7 | 5G Deployment Guide |
| 8 | =================== |
| ajay | d19711c | 2021-12-07 12:07:04 -0800 | [diff] [blame] | 9 | |
| 10 | Deployment Overview |
| 11 | ------------------- |
| 12 | SD-Core is released with Helm chart and container images. |
| 13 | We recommend using **Kubernetes** and **Helm** to deploy SD-Core. |
| 14 | SD-Core images are hosted on an ONF member-only Docker registry. |
| 15 | You need to obtain access token and supply that as part of the Helm value. |
| 16 | |
| 17 | Hardware resource requirement |
| 18 | ----------------------------- |
| 19 | |
| ajay | 0751498 | 2021-12-07 22:24:32 -0800 | [diff] [blame] | 20 | SD-Core 5G has following K8s pods |
| ajay | d19711c | 2021-12-07 12:07:04 -0800 | [diff] [blame] | 21 | |
| ajay | 0751498 | 2021-12-07 22:24:32 -0800 | [diff] [blame] | 22 | - AMF: 2 CPU Cores, 4Gi RAM |
| 23 | - SMF: 2 CPU Cores, 4Gi RAM |
| 24 | - NRF: 2 CPU Cores, 1Gi RAM |
| 25 | - NSSF : 2 CPU Cores, 1Gi RAM |
| 26 | - AUSF: 1 CPU Core, 1Gi RAM |
| 27 | - PCF: 1 CPU Core, 1Gi RAM |
| 28 | - UDR |
| 29 | - UDM |
| 30 | - MongoDB: 2 CPU Core, 4Gi RAM |
| ajay | d19711c | 2021-12-07 12:07:04 -0800 | [diff] [blame] | 31 | |
| 32 | Prepare access credential for SD-Core images |
| 33 | -------------------------------------------- |
| 34 | |
| 35 | Container images can be download from ONF self-hosted container registry but you have to gain the access token first. |
| 36 | |
| 37 | 1. Login to `Aether Harbor Registry <https://registry.aetherproject.org/harbor/sign-in?redirect_url=%2Fharbor%2Fprojects>`_ using your ONF Crowd credential, |
| 38 | 2. Select ``User Profile`` drop-down menu in the upper-right corner |
| 39 | 3. Generate the CLI secret and it's the secret token you have to access the container registry via CLI tool. |
| 40 | 4. Login to the container registry with your username and access token |
| 41 | by ``docker login command`` to ensure you can access it. |
| 42 | |
| 43 | .. code-block:: |
| 44 | |
| 45 | ╰─$ docker login registry.aetherproject.org --username hwchiu |
| 46 | Password: |
| 47 | Login Succeeded |
| 48 | |
| 49 | Deployment Options |
| 50 | ------------------ |
| 51 | |
| 52 | Development Environments |
| 53 | """""""""""""""""""""""" |
| 54 | |
| 55 | TODO - AIAB document link |
| 56 | |
| ajay | d19711c | 2021-12-07 12:07:04 -0800 | [diff] [blame] | 57 | Production Environments - 5G |
| 58 | """""""""""""""""""""""""""" |
| 59 | |
| 60 | To install SD-Core into your Kubernetes cluster, follow instructions |
| 61 | |
| 62 | Step1 - Clone SD-Core 5G Helm chart |
| 63 | ''''''''''''''''''''''''''''''''''' |
| 64 | .. code-block:: |
| 65 | |
| 66 | git clone ssh://gerrit.opencord.org:29418/sdcore-helm-charts |
| 67 | cd sdcore-helm-charts/sdcore-helm-charts/ |
| 68 | helm dep update #Update Helm dependencies |
| 69 | |
| 70 | Step2 - Prepare your Helm value for 5G |
| 71 | '''''''''''''''''''''''''''''''''''''' |
| 72 | |
| 73 | You can modify existing values.yaml directly, but we recommend composing another value |
| 74 | file myvalues.yaml using values.yaml as an example. We are highlighting a few things we |
| 75 | need to modify here. More explanation of the supported Helm values can be found in the |
| 76 | Configuration section below. |
| 77 | |
| 78 | Step3 - Install 5G using SD-Core umbrella helm chart |
| 79 | '''''''''''''''''''''''''''''''''''''''''''''''''''' |
| 80 | |
| 81 | The following command will deploy the SD-Core helm chart with release name sdcore-4g in the sdcore-4g namespace. |
| 82 | |
| 83 | .. code-block:: |
| 84 | |
| 85 | helm install -n sdcore-5g --create-namespace -f myvaules.yaml sdcore-5g . |
| 86 | |
| 87 | To verify the installation: |
| 88 | |
| 89 | .. code-block:: |
| 90 | |
| 91 | helm -n sdcore-5g ls |
| 92 | |
| 93 | To uninstall: |
| 94 | |
| 95 | .. code-block:: |
| 96 | |
| 97 | helm -n sdcore-5g uninstall sdcore-5g |
| 98 | kubectl delete namespace sdcore-5g # also remove the sdcore-5g if needed |
| 99 | |
| 100 | |