From 21d50ab93ea47451309fd3bad1e4f66c0adce829 Mon Sep 17 00:00:00 2001 From: Eddie Arrage Date: Thu, 26 Apr 2018 04:26:06 +0000 Subject: Updated user guide with edits and reference links - Provided some overall edits to user guide - Fixed titles of index files for release notes and user guide - Added links to SDC, A-B configuration guides and logging, tracing and monitoring install/validation docs Change-Id: I9a0e1e0a2c12b20400eec5a5642f7c5de2dbd7bf Signed-off-by: Eddie Arrage --- docs/release/release-notes/index.rst | 6 ++-- docs/release/userguide/index.rst | 2 +- docs/release/userguide/userguide.rst | 56 +++++++++++++++++------------------- 3 files changed, 30 insertions(+), 34 deletions(-) (limited to 'docs') diff --git a/docs/release/release-notes/index.rst b/docs/release/release-notes/index.rst index c7f8f6c..5f59892 100644 --- a/docs/release/release-notes/index.rst +++ b/docs/release/release-notes/index.rst @@ -1,12 +1,12 @@ -.. _clover-releasenotes: - .. This work is licensed under a Creative Commons Attribution 4.0 International .. License. .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Authors of Clover +.. _clover-releasenotes: + ================================= -OPNFV Clover Design Specification +OPNFV Clover Release Notes ================================= .. toctree:: diff --git a/docs/release/userguide/index.rst b/docs/release/userguide/index.rst index 672c62c..5be100f 100644 --- a/docs/release/userguide/index.rst +++ b/docs/release/userguide/index.rst @@ -4,7 +4,7 @@ .. (c) OPNFV, Authors of Clover ================================= -OPNFV Clover Design Specification +OPNFV Clover User Guide ================================= .. toctree:: diff --git a/docs/release/userguide/userguide.rst b/docs/release/userguide/userguide.rst index c01886e..d99359b 100644 --- a/docs/release/userguide/userguide.rst +++ b/docs/release/userguide/userguide.rst @@ -8,57 +8,53 @@ Clover User Guide (Fraser Release) ================================================================ -This document provides the Clover user guide for OPNFV Fraser release. - -.. contents:: - :depth: 3 - :local: - +This document provides the Clover user guide for the OPNFV Fraser release. Description =========== -As project Clover's first release, Fraser release includes installation -and simple validation of foundational upstream projects including Istio, -fluentd, Jaeger, and Prometheus. Clover Fraser release also provides a -sample VNF which follows micro-service design pattern, its Kubernetes -manifest, and an automatic scipt to demonstrate a sample A-B testing use -case using the sample VNF running on Istio with trace data exposed to -Jaeger running in istio-system namespace. +As project Clover's first release, the Fraser release includes installation and simple +validation of foundational upstream projects including Istio, fluentd, Jaeger, and +Prometheus. The Clover Fraser release also provides a sample set of web-oriented network +services, which follow a micro-service design pattern, its Kubernetes manifest, and an +automated script to demonstrate a sample A-B testing use-case. The A-B sample script +validates performance criteria using Istio request routing functionality leveraging +the sample services deployed within Istio and the tracing data available within Jaeger. What is in Fraser? ================== - * a sample micro-service composed VNF + * Sample micro-service composed VNF named Service Delivery Controller (SDC) - * logging module: fluentd and elasticsearch Kubernetes manifests, + * Logging module: fluentd and elasticsearch Kubernetes manifests, and fluentd installation validation - * tracing module: jaeger Kubernetes manifest, installation validation, - jaegar tracing query tools, module for trace data output to datastore + * Tracing module: Jaeger Kubernetes manifest, installation validation, + Jaegar tracing query tools, and module for trace data output to datastore - * monitoring module: prometheus Kubernetes manifest, installation - validation, sample Prometheous query of Istio related metrics + * Monitoring module: Prometheus Kubernetes manifest, installation + validation, and sample Prometheous query of Istio related metrics * Istio route-rules sample yaml and validation tools * Test scripts - * Sample code for an A-B testing demo shown during ONS + * Sample code for an A-B testing demo shown during ONS North America 2018 Usage ===== - * Python modules to validate installation of fluentd, Jaeger, and - Prometheus + * Python modules to validate installation of fluentd logging, Jaeger tracing, and + Prometheus monitoring. Deployment and validation instructions can be found at: + :ref:`logging`, :ref:`tracing`, and :ref:`monitoring` respectively. - * Installation and deployment of a sample VNF - - VNF designed and implemented with micro-service design pattern - - tested and validated via Istio service mesh tools + * Deployment and usage of SDC sample + - Services designed and implemented with micro-service design pattern + - Tested and validated via Istio service mesh tools + Detailed usage instructions for the sample can be found at :ref:`sdc_config_guide` - * sample tool to validate Istio route rules: - tools/python clover_validate_route_rules.py -s -t + * An example use-case for A-B testing. Detailed usage instructions for this sample A-B + validation can be found at: :ref:`a_b_config_guide` - * an example use case: A-B testing: - test/fraser_a_b_test.py -t yaml/fraser_a_b_test.yaml -p - *** detail procedure to run sample A-B testing at docs/configguide/... + * Sample tool to validate Istio route rules: + tools/python clover_validate_route_rules.py -s -t -- cgit 1.2.3-korg