docs: added capi documentation

Signed-off-by: Ali Mukadam <ali.mukadam@oracle.com>

Author: hyder

docs/src/SUMMARY.md

@@ -13,10 +13,21 @@
   - [With Public Endpoints](./multi/pub-ep.md)
   - [With Private Endpoints](./multi/pri-ep.md)
 - [Advanced Customizations](./advanced/advanced.md)
+  - [Cluster API](./advanced/capi.md)
+    - [OKE](./advanced/oke.md)
+    - [OCNE](./advanced/ocne.md)
   - [Control plane](./advanced/controlplane.md)
   - [Data plane](./advanced/dataplane.md)
   - [DNS](./advanced/dns.md)
+  - [Istio]()
   - [Observability]()
-    - [Prometheus]()
-    - [Thanos](./advanced/thanos.md)
-- [Terraform Options](./terraformoptions.md)
+    - [Monitoring]()
+      - [Prometheus]()
+      - [Enabling Thanos](./advanced/thanos.md)
+    - [Logging]()
+      - [Customizing OpenSearch]()
+      - [Using fluentd]()
+      - [Using fluent-bit]()
+    - [Tracing with Jaeger]()
+    - [Using Kiali]()
+ - [Terraform Options](./terraformoptions.md)

docs/src/advanced/capi.md

@@ -0,0 +1,23 @@
+[uri-capi]: https://cluster-api.sigs.k8s.io/
+# Cluster API
+
+[Cluster API (CAPI)][uri-capi] is a Kubernetes sub-project that provides a set of declarative APIs and tooling to simplify managing the lifecycle of Kubernetes clusters on multiple infrastructure providers. CAPI is particularly useful when you have to provision clusters on multiple infrastructure providers.
+
+CAPI has 2 type of clusters:
+
+1. A management cluster: is a Kubernetes cluster that manages the lifecycle of Workload Clusters. A Management Cluster is also where one or more providers run, and where resources such as Machines are stored.
+
+2. A workload cluster: is a Kubernetes cluster whose lifecycle is managed by a Management Cluster.
+
+In Verrazzano, the management cluster is typically deployed in an "Admin" cluster. The workload clusters are equivalent to managed clusters.
+
+You can use CAPI to provision clusters the following type of clusters:
+
+- [OKE](./advanced.md/oke.md)
+- [OCNE](./advanced.md/ocne.md)
+
+To enable Cluster API, configure its parameter in `terraform.tfvars`:
+
+``` yaml
+cluster_api = true
+```

docs/src/advanced/ocne.md

@@ -0,0 +1 @@
+# OCNE

docs/src/advanced/oke.md

@@ -0,0 +1 @@
+# OKE

docs/src/terraformoptions.md

@@ -51,7 +51,7 @@
 | --------- | ----------- | ----------- | ------- |
 | get_kubeconfigs | Whether to set up access to the clusters. Set to false on cluster creation. | bool | false |
 | install_verrazzano | Whether ready to install Verrazzano. Set to false on cluster creation | string | false |
-| verrazzano_version | Verrazzano version to install | 1.5.3 | 1.5.3 |
+| verrazzano_version | Verrazzano version to install | 1.6.0 | 1.6.0 |
 | verrazzano_profile | Verrazzano profile to install | dev/prod | dev |
 | verrazzano_control_plane | Whether to keep all Verrazzano control planes public or private | public/private | public |
 | verrazzano_data_plane | Whether to keep all Verrazzano data planes public or private | public/private | public |
@@ -74,6 +74,7 @@
 | prometheus    | Whether to create an instance of Prometheus | bool | true |
 | prometheus_operator    | Whether to install the Prometheus Operator | bool | true |
 | rancher    | Whether to install Rancher | bool | true |
+| thanos    | Whether to enable Thanos  | map (string) |  |
 | velero    | Whether to install Velero | bool | false |
 | weblogic_operator    | Whether to install WebLogic Operator | bool | false |
 

terraform.tfvars.example

@@ -101,7 +101,7 @@ cloudinit_nodepool_common = "./cloudinit.sh"
 
 # verrazzano
 install_verrazzano = false
-verrazzano_version = "1.5.3"
+verrazzano_version = "1.6.0"
 verrazzano_profile = "prod"
 
 # ingress-nginx

variables.tf

@@ -253,7 +253,7 @@ variable "install_verrazzano" {
 }
 
 variable "verrazzano_version" {
-  default     = "1.5.3"
+  default     = "1.6.0"
   description = "Verrazzano version to install"
   type        = string
 }