Hung-Wei Chiu | 77c969e | 2020-10-23 18:13:07 +0000 | [diff] [blame] | 1 | .. |
| 2 | SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org> |
| 3 | SPDX-License-Identifier: Apache-2.0 |
| 4 | |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 5 | Runtime Deployment |
| 6 | ================== |
Zack Williams | 794532a | 2021-03-18 17:38:36 -0700 | [diff] [blame] | 7 | |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 8 | This section describes how to configure and install Aether edge runtime including K8S |
| 9 | and system level resources. |
| 10 | We will be using GitOps based Aether CI/CD system for this and what you need to do is |
| 11 | create a patch to Aether GitOps repository, **aether-pod-configs**, with the edge |
| 12 | specific information. |
| 13 | |
| 14 | .. attention:: |
| 15 | |
| 16 | If you skipped VPN bootstap step and didn't add the deployment jobs for the new edge, |
| 17 | go to :ref:`Add deployment jobs <add_deployment_jobs>` step and finish it first |
| 18 | before proceeding. |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 19 | |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 20 | Download aether-pod-configs repository |
Zack Williams | 794532a | 2021-03-18 17:38:36 -0700 | [diff] [blame] | 21 | -------------------------------------- |
| 22 | |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 23 | Download ``aether-pod-configs`` repository if you don't have it already in |
Zack Williams | 794532a | 2021-03-18 17:38:36 -0700 | [diff] [blame] | 24 | your development machine. |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 25 | |
| 26 | .. code-block:: shell |
| 27 | |
| 28 | $ cd $WORKDIR |
| 29 | $ git clone "ssh://[username]@gerrit.opencord.org:29418/aether-pod-configs" |
| 30 | |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 31 | .. _create_cluster_configs: |
| 32 | |
| 33 | Create cluster configurations |
| 34 | ----------------------------- |
Zack Williams | 794532a | 2021-03-18 17:38:36 -0700 | [diff] [blame] | 35 | |
Hyunsun Moon | 5c1e0b0 | 2020-11-20 11:09:00 -0800 | [diff] [blame] | 36 | .. attention:: |
| 37 | |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 38 | If you skipped VPN bootstap step and didn't update global resource maps for the new edge, |
| 39 | go to :ref:`Update global resource maps <update_global_resource>` step and |
| 40 | finish ``cluster_map.tfvars`` and ``user_map.tfvars`` update first before proceeding. |
Zack Williams | 794532a | 2021-03-18 17:38:36 -0700 | [diff] [blame] | 41 | |
Hyunsun Moon | a703edf | 2021-07-29 15:55:15 -0700 | [diff] [blame] | 42 | Run the following commands to auto-generate Terraform configurations needed to |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 43 | create a new cluster in `Rancher <https://rancher.aetherproject.org>`_ and add servers and |
| 44 | switches to the cluster. |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 45 | |
| 46 | .. code-block:: shell |
| 47 | |
Hyunsun Moon | a703edf | 2021-07-29 15:55:15 -0700 | [diff] [blame] | 48 | # Create ace_cofig.yaml file if you haven't yet |
Hyunsun Moon | a79c742 | 2020-11-18 04:52:56 -0800 | [diff] [blame] | 49 | $ cd $WORKDIR/aether-pod-configs/tools |
Hyunsun Moon | a703edf | 2021-07-29 15:55:15 -0700 | [diff] [blame] | 50 | $ cp ace_config.yaml.example ace_config.yaml |
| 51 | $ vi ace_config.yaml |
| 52 | # Set all values |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 53 | |
Hyunsun Moon | a79c742 | 2020-11-18 04:52:56 -0800 | [diff] [blame] | 54 | $ make runtime |
Hyunsun Moon | a703edf | 2021-07-29 15:55:15 -0700 | [diff] [blame] | 55 | Created ../production/ace-test/provider.tf |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 56 | Created ../production/ace-test/cluster.tf |
Hyunsun Moon | a703edf | 2021-07-29 15:55:15 -0700 | [diff] [blame] | 57 | Created ../production/ace-test/rke-bare-metal.tf |
| 58 | Created ../production/ace-test/addon-manifests.yml.tpl |
| 59 | Created ../production/ace-test/project.tf |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 60 | Created ../production/ace-test/member.tf |
| 61 | Created ../production/ace-test/backend.tf |
| 62 | Created ../production/ace-test/cluster_val.tfvars |
Hyunsun Moon | a703edf | 2021-07-29 15:55:15 -0700 | [diff] [blame] | 63 | |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 64 | |
Hyunsun Moon | 049b505 | 2021-07-30 12:41:03 -0700 | [diff] [blame^] | 65 | Commit your change |
| 66 | ------------------ |
| 67 | |
| 68 | Lastly, create a review request with the changes. |
| 69 | Once your review request is accepted and merged, the post-merge job will start to deploy K8S at the edge. |
| 70 | Wait until the cluster is **Active** status in `Rancher <https://rancher.aetherproject.org>`_. |
Zack Williams | 794532a | 2021-03-18 17:38:36 -0700 | [diff] [blame] | 71 | |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 72 | .. code-block:: shell |
| 73 | |
Hyunsun Moon | a79c742 | 2020-11-18 04:52:56 -0800 | [diff] [blame] | 74 | $ cd $WORKDIR/aether-pod-configs |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 75 | $ git status |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 76 | $ git add . |
Hyunsun Moon | a79c742 | 2020-11-18 04:52:56 -0800 | [diff] [blame] | 77 | $ git commit -m "Add test ACE runtime configs" |
Hyunsun Moon | 5ca6bfb | 2020-10-29 22:29:12 -0700 | [diff] [blame] | 78 | $ git review |