From a58a50d6488b6c85f8d5fc65788a6ea924824e52 Mon Sep 17 00:00:00 2001 From: xeruf <27jf@pm.me> Date: Wed, 29 Jan 2025 14:35:18 +0100 Subject: [PATCH] docs: update readme to v1 changes --- README.md | 25 ++++++++++++------------- values.yaml | 16 +++++++++------- 2 files changed, 21 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 5dffd64..4c14b81 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,37 @@ # Vikunja Helm Chart This Helm Chart deploys the [Vikunja](https://hub.docker.com/r/vikunja/vikunja) container -in addition to other Kubernetes resources to quickly create a full-featured Vikunja deployment. +in addition to other Kubernetes resources for a full-featured Vikunja deployment. This includes Bitnami's [PostgreSQL](https://github.com/bitnami/charts/tree/main/bitnami/postgresql) and [Redis](https://github.com/bitnami/charts/tree/main/bitnami/redis) as subcharts if you want, so Vikunja can use them as database and cache respectively. -See https://artifacthub.io/packages/helm/vikunja/vikunja for version information -and installation instructions. +See https://artifacthub.io/packages/helm/vikunja/vikunja +for version information and installation instructions. ## Upgrading to v1 Both Vikunja containers got merged into one with Vikunja version 0.23. A separate `frontend` configuration is now obsolete, so deleting that and renaming the key `api` to `vikunja` -should mostly "just work". -The only other major change is the `configMaps.config` key -which was changed to `api-config` to continuously reflect -that it only applies to the API. -The Configmap name in the cluster thus stays the same. +should "just work". +The only other major change is that the `configMaps.config` key was renamed to `api-config` +to highlight again that it only applies to the API. +The Configmap name in the cluster stays the same. ## Quickstart Define ingress settings according to your controller to access the application. -You can configure Vikunja API options as yaml under `vikunja.configMaps.config.data.config.yml`: +You can configure Vikunja API options as yaml under `vikunja.configMaps.api-config.data.config.yml`: https://vikunja.io/docs/config-options -For example, you can disable registration (if you do not with to allow others to register on your Vikunja), by providing the following values in your `values.yaml`: +For example, you can disable registration (if you do not with to allow others to register on your Vikunja), +by providing the following values in your `values.yaml`: ```yaml vikunja: configMaps: - config: + api-config: enabled: true data: config.yml: @@ -51,7 +51,7 @@ You can still create new users by executing the following command in the `vikunj To effectively run multiple replicas of the API, make sure to set up the redis cache as well -by setting `vikunja.configMaps.config.data.config.yml.keyvalue.type` to `redis`, +by setting `vikunja.configMaps.api-config.data.config.yml.keyvalue.type` to `redis`, configuring the redis subchart (see [values.yaml](./values.yaml#L119)) and the connection [in Vikunja](https://vikunja.io/docs/config-options/#redis) @@ -147,7 +147,6 @@ stringData: key1: value1 key2: value2 key3: value3 - ``` ### Modifying Deployed Resources diff --git a/values.yaml b/values.yaml index 01c5503..0a1729d 100644 --- a/values.yaml +++ b/values.yaml @@ -14,13 +14,13 @@ vikunja: #tag: "latest" #pullPolicy: Always persistence: - # This is your Vikunja data will live, you can either let - # the chart create a new PVC for you or provide an existing one. + # This is where your Vikunja data lives, + # provide an existing PVC or let one be autocreated data: enabled: true # existingClaim: # your-claim accessMode: ReadWriteOnce - size: 10Gi + size: 2Gi mountPath: /app/vikunja/files # storageClass: storage-class ingress: @@ -42,12 +42,14 @@ vikunja: data: config.yml: | typesense: - # Typesense will only work if it is enabled below (typesense.enabled). - url: "{{ printf "%s-typesense" .Release.Name }}:8108" + # These configuration values will automatically apply + # if the integrated Typesense is enabled below (typesense.enabled) + url: "http://{{ printf "%s-typesense" .Release.Name }}:8108" apiKey: "{{ .Values.typesense.env.TYPESENSE_API_KEY }}" redis: - # Redis will only work if it is enabled below (redis.enabled). - host: "{{ printf "%s-redis-master" .Release.Name }}:6379" + # These configuration values will automatically apply + # if the integrated Redis is enabled below (redis.enabled) + host: "http://{{ printf "%s-redis-master" .Release.Name }}:6379" db: "{{ .Release.Name }}" env: # To utilize a secret in the environment variables, you can do something like the following: https://github.com/bjw-s/helm-charts/blob/a081de53024d8328d1ae9ff7e4f6bc500b0f3a29/charts/library/common/values.yaml#L141-L145 -- 2.47.2