docs: update readme to v1 changes (#30)
All checks were successful
continuous-integration/drone/push Build is passing
All checks were successful
continuous-integration/drone/push Build is passing
Co-authored-by: xeruf <27jf@pm.me> Reviewed-on: #30 Reviewed-by: konrad <k@knt.li> Co-authored-by: xeruf <git@jfischer.org> Co-committed-by: xeruf <git@jfischer.org>
This commit is contained in:
parent
2bec3682f4
commit
758bf4bbc8
25
README.md
25
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
|
||||
|
16
values.yaml
16
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
|
||||
|
Loading…
x
Reference in New Issue
Block a user