Skip to content

Commit

Permalink
chore(docs): improve README for ingress
Browse files Browse the repository at this point in the history
Signed-off-by: WrenIX <[email protected]>
  • Loading branch information
wrenix committed Aug 11, 2024
1 parent 0722386 commit 52ac2ea
Show file tree
Hide file tree
Showing 4 changed files with 36 additions and 4 deletions.
2 changes: 1 addition & 1 deletion charts/nextcloud/Chart.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
apiVersion: v2
name: nextcloud
version: 5.5.2
version: 5.5.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:
Expand Down
33 changes: 33 additions & 0 deletions charts/nextcloud/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ helm install my-release nextcloud/nextcloud
* [Installing the Chart](#installing-the-chart)
* [Uninstalling the Chart](#uninstalling-the-chart)
* [Configuration](#configuration)
* [Ingress-Controller](#ingress)
* [Database Configurations](#database-configurations)
* [Object Storage as Primary Storage Configuration](#object-storage-as-primary-storage-configuration)
* [Persistence Configurations](#persistence-configurations)
Expand Down Expand Up @@ -204,6 +205,38 @@ The following table lists the configurable parameters of the nextcloud chart and
| `podAnnotations` | Annotations to be added at 'pod' level | not set |
| `dnsConfig` | Custom dnsConfig for nextcloud containers | `{}` |

### Ingress
#### Ingress Sticky-Sessions

For loadbalance over multiple Pods, it is useful to configure sticky session.

##### NGINX Ingress-Controller
To enable sticky sessions on that ingress controller you could set the following values in this helm-chart.
For more information take a look in the [ingress-controller documentation](https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#session-affinity)
```yaml
ingress:
annotations:
nginx.ingress.kubernetes.io/affinity: cookie
```
##### Traefik Ingress-Controller
To enable sticky sessions on that ingress controller you could set the following values in this helm-chart.
For more information take a look in the [ingress-controller documentation](https://doc.traefik.io/traefik/routing/providers/kubernetes-ingress/#on-service)
```yaml
service:
annotations:
traefik.ingress.kubernetes.io/service.sticky.cookie: "true"
```
##### HAProxy Ingress-Controller (Community-Version)
To enable sticky sessions on that ingress controller you could set the following values in this helm-chart.
For more infromation take a look in the [ingress-controller documentation](https://haproxy-ingress.github.io/docs/configuration/keys/#affinity)
```yaml
ingress:
annotations:
haproxy-ingress.github.io/affinity: cookie
```
### Database Configurations
By default, nextcloud will use a SQLite database. This is not recommended for production, but is enabled by default for testing purposes. When you are done testing, please set `internalDatabase.enabled` to `false`, and configure the `externalDatabase` parameters below.

Expand Down
2 changes: 1 addition & 1 deletion charts/nextcloud/templates/service.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -38,4 +38,4 @@ spec:
selector:
app.kubernetes.io/name: {{ include "nextcloud.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/component: app
app.kubernetes.io/component: app
3 changes: 1 addition & 2 deletions charts/nextcloud/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -501,9 +501,8 @@ service:
port: 8080
loadBalancerIP: ""
nodePort: nil
# -- use additional annotation on service for nextcloud
annotations: {}
## Insert your annotations such as below
# test/test: pumuckel

## Enable persistence using Persistent Volume Claims
## ref: http://kubernetes.io/docs/user-guide/persistent-volumes/
Expand Down

0 comments on commit 52ac2ea

Please sign in to comment.