[SliceDocs] Docs Updates 36/132036/1
authorqingshuting <qingshuting1@huawei.com>
Tue, 8 Nov 2022 03:20:27 +0000 (11:20 +0800)
committerqingshuting <qingshuting1@huawei.com>
Tue, 8 Nov 2022 03:20:27 +0000 (11:20 +0800)
Issue-ID: DCAEGEN2-3286
Signed-off-by: qingshuting <qingshuting1@huawei.com>
Change-Id: Iaf8d9a31a6c0da72b853d1188d77c785eb20aa65

docs/sections/services/slice-analysis-ms/runtime_configuration.rst

index c1d590c..d8f711f 100644 (file)
@@ -1,6 +1,5 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.\r
 .. http://creativecommons.org/licenses/by/4.0\r
-.. _runtime_configuration:\r
 \r
 Runtime Configuration\r
 =====================\r
@@ -10,12 +9,11 @@ This page will explain how runtime configuration works, and how to utilize it. H
 \r
 Architecture\r
 ------------\r
-The architecture below depicts the Slice MS as a part of DCAE.\r
-.. image:: ./slice_analysis_ms_architecture.jpg\r
+The architecture below depicts how runtime configuration works in the Slice MS as a part of DCAE.\r
 \r
-Slice Analysis MS provides runtime configuration feature since Kohn Version.\r
+.. image:: ../../images/R11_architecture_diagram.png\r
 \r
-Unlike the SON-Handler MS, which passes runtime configuration through Policy - Policy Handler - Cloudify Manager - Consul Cluster - CBS - SONHandler, the Slice Analysis MS provides a lighter and easier way to send runtime configurations in seconds.\r
+Slice Analysis MS provides runtime configuration feature since Kohn Version.\r
 \r
 For the Slice Analysis MS, there is a CBS thread running that will continually fetch the latest policies from the XCAML PDP engine. So if you want to pass runtime configuration, you can format your configuration contents in the form of an XCAML policy, then push it into the XCAML PDP engine. The Slice Analysis MS will get updated within seconds.\r
 \r
@@ -28,7 +26,9 @@ Deployment
 - Enable "dcae-slice-analysis-ms" in oom /oom/kubernetes/dcaegen2-services/values.yaml.\r
 \r
      1. Enable dcae-slice-analysis-ms in values.yaml. When using the helm chart of OOM to pull up the whole onap environment, dcae-slice-analysis-ms will be automatically installed.\r
+\r
             .. code-block:: bash\r
+\r
                dcae-slice-analysis-ms:\r
                  enabled: true\r
                  logConfigMapNamePrefix: '{{ include "common.release" . }}-dcaegen2-services'\r
@@ -36,7 +36,9 @@ Deployment
 - Original params set in oom /oom/kubernetes/dcaegen2-services/components/dcae-slice-analysis-ms/values.yaml have to be modified.\r
 \r
      1. Uncomment the following lines. "duration" is the interval of a thread in policy sync container to retrieve latest policy from XCAML PDP engine. The unit of "duration" is seconds.\r
+\r
              .. code-block:: bash\r
+\r
                 dcaePolicySyncImage: onap/org.onap.dcaegen2.deployments.dcae-services-policy-sync:1.0.1\r
                 policies:\r
                   duration:\r
@@ -48,6 +50,7 @@ Deployment
 \r
 Workflow\r
 ~~~~~~~~\r
+\r
 .. image:: ./runtime_config_work_flow.jpg\r
 \r
 To realize the runtime configuration feature for SliceMS, similarly to SON-Handler, we add a "policy sync" container for Slice MS. There are 3 containers in Slice MS, "dcae-slice-analysis-ms", "dcae-slice-analysis-ms-filebeat" and "policy-sync".\r
@@ -66,11 +69,15 @@ Steps to Use Runtime Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
 1. Create the policy type\r
     command\r
+\r
     .. code-block:: bash\r
+\r
        curl -k -v --user 'username:password' -X POST "https://policyApiIp:6969/policy/api/v1/policytypes" -H "Content-Type:application/json" -H "Accept: application/json" -d @policy_type.json\r
 \r
     request body: policy_type.json\r
+\r
     .. code-block:: bash\r
+\r
        {\r
           "tosca_definitions_version": "tosca_simple_yaml_1_1_0",\r
           "policy_types": {\r
@@ -102,11 +109,15 @@ Steps to Use Runtime Configuration
 \r
 2. Create the policy\r
     command: {versionNumber} here needs to match the "policies"-"version" in the request body "slicems_config_policy.json"\r
+\r
     .. code-block:: bash\r
+\r
        curl --silent -k -w %{http_code}  --user 'username:password' -X POST "https://policyApiIp:6969/policy/api/v1/policytypes/onap.policies.monitoring.docker.slicems.app/versions/{versionNumber}}/policies" -H "Accept: application/json" -H "Content-Type: application/json" -d @slicems_config_policy.json\r
 \r
     request body: slicems_config_policy.json\r
+\r
     .. code-block:: bash\r
+\r
         {\r
           "tosca_definitions_version": "tosca_simple_yaml_1_1_0",\r
           "topology_template": {\r
@@ -133,11 +144,15 @@ Steps to Use Runtime Configuration
 \r
 3. Deploy the policy\r
     command\r
+\r
     .. code-block:: bash\r
+\r
     curl -w %{http_code} --silent -k --user 'username:password' -X POST "https://policyPAPApi:6969/policy/pap/v1/pdps/policies" -H "Accept: application/json" -H "Content-Type: application/json" -d @push.json\r
 \r
     request body: push.json\r
+\r
     .. code-block:: bash\r
+\r
     {\r
       "policies": [\r
         {\r
@@ -148,6 +163,7 @@ Steps to Use Runtime Configuration
     }\r
 \r
 4. Verify in SliceMS that configurations received\r
+\r
 .. image:: ./example_slice_update_policy.png\r
 \r
 How to Develop Your Own Runtime Configuration\r
@@ -157,4 +173,3 @@ How to Develop Your Own Runtime Configuration
 3. Deploy the policy\r
 4. Verify in SliceMS that configurations received. (Needs to write code in SliceMS to deal with your configurations in advance.)\r
 \r
-\r