Erwan Leboucher
7da0ef6e2b
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m1s
Checks / Prek / Check changed files (pull_request) Successful in 6s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 7s
Update flake hashes / update-flake-hashes (pull_request) Successful in 1m31s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 8m17s
Checks / Prek / Pre-commit & Formatting (push) Successful in 58s
Checks / Prek / Check changed files (push) Successful in 6s
Documentation / Build and Deploy Documentation (push) Successful in 10m32s
Release Docker Image / Build linux-amd64 (release) (push) Successful in 15m17s
Release Docker Image / Build linux-arm64 (release) (push) Successful in 15m2s
Release Docker Image / Create Multi-arch Release Manifest (push) Successful in 16s
Release Docker Image / Build linux-amd64 (max-perf) (push) Successful in 33m12s
Release Docker Image / Build linux-arm64 (max-perf) (push) Successful in 1h14m57s
Release Docker Image / Release Binaries (push) Has been skipped
Release Docker Image / Create Max-Perf Manifest (push) Successful in 18s
Release Docker Image / Mirror Images (push) Successful in 2m27s
Checks / Prek / Clippy and Cargo Tests (push) Successful in 8m21s
112 lines
3.8 KiB
Text
112 lines
3.8 KiB
Text
# Continuwuity for Kubernetes
|
|
|
|
Continuwuity doesn't support horizontal scalability or distributed loading
|
|
natively. However, a deployment in Kubernetes is very similar to the docker
|
|
setup. This is because Continuwuity can be fully configured using environment
|
|
variables. A sample StatefulSet is shared below. The only thing missing is
|
|
a PVC definition (named `continuwuity-data`) for the volume mounted to
|
|
the StatefulSet, an Ingress resources to point your webserver to the
|
|
Continuwuity Pods, and a Service resource (targeting `app.kubernetes.io/name: continuwuity`)
|
|
to glue the Ingress and Pod together.
|
|
|
|
Carefully go through the `env` section and add, change, and remove any env vars you like using the [Configuration reference](https://continuwuity.org/reference/config.html)
|
|
|
|
```yaml
|
|
apiVersion: apps/v1
|
|
kind: StatefulSet
|
|
metadata:
|
|
name: continuwuity
|
|
namespace: matrix
|
|
labels:
|
|
app.kubernetes.io/name: continuwuity
|
|
spec:
|
|
replicas: 1
|
|
serviceName: continuwuity
|
|
podManagementPolicy: Parallel
|
|
selector:
|
|
matchLabels:
|
|
app.kubernetes.io/name: continuwuity
|
|
template:
|
|
metadata:
|
|
labels:
|
|
app.kubernetes.io/name: continuwuity
|
|
spec:
|
|
securityContext:
|
|
sysctls:
|
|
- name: net.ipv4.ip_unprivileged_port_start
|
|
value: "0"
|
|
containers:
|
|
- name: continuwuity
|
|
# use a sha hash <3
|
|
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
|
command: ["/sbin/conduwuit"]
|
|
imagePullPolicy: IfNotPresent
|
|
ports:
|
|
- name: http
|
|
containerPort: 80
|
|
volumeMounts:
|
|
- mountPath: /data
|
|
name: data
|
|
subPath: data
|
|
securityContext:
|
|
capabilities:
|
|
add:
|
|
- NET_BIND_SERVICE
|
|
env:
|
|
- name: TOKIO_WORKER_THREADS
|
|
value: "2"
|
|
- name: CONTINUWUITY_SERVER_NAME
|
|
value: "example.com"
|
|
- name: CONTINUWUITY_DATABASE_PATH
|
|
value: "/data/db"
|
|
- name: CONTINUWUITY_DATABASE_BACKEND
|
|
value: "rocksdb"
|
|
- name: CONTINUWUITY_PORT
|
|
value: "80"
|
|
- name: CONTINUWUITY_MAX_REQUEST_SIZE
|
|
value: "20000000"
|
|
- name: CONTINUWUITY_ALLOW_FEDERATION
|
|
value: "true"
|
|
- name: CONTINUWUITY_TRUSTED_SERVERS
|
|
value: '["matrix.org"]'
|
|
- name: CONTINUWUITY_ADDRESS
|
|
value: "0.0.0.0"
|
|
- name: CONTINUWUITY_ROCKSDB_PARALLELISM_THREADS
|
|
value: "1"
|
|
- name: CONTINUWUITY_WELL_KNOWN__SERVER
|
|
value: "matrix.example.com:443"
|
|
- name: CONTINUWUITY_WELL_KNOWN__CLIENT
|
|
value: "https://matrix.example.com"
|
|
- name: CONTINUWUITY_ALLOW_REGISTRATION
|
|
value: "false"
|
|
- name: CONTINUWUITY_LOG
|
|
value: info
|
|
readinessProbe:
|
|
httpGet:
|
|
path: /_matrix/federation/v1/version
|
|
port: http
|
|
periodSeconds: 4
|
|
failureThreshold: 5
|
|
resources:
|
|
# Continuwuity might use quite some RAM :3
|
|
requests:
|
|
cpu: "2"
|
|
memory: "512Mi"
|
|
limits:
|
|
cpu: "4"
|
|
memory: "2048Mi"
|
|
volumes:
|
|
- name: data
|
|
persistentVolumeClaim:
|
|
claimName: continuwuity-data
|
|
```
|
|
|
|
---
|
|
|
|
Apart from manually configuring the containers,
|
|
[a community-maintained Helm Chart is available here to run
|
|
conduwuit on Kubernetes](https://gitlab.cronce.io/charts/conduwuit)
|
|
|
|
This should be compatible with Continuwuity, but you will need to change the image reference.
|
|
|
|
If changes need to be made, please reach out to the maintainer, as this is not maintained or controlled by the Continuwuity maintainers.
|