add ref links for environment variables

Author: arshadd-b

docs/book/src/topics/powervs/creating-a-cluster.md

@@ -134,6 +134,32 @@ following the steps below.
     ibm-powervs-1-md-0-4dc5c             Ready    <none>   41h   v1.26.2
     ibm-powervs-1-md-0-dbxb7             Ready    <none>   20h   v1.26.2
 
+### Deploy a PowerVS cluster with user provided resources
+
+  ```
+  IBMPOWERVS_SSHKEY_NAME="my-pub-key" \
+  IBMPOWERVS_VIP="192.168.167.6" \
+  IBMPOWERVS_VIP_EXTERNAL="163.68.65.6" \
+  IBMPOWERVS_VIP_CIDR="29" \
+  IBMPOWERVS_IMAGE_NAME="capibm-powervs-centos-streams8-1-26-2" \
+  IBMPOWERVS_SERVICE_INSTANCE_ID="3229a94c-af54-4212-bf60-6202b6fd0a07" \
+  IBMPOWERVS_NETWORK_NAME="capi-test" \
+  clusterctl generate cluster ibm-powervs-1 --kubernetes-version v1.26.2 \
+  --target-namespace default \
+  --control-plane-machine-count=3 \
+  --worker-machine-count=1 \
+  --flavor=powervs | kubectl apply -f -
+  ```
+
+ **Note:** Refer below for more detailed information on POWERVS variables.
+- [IBMPOWERVS_SSHKEY_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-creating-ssh-key)
+- [IBMPOWERVS_VIP](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_VIP_EXTERNAL](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_VIP_CIDR](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_IMAGE_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-conn-COS-custom-image)
+- [IBMPOWERVS_SERVICE_INSTANCE_ID](/topics/capibmadm/powervs/image.html)
+- [IBMPOWERVS_NETWORK_NAME](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create.html)
+
 ### Deploy a PowerVS cluster with infrastructure creation
 
 #### Prerequisites: 
