diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 11c64ff2..9da8f707 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -19,6 +19,13 @@ Then, please make sure you follow the [pull request template](.github/pull_reque ![screenshot of the allow edits by maintainers check box to the left of the Create pull request button on GitHub](https://github.com/nextcloud/helm/assets/2389292/3a8044a9-583d-496a-b3d2-4dd699c56ed4) +## Upgrades + +If upgrading a subchart, such as PostgreSQL or MariaDB, or upgrading the `appVersion` in `./charts/nextcloud/Chart.yaml`, please never upgrade more than one major version at a time and please bump the helm chart `version` in `./charts/nextcloud/Chart.yaml` in line with semver. For example, if you bump the `appVersion` from `29.0.4` to `29.1.0`, you need to also bump the `version` from `5.3.0` to `5.4.0`. + +Additionally, when upgrading Nextcloud versions, upgrade to the latest minor version of the major version first, before upgrading to the next major version. Learn more about upgrading Nexcloud via the [upgrade docs](https://docs.nextcloud.com/server/latest/admin_manual/maintenance/upgrade.html#approaching-upgrades). + +If upgrading a subchart, please also provide documentation in the PR for how users can upgrade an external service locally. # Issues diff --git a/charts/nextcloud/Chart.yaml b/charts/nextcloud/Chart.yaml index f79c4b29..89a2ae35 100644 --- a/charts/nextcloud/Chart.yaml +++ b/charts/nextcloud/Chart.yaml @@ -1,6 +1,6 @@ apiVersion: v2 name: nextcloud -version: 5.3.2 +version: 5.3.3 appVersion: 29.0.4 description: A file sharing server that puts the control and security of your own data back into your hands. keywords: diff --git a/charts/nextcloud/README.md b/charts/nextcloud/README.md index d50338d5..031617e9 100644 --- a/charts/nextcloud/README.md +++ b/charts/nextcloud/README.md @@ -549,7 +549,7 @@ kubectl exec $NEXTCLOUD_POD -- su -s /bin/sh www-data -c "php occ recognize:down Check out the [official Nextcloud backup docs](https://docs.nextcloud.com/server/latest/admin_manual/maintenance/backup.html). For your files, if you're using persistent volumes, and you'd like to back up to s3 backed storage (such as minio), consider using [k8up](https://github.com/k8up-io/k8up) or [velero](https://github.com/vmware-tanzu/velero). # Upgrades -Since this chart utilizes the [nextcloud/docker](https://github.com/nextcloud/docker) image, provided you are using persistent volumes, [upgrades of your Nextcloud server are handled automatically](https://github.com/nextcloud/docker#update-to-a-newer-version) from one version to the next, however, you can only upgrade one major version at a time. For example, if you want to upgrade from version `25` to `27`, you will have to upgrade from version `25` to `26`, then from `26` to `27`. Since our docker tag is set via the [`appVersion` in `Chart.yaml`](https://github.com/nextcloud/helm/blob/main/charts/nextcloud/Chart.yaml#L4), you'll need to make sure you gradually upgrade the helm chart if you have missed serveral app versions. +Since this chart utilizes the [nextcloud/docker](https://github.com/nextcloud/docker) image, provided you are using persistent volumes, [upgrades of your Nextcloud server are handled automatically](https://github.com/nextcloud/docker#update-to-a-newer-version) from one version to the next, however, you can only upgrade one major version at a time. For example, if you want to upgrade from version `25` to `27`, you will have to upgrade from version `25` to `26`, then from `26` to `27`. Since our docker tag is set via the [`appVersion` in `Chart.yaml`](https://github.com/nextcloud/helm/blob/main/charts/nextcloud/Chart.yaml#L4), you'll need to make sure you gradually upgrade the helm chart if you have missed serveral app versions. It's also good to first upgrade to the latest minor version of a major version before upgrading to the next major version. Learn more about upgrades in the [upgrade docs](https://docs.nextcloud.com/server/latest/admin_manual/maintenance/upgrade.html#approaching-upgrades). ⚠️ *Before Upgrading Nextcloud or the attached database, always make sure you take [backups](#backups)!* diff --git a/charts/nextcloud/values.yaml b/charts/nextcloud/values.yaml index 4e5eebcb..c483b247 100644 --- a/charts/nextcloud/values.yaml +++ b/charts/nextcloud/values.yaml @@ -5,7 +5,11 @@ image: repository: nextcloud flavor: apache # default is generated by flavor and appVersion - tag: + # NOTE: Remember if manually setting this values, when upgrading Nextcloud + # versions, upgrade to the latest minor version of for your current major version + # before upgrading to the next major version and NEVER upgrade more than *one* + # major version at a time. + tag: "" pullPolicy: IfNotPresent # pullSecrets: # - myRegistrKeySecretName