all-in-one/nextcloud-aio-helm-chart
Simon L 4e13dc5fca
Merge pull request #2391 from nextcloud/enh/noid/helm-chart
add further docs on the helm-chart
2023-04-22 11:48:47 +02:00
..
templates Helm Chart updates 2023-04-22 09:45:08 +00:00
Chart.yaml Helm Chart updates 2023-04-22 09:45:08 +00:00
readme.md Mark you need to know what you are doing as bold 2023-04-19 11:31:10 +02:00
update-helm.sh adut apache_max_size for helm-chart to be a string 2023-04-18 23:44:07 +02:00
values.yaml adut apache_max_size for helm-chart to be a string 2023-04-18 23:44:07 +02:00

Nextcloud AIO Helm-chart

You can run the containers that are build for AIO with Kubernetes using this Helm chart. This comes with a few downsides, that are discussed below.

Advantages

  • You can run it without a container having access to the docker socket
  • You can run the containers with Kubernetes

Disadvantages

  • You lose the AIO interface
  • You lose update notifications and automatic updates
  • You lose all AIO backup and restore features
  • You need to know what you are doing
  • For updating, you need to strictly follow the at the bottom described update routine
  • You need to monitor yourself if the volumes have enough free space and increase them if they don't by adjusting their size in values.yaml
  • Probably more

How to use this?

First download this file: https://raw.githubusercontent.com/nextcloud/all-in-one/main/nextcloud-aio-helm-chart/values.yaml and adjust at least all values marked with # TODO!

Then run:

helm repo add nextcloud-aio https://nextcloud.github.io/all-in-one/
helm install my-release nextcloud-aio/nextcloud-aio-helm-chart -f values.yaml

And after a while, everything should be set up.

How to update?

Since the values of this helm chart may change in the future, it is highly recommended to strictly follow the following procedure whenever you want to upgrade it.

  1. Stop all running pods
  2. Back up all volumes that got created by the Helm chart and the values.yaml file
  3. Run helm repo update nextcloud-aio in order to get the updated yaml files from the repository
  4. Now download the updated values.yaml file from https://raw.githubusercontent.com/nextcloud/all-in-one/main/nextcloud-aio-helm-chart/values.yaml and compare that with the one that you currently have locally. Look for variables that changed or got added. You can use the diff command to compare them.
  5. After the file update was successful, simply run helm install my-release nextcloud-aio/nextcloud-aio-helm-chart -f values.yaml to update to the new version.