@@ -158,6 +184,54 @@ following the steps below.
     --flavor=powervs-create-infra | kubectl apply -f -
   ```
 
+**Note:** Refer below for more detailed information on POWERVS variables.
+- [IBMPOWERVS_SSHKEY_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-creating-ssh-key)
+- [COS_BUCKET_REGION](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-endpoints#endpoints-region)
+- [COS_BUCKET_NAME](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-getting-started-cloud-object-storage#gs-create-buckets)
+- [COS_OBJECT_NAME](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-getting-started-cloud-object-storage#gs-add-objects)
+- [IBMACCOUNT_ID](https://cloud.ibm.com/docs/account?topic=account-accountfaqs#account-details)
+- [IBMPOWERVS_REGION](/reference/regions-zones-mapping.html)
+- [IBMPOWERVS_ZONE](/reference/regions-zones-mapping.html)
+- [IBMVPC_REGION](/reference/regions-zones-mapping.html)
+- [IBM_RESOURCE_GROUP](https://cloud.ibm.com/docs/account?topic=account-rgs&interface=ui)
+  
+### Deploy a PowerVS cluster with external cloud provider
+
+#### Prerequisites:
+- Set `EXP_CLUSTER_RESOURCE_SET` to true as the cluster will be deployed with external cloud provider which will create the resources to run the cloud controller manager.
+- Set the `provider-id-fmt` [flag](https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/blob/5e7f80878f2252c6ab13c16102de90c784a2624d/main.go#L168-L173) to `v2` via `PROVIDER_ID_FORMAT` environment variable.
+
+  ```
+  IBMPOWERVS_SSHKEY_NAME="my-pub-key" \
+  IBMPOWERVS_VIP="192.168.167.6" \
+  IBMPOWERVS_VIP_EXTERNAL="163.68.65.6" \
+  IBMPOWERVS_VIP_CIDR="29" \
+  IBMPOWERVS_IMAGE_NAME="capibm-powervs-centos-streams8-1-26-2" \
+  IBMPOWERVS_SERVICE_INSTANCE_ID="3229a94c-af54-4212-bf60-6202b6fd0a07" \
+  IBMPOWERVS_NETWORK_NAME="capi-test" \
+  IBMACCOUNT_ID="ibm-accountid" \
+  IBMPOWERVS_REGION="osa" \
+  IBMPOWERVS_ZONE="osa21" \
+  BASE64_API_KEY=$(echo -n $IBMCLOUD_API_KEY | base64) \
+  clusterctl generate cluster ibm-powervs-1 --kubernetes-version v1.26.2 \
+  --target-namespace default \
+  --control-plane-machine-count=3 \
+  --worker-machine-count=1 \
+  --flavor=powervs-cloud-provider | kubectl apply -f -
+  ```
+
+**Note:** Refer below for more detailed information on POWERVS variables.
+- [IBMPOWERVS_SSHKEY_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-creating-ssh-key)
+- [IBMPOWERVS_VIP](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_VIP_EXTERNAL](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_VIP_CIDR](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_IMAGE_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-conn-COS-custom-image)
+- [IBMPOWERVS_SERVICE_INSTANCE_ID](/topics/capibmadm/powervs/image.html)
+- [IBMPOWERVS_NETWORK_NAME](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create.html)
+- [IBMACCOUNT_ID](https://cloud.ibm.com/docs/account?topic=account-accountfaqs#account-details)
+- [IBMPOWERVS_REGION](/reference/regions-zones-mapping.html)
+- [IBMPOWERVS_ZONE](/reference/regions-zones-mapping.html)
+
 ### Deploy a PowerVS cluster with cluster class
 
 #### Prerequisites:
@@ -181,4 +255,18 @@ following the steps below.
   --control-plane-machine-count=3 \
   --worker-machine-count=1 \
   --flavor=powervs-clusterclass | kubectl apply -f -
-  ```
+  ```
+
+**Note:** Refer below for more detailed information on POWERVS variables.
+- [IBMPOWERVS_CLUSTER_CLASS_NAME](/tasks/experimental-features/cluster-class/index.html)
+- [IBMPOWERVS_SSHKEY_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-creating-ssh-key)
+- [IBMPOWERVS_VIP](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_VIP_EXTERNAL](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_VIP_CIDR](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create)
+- [IBMPOWERVS_IMAGE_NAME](https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-conn-COS-custom-image)
+- [IBMPOWERVS_SERVICE_INSTANCE_ID](/topics/capibmadm/powervs/image.html)
+- [IBMACCOUNT_ID](https://cloud.ibm.com/docs/account?topic=account-accountfaqs#account-details)
+- [IBMPOWERVS_NETWORK_NAME](/topics/capibmadm/powervs/network#1-capibmadm-powervs-network-create.html)
+- [IBMPOWERVS_REGION](/reference/regions-zones-mapping.html)
+- [IBMPOWERVS_ZONE](/reference/regions-zones-mapping.html)
+  

docs/book/src/topics/vpc/creating-a-cluster.md

@@ -121,4 +121,13 @@ There are two following variables for controlling the volume size for the boot d
     IBMACCOUNT_ID="ibm-accountid" \
     BASE64_API_KEY=$(echo -n $IBMCLOUD_API_KEY | base64) \
     clusterctl generate cluster ibm-vpc-clusterclass --kubernetes-version v1.26.2 --target-namespace default --control-plane-machine-count=1 --worker-machine-count=2 --from=./templates/cluster-template-vpc-clusterclass.yaml | kubectl apply -f -
-  
+ 
+**Note:** Refer below for more detailed information on VPC variables.
+- [IBMVPC_CLUSTER_CLASS_NAME](/tasks/experimental-features/cluster-class/index.html)
+- [IBMVPC_REGION](/reference/regions-zones-mapping.html)
+- [IBMVPC_ZONE](/reference/regions-zones-mapping.html)
+- [IBMVPC_RESOURCEGROUP](https://cloud.ibm.com/docs/account?topic=account-rgs&interface=ui)
+- [IBMVPC_IMAGE_NAME](https://cloud.ibm.com/docs/vpc?topic=vpc-planning-custom-images)
+- [IBMVPC_PROFILE](https://cloud.ibm.com/docs/vpc?topic=vpc-profiles&interface=ui)
+- [IBMVPC_SSHKEY_NAME](https://cloud.ibm.com/docs/vpc?topic=vpc-managing-ssh-keys&interface=ui)
+- [IBMACCOUNT_ID](https://cloud.ibm.com/docs/account?topic=account-accountfaqs#account-details)