Add known issue for longhorn oversized volumes in v1.4.3

Harvester v1.4.3 updates Longhorn to v1.7.3, which has a problem with
oversized volumes being marked "Not Ready" and unable to be deleted.
I've added a note about this to the upgrade docs.

This issue is also present in Harvester v1.5.0, and has already been
documented, but that workaround refers to "/webhooks/0/rules/17", which
doesn't work for LH v1.7.3 (it's rule 14 in that case), so I've updated
the workaround to be a bit more generic and not depend on a specific
rule index.

Signed-off-by: Tim Serong <[email protected]>

Author: tserong

docs/upgrade/v1-4-1-to-v1-4-3.md

@@ -108,3 +108,38 @@ To fix the issue, perform any of the following actions:
 
 Related issues:
 - [[BUG] AirGap Upgrades Seem Blocked with Fluentbit/FluentD](https://github.com/harvester/harvester/issues/7955)
+
+### 2. Oversized Volumes
+
+In Harvester v1.4.3, which uses Longhorn v1.7.3, oversized volumes (for example, 999999 Gi in size) are marked **Not Ready** and cannot be deleted.
+
+To resolve this issue, perform the following steps:
+
+1. Temporarily remove the PVC webhook rule.
+
+   ```bash
+   RULE_INDEX=$(kubectl get \
+     validatingwebhookconfiguration longhorn-webhook-validator -o json \
+     | jq '.webhooks[0].rules | map(.resources[0] == "persistentvolumeclaims") | index(true)')
+   
+   kubectl patch validatingwebhookconfiguration longhorn-webhook-validator \
+     --type='json' \
+     -p="[{'op': 'remove', 'path': '/webhooks/0/rules/$RULE_INDEX'}]"
+   ```
+
+1. Wait for the related PVC to be deleted.
+
+1. Restore the PVC webhook rule to re-enable validation.
+
+   ```bash
+   kubectl patch validatingwebhookconfiguration longhorn-webhook-validator \
+     --type='json' \
+     -p='[{"op": "add", "path": "/webhooks/0/rules/-", "value": {"apiGroups":[""],"apiVersions":["v1"],"operations":["UPDATE"],"resources":["persistentvolumeclaims"],"scope":"Namespaced"}}]'
+   ```
+
+The issue will be addressed in Longhorn v1.8.2, which will likely be included in Harvester v1.5.1.
+
+Related issues:
+- Harvester: [Issue #8096](https://github.com/harvester/harvester/issues/8096)
+- Longhorn: [Issue #10741](https://github.com/longhorn/longhorn/issues/10741)
+

docs/volume/create-volume.md

@@ -38,9 +38,13 @@ To resolve this issue, perform the following steps:
 1. Temporarily remove the PVC webhook rule.
 
    ```bash
+   RULE_INDEX=$(kubectl get \
+     validatingwebhookconfiguration longhorn-webhook-validator -o json \
+     | jq '.webhooks[0].rules | map(.resources[0] == "persistentvolumeclaims") | index(true)')
+   
    kubectl patch validatingwebhookconfiguration longhorn-webhook-validator \
      --type='json' \
-     -p='[{"op": "remove", "path": "/webhooks/0/rules/17"}]'
+     -p="[{'op': 'remove', 'path': '/webhooks/0/rules/$RULE_INDEX'}]"
    ```
 
 1. Wait for the related PVC to be deleted.

versioned_docs/version-v1.4/volume/create-volume.md

@@ -29,6 +29,40 @@ description: Create a volume from the Volume page.
 
 ![create-empty-volume](/img/v1.2/volume/create-empty-volume.png)
 
+### Oversized Volumes
+
+In Harvester v1.4.3, which uses Longhorn v1.7.3, oversized volumes (for example, 999999 Gi in size) are marked **Not Ready** and cannot be deleted.
+
+To resolve this issue, perform the following steps:
+
+1. Temporarily remove the PVC webhook rule.
+
+   ```bash
+   RULE_INDEX=$(kubectl get \
+     validatingwebhookconfiguration longhorn-webhook-validator -o json \
+     | jq '.webhooks[0].rules | map(.resources[0] == "persistentvolumeclaims") | index(true)')
+   
+   kubectl patch validatingwebhookconfiguration longhorn-webhook-validator \
+     --type='json' \
+     -p="[{'op': 'remove', 'path': '/webhooks/0/rules/$RULE_INDEX'}]"
+   ```
+
+1. Wait for the related PVC to be deleted.
+
+1. Restore the PVC webhook rule to re-enable validation.
+
+   ```bash
+   kubectl patch validatingwebhookconfiguration longhorn-webhook-validator \
+     --type='json' \
+     -p='[{"op": "add", "path": "/webhooks/0/rules/-", "value": {"apiGroups":[""],"apiVersions":["v1"],"operations":["UPDATE"],"resources":["persistentvolumeclaims"],"scope":"Namespaced"}}]'
+   ```
+
+The issue will be addressed in Longhorn v1.8.2, which will likely be included in Harvester v1.5.1.
+
+Related issues:
+- Harvester: [Issue #8096](https://github.com/harvester/harvester/issues/8096)
+- Longhorn: [Issue #10741](https://github.com/longhorn/longhorn/issues/10741)
+
 </TabItem>
 <TabItem value="api" label="API">
 

versioned_docs/version-v1.5/volume/create-volume.md

@@ -38,9 +38,13 @@ To resolve this issue, perform the following steps:
 1. Temporarily remove the PVC webhook rule.
 
    ```bash
+   RULE_INDEX=$(kubectl get \
+     validatingwebhookconfiguration longhorn-webhook-validator -o json \
+     | jq '.webhooks[0].rules | map(.resources[0] == "persistentvolumeclaims") | index(true)')
+   
    kubectl patch validatingwebhookconfiguration longhorn-webhook-validator \
      --type='json' \
-     -p='[{"op": "remove", "path": "/webhooks/0/rules/17"}]'
+     -p="[{'op': 'remove', 'path': '/webhooks/0/rules/$RULE_INDEX'}]"
    ```
 
 1. Wait for the related PVC to be deleted.