From b9cf802b118395261db168c8d4f4f1b3e8e308b6 Mon Sep 17 00:00:00 2001
From: Shyam Radhakrishnan <shyam.radhakrishnan@oracle.com>
Date: Tue, 30 May 2023 18:42:24 +0530
Subject: [PATCH] Add support for enhanced cluster and virtual node pool

---
 docs/src/SUMMARY.md                           |  1 +
 .../virtual-nodes-and-enhanced-clusters.md    | 32 +++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 docs/src/managed/virtual-nodes-and-enhanced-clusters.md

diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 08211362..4f5c01f1 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -37,6 +37,7 @@
   - [Custom Networking](./networking/custom-networking.md)
   - [Private Cluster](./networking/private-cluster.md)
 - [Managed Clusters (OKE)](./managed/managedcluster.md)
+  - [Virtual Nodes and Enhanced Clusters](./managed/virtual-nodes-and-enhanced-clusters.md)
   - [Boot volume expansion](./managed/boot-volume-expansion.md)
   - [Networking customizations](./managed/networking.md)
 - [Reference](./reference/reference.md)
diff --git a/docs/src/managed/virtual-nodes-and-enhanced-clusters.md b/docs/src/managed/virtual-nodes-and-enhanced-clusters.md
new file mode 100644
index 00000000..6a682a08
--- /dev/null
+++ b/docs/src/managed/virtual-nodes-and-enhanced-clusters.md
@@ -0,0 +1,32 @@
+# OKE Enhanced Clusters and Virtual Nodes
+
+CAPOCI supports OKE [Enhanced Clusters][enhanced-cluster] and [Virtual Nodes][virtual-node-pool]. A cluster-template 
+`cluster-template-managed-virtual-node.yaml` with Enhanced Cluster and Virtual Node Pool has been released in 
+CAPOCI release artifacts which can be referred using  the flavor `managed-virtual-node` in `clusterctl generate` 
+command.
+
+
+## Create Enhanced Cluster
+The following `OCIManagedControlPlane` snippet can be used to create an enhanced OKE cluster.
+
+```yaml
+kind: OCIManagedControlPlane
+apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
+spec:
+  clusterType: "ENHANCED_CLUSTER"
+```
+
+## Create Virtual Node Pool
+
+The following `OCIVirtualMachinePool` snippet can be used to create a Virtual Node Pool. Please read through [CAPOCI 
+API Docs][api-docs] to see all the supported parameters of `OCIVirtualMachinePool`.
+
+```yaml
+apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
+kind: OCIVirtualMachinePool
+spec:
+```
+
+[enhanced-cluster]: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengcomparingenhancedwithbasicclusters_topic.htm
+[virtual-node-pool]: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengworkingwithvirtualnodes.htm
+[api-docs]: ../reference/api-reference.md