docs: added terraform options and pre-requisites

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

Author: hyder

docs/src/advanced/advanced.md

@@ -1 +1,3 @@
 # Advanced Customizations
+
+- [Customize DNS](./customizedns.md)

docs/src/css/general.css

@@ -95,8 +95,8 @@ h6:target::before {
 .content main {
     margin-left: auto;
     margin-right: auto;
-    min-width: 90%;
-    max-width: 90%;    
+    min-width: 80%;
+    max-width: 80%;    
 }
 .content p { line-height: 1.45em; }
 .content ol { line-height: 1.45em; }

docs/src/introduction.md

@@ -14,23 +14,22 @@ This module automates the installation of the [Verrazzano Container Platform][ur
 This module is currently in technical preview. Your ideas and feedback are most welcome.
 ```
 
+## Related Documentation
+
 * [Verrazzano Documentation][uri-verrazzano]
 * [Verrazzano on Medium][uri-verrazzano-medium]
 * [Verrazzano on Slack][uri-verrazzano-slack]
 * [Verrazzano on YouTube][uri-verrazzano-youtube]
 * [Terraform module for OKE][uri-terraform-oci-oke]
 
 ## Changelog
-
 View the [CHANGELOG][uri-changelog].
 
 ## Security
-
 Please consult the [security guide](./docs/SECURITY.md) for our responsible security vulnerability disclosure process
 
 
 ## License
-
 Copyright (c) 2019-2023 Oracle and/or its affiliates.
 
 Released under the Universal Permissive License v1.0 as shown at

docs/src/multi/multi.md

@@ -1 +1,6 @@
 # Multi Cluster
+
+  - [With Public Endpoints](./pub-ep.md)
+  - [With Private Endpoints](./pri-ep.md)
+  - [With Public Load Balancers](./pub-lb.md)
+  - [With Private Load Balancers](./pri-lb.md)

docs/src/multi/pub-ep.md

@@ -8,7 +8,7 @@
 ## Creating the clusters
 1. Copy terraform.tfvars.example to terraform.tfvars
 
-```
+```bash, editable
 cp terraform.tfvars.example terraform.tfvars
 
 ```
@@ -56,7 +56,7 @@ If you change the CIDR values above, it is your responsibility to ensure they do
 ```
 5. To create managed clusters in your preferred regions, set your preferred regions' values to `true` e.g. `ashburn=true` in the `clusters` parameter. Leave those that you do not use to `false` e.g.
 
-```
+```terraform, editable
 clusters = {
   # Africa
   johannesburg = false
@@ -115,7 +115,7 @@ Do not remove those that you are not using.
 
 6. For the regions you enable, uncomment them in `modules\clusters\outputs.tf` for `cluster_ids`, `int_nsg_ids` and `pub_nsg_ids`. For the clusters that you do not use, leave them commented e.g.
 
-```terraform
+```terraform,editable
 output "cluster_ids" {
   value = {
     # "johannesburg" = join(",", module.johannesburg[*].cluster_id)
@@ -162,7 +162,7 @@ output "cluster_ids" {
 ```
 6. Configure the following input variables:
 
-```terraform
+```terraform,editable
 configure_clusters = false
 install_verrazzano = false
 ```
@@ -173,7 +173,7 @@ When provisioning the cluster, the above 2 variables must set to `false`.
 
 7. Create the cluster by running Terraform:
 
-```bash
+```bash,editable
 terraform init
 terraform plan
 terraform apply
@@ -191,14 +191,14 @@ You will now generate the installation script.
 
 1. Configure the following input variables:
 
-```
+```terraform,editable
 configure_clusters = true
 install_verrazzano = true
 ```
 
 2. Configure the Verrazzano profile:
 
-```
+```terraform,editable
 verrazzano_profile = "prod"
 ```
 
@@ -258,7 +258,7 @@ You will now install Verrazzano in all clusters and register the managed cluster
 
 1. Install the Verrazzano Platform Operator:
 
-```
+```bash,editable
 cd /home/opc/vz/operator
 
 for cluster in admin phoenix ; do
@@ -293,7 +293,7 @@ The Admin cluster has more components to install and takes longer, so we install
 4. While the Admin cluster is being installed in the background, you can install the managed clusters in parallel:
 
 ```bash, editable
-for cluster in sydney melbourne ; do
+for cluster in phoenix ; do
   bash install_vz_cluster_$cluster.sh
 done
 ```

docs/src/prerequisites.md

@@ -1,3 +1,16 @@
+[uri-kubernetes]: https://kubernetes.io/
+[uri-oci]: https://docs.oracle.com/en-us/iaas/Content/home.htm
+[uri-terraform]: https://www.terraform.io/
 # Pre-requisites
 
-1. Your user must be part of a group that can create dynamic groups.
+1. Local development tools: git, terraform, a terminal.
+2. Varying levels knowledge of:
+   - Linux.
+   - [Terraform][uri-terraform].
+   - [Kubernetes][uri-kubernetes].
+3. Understanding of [OCI][uri-oci] and its services.
+4. Your Terraform user must be part of a group that can:
+   - manage dynamic groups
+   - manage VCN
+   - manage OKE clusters
+   - manage load balancers

docs/src/single/dev.md

@@ -4,9 +4,8 @@
 
 1. Copy terraform.tfvars.example to terraform.tfvars
 
-```
+```bash, editable
 cp terraform.tfvars.example terraform.tfvars
-
 ```
 2. Provide values for the following input variables: 
    - `api_fingerprint`

docs/src/single/production.md

@@ -6,7 +6,6 @@
 
 ```
 cp terraform.tfvars.example terraform.tfvars
-
 ```
 2. Provide values for the following input variables: 
    - `api_fingerprint`

docs/src/single/single.md

@@ -1 +1,5 @@
 # Single Cluster
+
+  - [Create a single Verrazzano Cluster for Development](./dev.md)
+  - [Create a single Verrazzano Cluster for production](./production.md)
+  - [Create a single customized Verrazzano Cluster](./customized.md)

docs/src/terraformoptions.md

@@ -1 +1,61 @@
 # Terraform Options
+
+### Provider
+
+| Parameter | Description | Type        | Default |
+| --------- | ----------- | ----------- | ------- |
+| api_fingerprint | Fingerprint of the API private key to use with OCI API. | string | "" |
+| api_private_key_path | The path to the OCI API private key. | string | "" |
+| home_region | The tenancy's home region. | string | "" |
+| tenancy_id | The tenancy id of the OCI Cloud Account in which to create the resources. | string | "" |
+| user_id | The id of the user that terraform will use to create the resources. | string | "" |
+| compartment_id | The compartment id where to create all resources. | string | "" |
+| label_prefix | A string that will be prepended to all resources. | string | "" |
+
+### ssh keys
+
+| Parameter | Description | Type        | Default |
+| --------- | ----------- | ----------- | ------- |
+| ssh_private_key_path | The path to ssh private key. | string | "none" |
+| ssh_public_key_path | The path to ssh public key. | string | "none" |
+
+### Networking
+
+| Parameter | Description | Type        | Default |
+| --------- | ----------- | ----------- | ------- |
+| cidrs | A map of cidrs for vcns, pods and services for each region | map(any)| |
+| connectivity_mode | Whether to keep set up connectivity in mesh or star mode. Admin is always connected to everybody | string | star |
+
+
+### clusters
+
+| Parameter | Description | Type        | Default |
+| --------- | ----------- | ----------- | ------- |
+| admin_region | The region parameters of the Admin cluster. In case a single cluster is created, the Admin region is used for the single cluster. | map(any)| |
+| kubernetes_version | The version of Kubernetes to use. | string | v1.24.1 |
+| oke_control_plane | Whether to keep all OKE control planes public or private | public/private | public |
+| clusters | A map of OCI regions where managed clusters will be created | map(bool) |  |
+| nodepools | Node pool specification for all clusters | map(bool) |  |
+| cloudinit_nodepool_common | Path to custom cloud init file for OKE workner nodes | string |  |
+
+### Verrazzano
+
+| Parameter | Description | Type        | Default |
+| --------- | ----------- | ----------- | ------- |
+| configure_clusters | 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_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 |
+| verrazzano_load_balancer | Load Balancer Shape | map(string) |  |
+
+### DNS
+
+| Parameter | Description | Type        | Default |
+| --------- | ----------- | ----------- | ------- |
+| configure_dns | Whether to configure DNS. If not configured, nip.io will be used | bool | false |
+| secret_id | OCID of OCI secret to be used for OCI DNS authentication. | string |  |
+| dns_zone_id | DNS Zone OCID in OCI DNS | string |  |
+| dns_compartment_id | DNS Zone's Compartment id | string |  |
+| dns_zone_name | DNS Zone Name | string |  |