support pvc annotation/label

.gitignore

@@ -17,4 +17,6 @@ charts/**/*.lock
 PRIVATEKEY
 PUBLICKEY
 .cursorindexingignore
-.specstory/
+.specstory/
+
+.claude

charts/sn-platform-slim/values.yaml

@@ -955,7 +955,9 @@ bookkeeper:
       #   parameters:
       #     key1: "value1"
       #     key2: "value2"
-      # metadata to add onto PVCs for journal storage
+      # Add custom annotations and labels to PVCs.
+      # Currently only BookKeeper PVCs support this feature.
+      # See docs/pulsar/pvc-metadata.md for more details.
       # metadata:
       #   annotations:
       #     example.com/annotation-key: "annotation-value"
@@ -990,7 +992,9 @@ bookkeeper:
       #   parameters:
       #     key1: "value1"
       #     key2: "value2"
-      # metadata to add onto PVCs for ledgers storage
+      # Add custom annotations and labels to PVCs.
+      # Currently only BookKeeper PVCs support this feature.
+      # See docs/pulsar/pvc-metadata.md for more details.
       # metadata:
       #   annotations:
       #     example.com/annotation-key: "annotation-value"

charts/sn-platform/values.yaml

@@ -1030,7 +1030,9 @@ bookkeeper:
       #   parameters:
       #     key1: "value1"
       #     key2: "value2"
-      # metadata to add onto PVCs for journal storage
+      # Add custom annotations and labels to PVCs.
+      # Currently only BookKeeper PVCs support this feature.
+      # See docs/pulsar/pvc-metadata.md for more details.
       # metadata:
       #   annotations:
       #     example.com/annotation-key: "annotation-value"
@@ -1065,7 +1067,9 @@ bookkeeper:
       #   parameters:
       #     key1: "value1"
       #     key2: "value2"
-      # metadata to add onto PVCs for ledgers storage
+      # Add custom annotations and labels to PVCs.
+      # Currently only BookKeeper PVCs support this feature.
+      # See docs/pulsar/pvc-metadata.md for more details.
       # metadata:
       #   annotations:
       #     example.com/annotation-key: "annotation-value"

docs/pulsar/pvc-metadata.md

@@ -0,0 +1,48 @@
+# PVC Metadata Configuration
+
+You can add custom annotations and labels to PersistentVolumeClaim (PVC) resources. Currently, only BookKeeper PVCs support this feature.
+
+## BookKeeper PVC Metadata
+
+BookKeeper uses two types of PVCs: `journal` and `ledgers`. You can configure metadata for each separately.
+
+Example:
+
+```yaml
+bookkeeper:
+  volumes:
+    journal:
+      metadata:
+        annotations:
+          example.com/annotation-key: "annotation-value"
+        labels:
+          example.com/label-key: "label-value"
+    ledgers:
+      metadata:
+        annotations:
+          example.com/annotation-key: "annotation-value"
+        labels:
+          example.com/label-key: "label-value"
+```
+
+
+The configured annotations and labels will be added to the PVC resources created by the BookKeeperCluster CR.
+
+Example:
+
+```yaml
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: journal-0
+  annotations:
+    example.com/annotation-key: "annotation-value"
+  labels:
+    example.com/label-key: "label-value"
+spec:
+  accessModes:
+    - ReadWriteOnce
+  resources:
+    requests:
+      storage: 10Gi
+```