cdk8s-plus-32 2.4.13 → 2.5.0

package/docs/java.md

@@ -7023,6 +7023,7 @@ StatefulSet.Builder.create(Construct scope, java.lang.String id)
 //  .replicas(java.lang.Number)
 //  .service(Service)
 //  .strategy(StatefulSetUpdateStrategy)
+//  .volumeClaimTemplates(java.util.List<PersistentVolumeClaimTemplateProps>)
     .build();
 ```
 
@@ -7307,8 +7308,34 @@ Indicates the StatefulSetUpdateStrategy that will be employed to update Pods in
 
 ---
 
+##### `volumeClaimTemplates`<sup>Optional</sup> <a name="org.cdk8s.plus32.StatefulSetProps.parameter.volumeClaimTemplates"></a>
+
+- *Type:* java.util.List<[`org.cdk8s.plus32.PersistentVolumeClaimTemplateProps`](#org.cdk8s.plus32.PersistentVolumeClaimTemplateProps)>
+- *Default:* No volume claim templates will be created.
+
+A list of PersistentVolumeClaim templates that will be created for each pod in the StatefulSet.
+
+The StatefulSet controller creates a PVC and a PV for each template based on the pod's ordinal index,
+ensuring stable storage across pod restarts and rescheduling.
+
+Each claim in this list must have at least one matching (by name) volumeMount in one of the containers.
+
+---
+
 #### Methods <a name="Methods"></a>
 
+##### `addVolumeClaimTemplate` <a name="org.cdk8s.plus32.StatefulSet.addVolumeClaimTemplate"></a>
+
+```java
+public addVolumeClaimTemplate(PersistentVolumeClaimTemplateProps template)
+```
+
+###### `template`<sup>Required</sup> <a name="org.cdk8s.plus32.StatefulSet.parameter.template"></a>
+
+- *Type:* [`org.cdk8s.plus32.PersistentVolumeClaimTemplateProps`](#org.cdk8s.plus32.PersistentVolumeClaimTemplateProps)
+
+---
+
 ##### `markHasAutoscaler` <a name="org.cdk8s.plus32.StatefulSet.markHasAutoscaler"></a>
 
 ```java
@@ -7406,6 +7433,16 @@ If this is a target of an autoscaler.
 
 ---
 
