Skip to content

Commit f601e5d

Browse files
[distribution] Update README for 2.37.0: Redis removal, upgrade hook fallback, and Kubernetes version fix (INST-21313)
1 parent 22f79fd commit f601e5d

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

stable/distribution/README.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,15 @@
33
**IMPORTANT!** Our Helm Chart docs have moved to our main documentation site. Below you will find the basic instructions for installing Distribution. For all other information, refer to [Installing Distribution](https://jfrog.com/help/r/jfrog-installation-setup-documentation/installing-distribution).
44

55
## Prerequisites Details
6-
* Kubernetes 1.19+
6+
* Kubernetes 1.23+
77

88
## Chart Details
99
This chart does the following:
1010
* Deploy PostgreSQL database
1111
* Deploy distribution
1212

13+
> **Note:** From Distribution 2.37.0, Redis is no longer included in this chart. For more information, see the [Distribution 2.37.0 release notes](https://docs.jfrog.com/releases/docs/distribution-release-notes#distribution-2370).
14+
1315
## Requirements
1416
- A running Kubernetes cluster
1517
- Dynamic storage provisioning enabled
@@ -46,6 +48,18 @@ For small configurations :
4648
helm upgrade --install distribution jfrog/distribution -f sizing/distribution-small.yaml --namespace distribution --create-namespace
4749
```
4850

51+
## Upgrading to Distribution 2.37.0 or Later
52+
53+
From Distribution 2.37.0, Redis has been removed from the chart. For more details, please refer to the [Distribution 2.37.0 release notes](https://docs.jfrog.com/releases/docs/distribution-release-notes#distribution-2370).
54+
55+
When upgrading from a version prior to 2.37.0, a pre-upgrade webhook (`distribution-upgrade-hook`) is automatically executed. This webhook handles the migration by deleting the existing StatefulSet with `--cascade=orphan` (preserving running pods) to allow the updated spec — which no longer includes Redis — to be applied cleanly.
56+
57+
In most cases, no manual intervention is required. However, if the hook job fails (for example, due to RBAC permissions or image pull issues), you may need to manually delete the StatefulSet before retrying the upgrade:
58+
59+
```bash
60+
kubectl delete statefulset <release-name>-distribution --cascade=orphan -n <namespace>
61+
```
62+
4963
## Uninstalling Distribution
5064

5165
**IMPORTANT:** Uninstalling distribution using the commands below will also delete your data volumes and you will lose all of your data. You must back up all this information before deletion.

0 commit comments

Comments
 (0)