docs chagnes to support infra creation

Author: Karthik-K-N

docs/book/src/SUMMARY.md

@@ -17,6 +17,7 @@
     - [Creating a cluster](./topics/powervs/creating-a-cluster.md)
     - [Creating a cluster with External Cloud Provider](./topics/powervs/external-cloud-provider.md)
     - [Creating a cluster from ClusterClass](./topics/powervs/clusterclass-cluster.md)
+    - [Creating a cluster by auto creating required resources](./topics/powervs/create-resources.md)
     - [Using autoscaler with scaling from 0 machine](./topics/powervs/autoscaler-scalling-from-0.md)
 - [capibmadm CLI](./topics/capibmadm/index.md)
   - [PowerVS Commands](./topics/capibmadm/powervs/index.md)

docs/book/src/topics/powervs/create-resources.md

@@ -0,0 +1,29 @@
+# Create required resources for IBM PowerVS cluster
+
+## Steps
+
+- To deploy cluster which creates required resources, set ```powervs.cluster.x-k8s.io/create-infra:true``` annotation to IBMPowerVSCluster resource.
+- The cluster will be configured with IBM PowerVS external [cloud provider](https://kubernetes.io/docs/concepts/architecture/cloud-controller/)
+- The [create_infra template](https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/blob/main/templates/cluster-template-powervs-create-infra.yaml) will use [clusterresourceset](https://cluster-api.sigs.k8s.io/tasks/experimental-features/cluster-resource-set.html) and will create the necessary config map, secret and roles to run the cloud controller manager
+- As a prerequisite set the `provider-id-fmt` [flag](https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/blob/5e7f80878f2252c6ab13c16102de90c784a2624d/main.go#L168-L173) with value v2
+
+### Deploy PowerVS cluster with IBM PowerVS cloud provider
+
+  ```
+IBMCLOUD_API_KEY=<api_key>> \
+IBMPOWERVS_SSHKEY_NAME="karthik-ssh" \
+COS_BUCKET_REGION="us-south" \
+COS_BUCKET_NAME="power-oss-bucket" \
+COS_OBJECT_NAME=capibm-powervs-centos-streams8-1-28-4-1707287079.ova.gz \
+IBMACCOUNT_ID="<account_id>" \
+IBMPOWERVS_REGION="wdc" \
+IBMPOWERVS_ZONE="wdc06" \
+IBMVPC_REGION="us-east" \
+IBM_RESOURCE_GROUP="ibm-hypershift-dev" \
+BASE64_API_KEY=$(echo -n $IBMCLOUD_API_KEY | base64) \
+clusterctl generate cluster capi-powervs- --kubernetes-version v1.28.4 \
+--target-namespace default \
+--control-plane-machine-count=3 \
+--worker-machine-count=1 \
+--from ./cluster-template-powervs-create-infra.yaml | kubectl apply -f -
+  ```

docs/book/src/topics/powervs/index.md

@@ -5,4 +5,5 @@
 - [Creating a cluster](/topics/powervs/creating-a-cluster.html)
 - [Creating a cluster with external cloud provider](/topics/powervs/external-cloud-provider.html)
 - [Creating a cluster from ClusterClass](/topics/powervs/clusterclass-cluster.html)
+- [Creating a cluster by auto creating required resources](/topics/powervs/create-resources.html)
 - [Using autoscaler with scaling from 0 machine](/topics/powervs/autoscaler-scalling-from-0.html)

docs/proposal/20231109-powervs-infra-creation.md

@@ -158,15 +158,6 @@ type VPCResourceReference struct {
 
 // CosInstance represents IBM Cloud COS instance.
 type CosInstance struct {
-	// PresignedURLDuration defines the duration for which presigned URLs are valid.
-	//
-	// This is used to generate presigned URLs for S3 Bucket objects, which are used by
-	// control-plane and worker nodes to fetch bootstrap data.
-	//
-	// When enabled, the IAM instance profiles specified are not used.
-	// +optional
-	PresignedURLDuration *metav1.Duration `json:"presignedURLDuration,omitempty"`
-
 	// Name defines name of IBM cloud COS instance to be created.
 	// +kubebuilder:validation:MinLength:=3
 	// +kubebuilder:validation:MaxLength:=63