+##### `volumeClaimTemplates`<sup>Optional</sup> <a name="org.cdk8s.plus32.StatefulSet.property.volumeClaimTemplates"></a>
+
+```java
+public java.util.List<PersistentVolumeClaimTemplateProps> getVolumeClaimTemplates();
+```
+
+- *Type:* java.util.List<[`org.cdk8s.plus32.PersistentVolumeClaimTemplateProps`](#org.cdk8s.plus32.PersistentVolumeClaimTemplateProps)>
+
+---
+
 
 ### TlsSecret <a name="org.cdk8s.plus32.TlsSecret"></a>
 
@@ -7843,6 +7880,32 @@ Volume.fromHostPath(Construct scope, java.lang.String id, java.lang.String name,
 
 ---
 
+##### `fromName` <a name="org.cdk8s.plus32.Volume.fromName"></a>
+
+```java
+import org.cdk8s.plus32.Volume;
+
+Volume.fromName(Construct scope, java.lang.String id, java.lang.String name)
+```
+
+###### `scope`<sup>Required</sup> <a name="org.cdk8s.plus32.Volume.parameter.scope"></a>
+
+- *Type:* [`software.constructs.Construct`](#software.constructs.Construct)
+
+---
+
+###### `id`<sup>Required</sup> <a name="org.cdk8s.plus32.Volume.parameter.id"></a>
+
+- *Type:* `java.lang.String`
+
+---
+
+###### `name`<sup>Required</sup> <a name="org.cdk8s.plus32.Volume.parameter.name"></a>
+
+- *Type:* `java.lang.String`
+
+---
+
 ##### `fromNfs` <a name="org.cdk8s.plus32.Volume.fromNfs"></a>
 
 ```java
@@ -15366,6 +15429,140 @@ Defines what type of volume is required by the claim.
 
 ---
 
+### PersistentVolumeClaimTemplateProps <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps"></a>
+
+A PersistentVolumeClaim template for StatefulSets.
+
+#### Initializer <a name="[object Object].Initializer"></a>
+
+```java
+import org.cdk8s.plus32.PersistentVolumeClaimTemplateProps;
+
+PersistentVolumeClaimTemplateProps.builder()
+//  .metadata(ApiObjectMetadata)
+//  .accessModes(java.util.List<PersistentVolumeAccessMode>)
+//  .storage(Size)
+//  .storageClassName(java.lang.String)
+//  .volume(IPersistentVolume)
+//  .volumeMode(PersistentVolumeMode)
+    .name(java.lang.String)
+    .build();
+```
+
+##### `metadata`<sup>Optional</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.metadata"></a>
+
+```java
+public ApiObjectMetadata getMetadata();
+```
+
+- *Type:* [`org.cdk8s.ApiObjectMetadata`](#org.cdk8s.ApiObjectMetadata)
+
+Metadata that all persisted resources must have, which includes all objects users must create.
+
+---
+
+##### `accessModes`<sup>Optional</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.accessModes"></a>
+
+```java
+public java.util.List<PersistentVolumeAccessMode> getAccessModes();
+```
+
+- *Type:* java.util.List<[`org.cdk8s.plus32.PersistentVolumeAccessMode`](#org.cdk8s.plus32.PersistentVolumeAccessMode)>
+- *Default:* No access modes requirement.
+
+Contains the access modes the volume should support.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+
+---
+
+##### `storage`<sup>Optional</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.storage"></a>
+
+```java
+public Size getStorage();
+```
+
+- *Type:* [`org.cdk8s.Size`](#org.cdk8s.Size)
+- *Default:* No storage requirement.
+
+Minimum storage size the volume should have.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
+
+---
+
+##### `storageClassName`<sup>Optional</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.storageClassName"></a>
+
+```java
+public java.lang.String getStorageClassName();
+```
+
+- *Type:* `java.lang.String`
+- *Default:* Not set.
+
+Name of the StorageClass required by the claim. When this property is not set, the behavior is as follows:.
+
+* If the admission plugin is turned on, the storage class marked as default will be used.
+* If the admission plugin is turned off, the pvc can only be bound to volumes without a storage class.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
+
+---
+
+##### `volume`<sup>Optional</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.volume"></a>
+
+```java
+public IPersistentVolume getVolume();
+```
+
+- *Type:* [`org.cdk8s.plus32.IPersistentVolume`](#org.cdk8s.plus32.IPersistentVolume)
+- *Default:* No specific volume binding.
+
+The PersistentVolume backing this claim.
+
+The control plane still checks that storage class, access modes,
+and requested storage size on the volume are valid.
+
+Note that in order to guarantee a proper binding, the volume should
+also define a `claimRef` referring to this claim. Otherwise, the volume may be
+claimed be other pvc's before it gets a chance to bind to this one.
+
+If the volume is managed (i.e not imported), you can use `pv.claim()` to easily
+create a bi-directional bounded claim.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes/#binding.
+
+---
+
+##### `volumeMode`<sup>Optional</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.volumeMode"></a>
+
+```java
+public PersistentVolumeMode getVolumeMode();
+```
+
+- *Type:* [`org.cdk8s.plus32.PersistentVolumeMode`](#org.cdk8s.plus32.PersistentVolumeMode)
+- *Default:* VolumeMode.FILE_SYSTEM
+
+Defines what type of volume is required by the claim.
+
+---
+
+##### `name`<sup>Required</sup> <a name="org.cdk8s.plus32.PersistentVolumeClaimTemplateProps.property.name"></a>
+
+```java
+public java.lang.String getName();
+```
+
+- *Type:* `java.lang.String`
+
+The name of the claim that the StatefulSet controller will create for each pod.
+
+This will be used to name the created PVC in the format <claim-name>-<pod-name>
+
+This name should match the name of a volume mount in one of the containers.
+
+---
+
 ### PersistentVolumeClaimVolumeOptions <a name="org.cdk8s.plus32.PersistentVolumeClaimVolumeOptions"></a>
 
 Options for a PersistentVolumeClaim-based volume.
@@ -17624,6 +17821,7 @@ StatefulSetProps.builder()
 //  .replicas(java.lang.Number)
 //  .service(Service)
 //  .strategy(StatefulSetUpdateStrategy)
+//  .volumeClaimTemplates(java.util.List<PersistentVolumeClaimTemplateProps>)
     .build();
 ```
 
@@ -17992,6 +18190,24 @@ Indicates the StatefulSetUpdateStrategy that will be employed to update Pods in
 
 ---
 
+##### `volumeClaimTemplates`<sup>Optional</sup> <a name="org.cdk8s.plus32.StatefulSetProps.property.volumeClaimTemplates"></a>
+
+```java
+public java.util.List<PersistentVolumeClaimTemplateProps> getVolumeClaimTemplates();
+```
+
+- *Type:* java.util.List<[`org.cdk8s.plus32.PersistentVolumeClaimTemplateProps`](#org.cdk8s.plus32.PersistentVolumeClaimTemplateProps)>
+- *Default:* No volume claim templates will be created.
+
+A list of PersistentVolumeClaim templates that will be created for each pod in the StatefulSet.
+
+The StatefulSet controller creates a PVC and a PV for each template based on the pod's ordinal index,
+ensuring stable storage across pod restarts and rescheduling.
+
+Each claim in this list must have at least one matching (by name) volumeMount in one of the containers.
+
+---
+
 ### StatefulSetUpdateStrategyRollingUpdateOptions <a name="org.cdk8s.plus32.StatefulSetUpdateStrategyRollingUpdateOptions"></a>
 
 Options for `StatefulSetUpdateStrategy.rollingUpdate`.

package/docs/plus/volume.md

@@ -36,3 +36,49 @@ const redis = pod.addContainer({
 // mount to the redis container.
 redis.mount('/var/lib/redis', data);
 ```
+
+## Using PersistentVolumeClaim Templates with StatefulSets
+
+When working with StatefulSets, you can use PersistentVolumeClaim templates to create stable storage for each pod in the StatefulSet. This allows each pod to have its own storage that persists even if the pod is rescheduled to a different node.
+
+```typescript
+import * as kplus from 'cdk8s-plus-32';
+import { Size } from 'cdk8s';
+
+const dataVolume = Volume.fromName(chart, "pvc-template-data", "data-volume")
+
+// Create a StatefulSet with a PVC template
+const statefulSet = new kplus.StatefulSet(this, 'StatefulSet', {
+  containers: [{
+    image: 'nginx',
+    volumeMounts: [{
+      volume: dataVolume,
+      path: '/data',
+    }, {
+      volume: Volume.fromName(chart, "pvc-template-temp", "temp-volume"),
+      path: '/data',
+    }],
+  }],
+  // Define PVC templates during initialization
+  volumeClaimTemplates: [{
+    name: dataVolume.name,
+    storage: Size.gibibytes(10),
+    accessModes: [kplus.PersistentVolumeAccessMode.READ_WRITE_ONCE],
+    storageClassName: 'standard',  // Optional: Specify the storage class
+  }, {
+    name: 'temp-volume',  // Must match a volume mount name in a container
+    storage: Size.gibibytes(10),
+    accessModes: [kplus.PersistentVolumeAccessMode.READ_WRITE_ONCE],
+    storageClassName: 'standard',  // Optional: Specify the storage class
+  }],
+});
+
+// Or add PVC templates after creation
+statefulSet.addVolumeClaimTemplate({
+  name: 'logs-volume',
+  storage: Size.gibibytes(5),
+  accessModes: [kplus.PersistentVolumeAccessMode.READ_WRITE_ONCE],
+});
+```
+
+Each pod in the StatefulSet will get its own PVC instance based on these templates, with names like `data-volume-my-statefulset-0`, `data-volume-my-statefulset-1`, etc.

package/docs/python.md

@@ -7999,7 +7999,8 @@ cdk8s_plus_32.StatefulSet(
   pod_management_policy: PodManagementPolicy = None,
   replicas: typing.Union[int, float] = None,
   service: Service = None,
-  strategy: StatefulSetUpdateStrategy = None
+  strategy: StatefulSetUpdateStrategy = None,
+  volume_claim_templates: typing.List[PersistentVolumeClaimTemplateProps] = None
 )
 ```
 
@@ -8284,8 +8285,122 @@ Indicates the StatefulSetUpdateStrategy that will be employed to update Pods in
 
 ---
 
+##### `volume_claim_templates`<sup>Optional</sup> <a name="cdk8s_plus_32.StatefulSetProps.parameter.volume_claim_templates"></a>
+
+- *Type:* typing.List[[`cdk8s_plus_32.PersistentVolumeClaimTemplateProps`](#cdk8s_plus_32.PersistentVolumeClaimTemplateProps)]
+- *Default:* No volume claim templates will be created.
+
+A list of PersistentVolumeClaim templates that will be created for each pod in the StatefulSet.
+
+The StatefulSet controller creates a PVC and a PV for each template based on the pod's ordinal index,
+ensuring stable storage across pod restarts and rescheduling.
+
+Each claim in this list must have at least one matching (by name) volumeMount in one of the containers.
+
+---
+
 #### Methods <a name="Methods"></a>
 
+##### `add_volume_claim_template` <a name="cdk8s_plus_32.StatefulSet.add_volume_claim_template"></a>
+
+```python
+def add_volume_claim_template(
+  metadata: ApiObjectMetadata = None,
+  access_modes: typing.List[PersistentVolumeAccessMode] = None,
+  storage: Size = None,
+  storage_class_name: str = None,
+  volume: IPersistentVolume = None,
+  volume_mode: PersistentVolumeMode = None,
+  name: str
+)
+```
+
+###### `metadata`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.metadata"></a>
+
+- *Type:* [`cdk8s.ApiObjectMetadata`](#cdk8s.ApiObjectMetadata)
+
+Metadata that all persisted resources must have, which includes all objects users must create.
+
+---
+
+###### `access_modes`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.access_modes"></a>
+
+- *Type:* typing.List[[`cdk8s_plus_32.PersistentVolumeAccessMode`](#cdk8s_plus_32.PersistentVolumeAccessMode)]
+- *Default:* No access modes requirement.
+
+Contains the access modes the volume should support.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+
+---
+
+###### `storage`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.storage"></a>
+
+- *Type:* [`cdk8s.Size`](#cdk8s.Size)
+- *Default:* No storage requirement.
+
+Minimum storage size the volume should have.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
+
+---
+
+###### `storage_class_name`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.storage_class_name"></a>
+
+- *Type:* `str`
+- *Default:* Not set.
+
+Name of the StorageClass required by the claim. When this property is not set, the behavior is as follows:.
+
+* If the admission plugin is turned on, the storage class marked as default will be used.
+* If the admission plugin is turned off, the pvc can only be bound to volumes without a storage class.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
+
+---
+
+###### `volume`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.volume"></a>
+
+- *Type:* [`cdk8s_plus_32.IPersistentVolume`](#cdk8s_plus_32.IPersistentVolume)
+- *Default:* No specific volume binding.
+
+The PersistentVolume backing this claim.
+
+The control plane still checks that storage class, access modes,
+and requested storage size on the volume are valid.
+
+Note that in order to guarantee a proper binding, the volume should
+also define a `claimRef` referring to this claim. Otherwise, the volume may be
+claimed be other pvc's before it gets a chance to bind to this one.
+
+If the volume is managed (i.e not imported), you can use `pv.claim()` to easily
+create a bi-directional bounded claim.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes/#binding.
+
+---
+
+###### `volume_mode`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.volume_mode"></a>
+
+- *Type:* [`cdk8s_plus_32.PersistentVolumeMode`](#cdk8s_plus_32.PersistentVolumeMode)
+- *Default:* VolumeMode.FILE_SYSTEM
+
+Defines what type of volume is required by the claim.
+
+---
+
+###### `name`<sup>Required</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.parameter.name"></a>
+
+- *Type:* `str`
+
+The name of the claim that the StatefulSet controller will create for each pod.
+
+This will be used to name the created PVC in the format <claim-name>-<pod-name>
+
+This name should match the name of a volume mount in one of the containers.
+
+---
+
 ##### `mark_has_autoscaler` <a name="cdk8s_plus_32.StatefulSet.mark_has_autoscaler"></a>
 
 ```python
@@ -8383,6 +8498,16 @@ If this is a target of an autoscaler.
 
 ---
 
+##### `volume_claim_templates`<sup>Optional</sup> <a name="cdk8s_plus_32.StatefulSet.property.volume_claim_templates"></a>
+
+```python
+volume_claim_templates: typing.List[PersistentVolumeClaimTemplateProps]
+```
+
+- *Type:* typing.List[[`cdk8s_plus_32.PersistentVolumeClaimTemplateProps`](#cdk8s_plus_32.PersistentVolumeClaimTemplateProps)]
+
+---
+
 
 ### TlsSecret <a name="cdk8s_plus_32.TlsSecret"></a>
 
@@ -9100,6 +9225,36 @@ The expected type of the path found on the host.
 
 ---
 
+##### `from_name` <a name="cdk8s_plus_32.Volume.from_name"></a>
+
+```python
+import cdk8s_plus_32
+
+cdk8s_plus_32.Volume.from_name(
+  scope: Construct,
+  id: str,
+  name: str
+)
+```
+
+###### `scope`<sup>Required</sup> <a name="cdk8s_plus_32.Volume.parameter.scope"></a>
+
+- *Type:* [`constructs.Construct`](#constructs.Construct)
+
+---
+
+###### `id`<sup>Required</sup> <a name="cdk8s_plus_32.Volume.parameter.id"></a>
+
+- *Type:* `str`
+
+---
+
+###### `name`<sup>Required</sup> <a name="cdk8s_plus_32.Volume.parameter.name"></a>
+
+- *Type:* `str`
+
+---
+
 ##### `from_nfs` <a name="cdk8s_plus_32.Volume.from_nfs"></a>
 
 ```python
@@ -16718,6 +16873,140 @@ Defines what type of volume is required by the claim.
 
 ---
 
+### PersistentVolumeClaimTemplateProps <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps"></a>
+
+A PersistentVolumeClaim template for StatefulSets.
+
+#### Initializer <a name="[object Object].Initializer"></a>
+
+```python
+import cdk8s_plus_32
+
+cdk8s_plus_32.PersistentVolumeClaimTemplateProps(
+  metadata: ApiObjectMetadata = None,
+  access_modes: typing.List[PersistentVolumeAccessMode] = None,
+  storage: Size = None,
+  storage_class_name: str = None,
+  volume: IPersistentVolume = None,
+  volume_mode: PersistentVolumeMode = None,
+  name: str
+)
+```
+
+##### `metadata`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.metadata"></a>
+
+```python
+metadata: ApiObjectMetadata
+```
+
+- *Type:* [`cdk8s.ApiObjectMetadata`](#cdk8s.ApiObjectMetadata)
+
+Metadata that all persisted resources must have, which includes all objects users must create.
+
+---
+
+##### `access_modes`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.access_modes"></a>
+
+```python
+access_modes: typing.List[PersistentVolumeAccessMode]
+```
+
+- *Type:* typing.List[[`cdk8s_plus_32.PersistentVolumeAccessMode`](#cdk8s_plus_32.PersistentVolumeAccessMode)]
+- *Default:* No access modes requirement.
+
+Contains the access modes the volume should support.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
+
+---
+
+##### `storage`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.storage"></a>
+
+```python
+storage: Size
+```
+
+- *Type:* [`cdk8s.Size`](#cdk8s.Size)
+- *Default:* No storage requirement.
+
+Minimum storage size the volume should have.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
+
+---
+
+##### `storage_class_name`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.storage_class_name"></a>
+
+```python
+storage_class_name: str
+```
+
+- *Type:* `str`
+- *Default:* Not set.
+
+Name of the StorageClass required by the claim. When this property is not set, the behavior is as follows:.
+
+* If the admission plugin is turned on, the storage class marked as default will be used.
+* If the admission plugin is turned off, the pvc can only be bound to volumes without a storage class.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
+
+---
+
+##### `volume`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.volume"></a>
+
+```python
+volume: IPersistentVolume
+```
+
+- *Type:* [`cdk8s_plus_32.IPersistentVolume`](#cdk8s_plus_32.IPersistentVolume)
+- *Default:* No specific volume binding.
+
+The PersistentVolume backing this claim.
+
+The control plane still checks that storage class, access modes,
+and requested storage size on the volume are valid.
+
+Note that in order to guarantee a proper binding, the volume should
+also define a `claimRef` referring to this claim. Otherwise, the volume may be
+claimed be other pvc's before it gets a chance to bind to this one.
+
+If the volume is managed (i.e not imported), you can use `pv.claim()` to easily
+create a bi-directional bounded claim.
+
+> https://kubernetes.io/docs/concepts/storage/persistent-volumes/#binding.
+
+---
+
+##### `volume_mode`<sup>Optional</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.volume_mode"></a>
+
+```python
+volume_mode: PersistentVolumeMode
+```
+
+- *Type:* [`cdk8s_plus_32.PersistentVolumeMode`](#cdk8s_plus_32.PersistentVolumeMode)
+- *Default:* VolumeMode.FILE_SYSTEM
+
+Defines what type of volume is required by the claim.
+
+---
+
+##### `name`<sup>Required</sup> <a name="cdk8s_plus_32.PersistentVolumeClaimTemplateProps.property.name"></a>
+
+```python
+name: str
+```
+
+- *Type:* `str`
+
+The name of the claim that the StatefulSet controller will create for each pod.
+
+This will be used to name the created PVC in the format <claim-name>-<pod-name>
+
+This name should match the name of a volume mount in one of the containers.
+
+---
+
 ### PersistentVolumeClaimVolumeOptions <a name="cdk8s_plus_32.PersistentVolumeClaimVolumeOptions"></a>
 
 Options for a PersistentVolumeClaim-based volume.
@@ -18975,7 +19264,8 @@ cdk8s_plus_32.StatefulSetProps(
   pod_management_policy: PodManagementPolicy = None,
   replicas: typing.Union[int, float] = None,
   service: Service = None,
-  strategy: StatefulSetUpdateStrategy = None
+  strategy: StatefulSetUpdateStrategy = None,
+  volume_claim_templates: typing.List[PersistentVolumeClaimTemplateProps] = None
 )
 ```
 
@@ -19344,6 +19634,24 @@ Indicates the StatefulSetUpdateStrategy that will be employed to update Pods in
 
 ---
 
+##### `volume_claim_templates`<sup>Optional</sup> <a name="cdk8s_plus_32.StatefulSetProps.property.volume_claim_templates"></a>
+
+```python
+volume_claim_templates: typing.List[PersistentVolumeClaimTemplateProps]
+```
+
+- *Type:* typing.List[[`cdk8s_plus_32.PersistentVolumeClaimTemplateProps`](#cdk8s_plus_32.PersistentVolumeClaimTemplateProps)]
+- *Default:* No volume claim templates will be created.
+
+A list of PersistentVolumeClaim templates that will be created for each pod in the StatefulSet.
+
+The StatefulSet controller creates a PVC and a PV for each template based on the pod's ordinal index,
+ensuring stable storage across pod restarts and rescheduling.
+
+Each claim in this list must have at least one matching (by name) volumeMount in one of the containers.
+
+---
+
 ### StatefulSetUpdateStrategyRollingUpdateOptions <a name="cdk8s_plus_32.StatefulSetUpdateStrategyRollingUpdateOptions"></a>
 
 Options for `StatefulSetUpdateStrategy.rollingUpdate`.