Skip to content

Commit

Permalink
add collabora online docs
Browse files Browse the repository at this point in the history
  • Loading branch information
jessebot committed Dec 15, 2024
1 parent 1aa1b1d commit 19315cc
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 0 deletions.
52 changes: 52 additions & 0 deletions docs/k8s_apps/collabora.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
[Collabora Online](https://www.collaboraonline.com/) is a powerful online document editing suite which you can integrate into your own infrastructure or access via one of our trusted hosting partners.

You can use this app to deploy collabora online separately from nextcloud, or you can deploy it as part of the nextcloud app of apps. If deploying as part of nextcloud, leave this app disabled.

## Example config

```yaml
apps:
collabora_online:
enabled: false
description: |
[link=https://www.collaboraonline.com/]Collabora Online[/link] is a powerful online document editing suite which you can integrate into your own infrastructure or access via one of our trusted hosting partners.
You can use this app to deploy collabora online separately from nextcloud,
or you can deploy it as part of the nextcloud app of apps. If deploying as part
of nextcloud, leave this app disabled.
you can set an optional admin password with this variable:
- COLLABORA_ONLINE_PASSWORD
# Initialization of the app through smol-k8s-lab
init:
enabled: false
values:
admin_user: admin
password:
value_from:
# you can change this to any env var
env: COLLABORA_ONLINE_PASSWORD
argo:
# git repo to install the Argo CD app from
repo: https://github.com/small-hack/argocd-apps
# path in the argo repo to point to. Trailing slash very important!
path: collabora_online/app_of_apps/
# either the branch or tag to point at in the argo repo above
revision: main
# kubernetes cluster to install the k8s app into, defaults to Argo CD default
cluster: https://kubernetes.default.svc
# namespace to install the k8s app in
namespace: collabora-online
# recurse directories in the provided git repo
directory_recursion: false
# secret keys to provide for the Argo CD Appset secret plugin, none by default
secret_keys: {}
# source repos for Argo CD App Project (in addition to app.argo.repo)
project:
name: collabora-online
source_repos:
- https://collaboraonline.github.io/online
destination:
# automatically includes the app's namespace and argocd's namespace
namespaces: []
```
11 changes: 11 additions & 0 deletions docs/k8s_apps/nextcloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Part of the `smol-k8s-lab` init process is that we will put the following into y
- PostgreSQL credentials
- s3 credentials
- OIDC credentials
- Collabora credentials

## Required Values

Expand All @@ -30,6 +31,7 @@ To use the default `smol-k8s-lab` Argo CD Application, you'll need to provide on
- `admin_user`
- `smtp_user`
- `smtp_host`
- `collabora_user`

### Required ApplicationSet Values

Expand Down Expand Up @@ -70,6 +72,7 @@ apps:
- `NEXTCLOUD_S3_BACKUP_ACCESS_KEY`
- `NEXTCLOUD_S3_BACKUP_ACCESS_ID`
- `NEXTCLOUD_RESTIC_REPO_PASSWORD`
- `COLLABORA_ONLINE_PASSWORD`


## Backups
Expand Down Expand Up @@ -148,6 +151,7 @@ apps:
- NEXTCLOUD_S3_BACKUP_ACCESS_KEY
- NEXTCLOUD_S3_BACKUP_ACCESS_ID
- NEXTCLOUD_RESTIC_REPO_PASSWORD
- COLLABORA_ONLINE_PASSWORD
Note: smol-k8s-lab is not affiliated with Nextcloud GmbH. This is a community-supported-only install method.
# initialize the app by setting up new k8s secrets and/or Bitwarden items
Expand All @@ -167,6 +171,11 @@ apps:
smtp_password:
value_from:
env: NEXTCLOUD_SMTP_PASSWORD
collabora_user: admin
collabora_password:
value_from:
# you can change this to any env var
env: COLLABORA_ONLINE_PASSWORD
backups:
# cronjob syntax schedule to run nextcloud pvc backups
pvc_schedule: 10 0 * * *
Expand Down Expand Up @@ -195,6 +204,8 @@ apps:
secret_keys:
# the FQDN that you want to host nextcloud on
hostname: "cloud.cooldogs.net"
# host name for collabora online
collabora_hostname: "collabora.domain.com"
# you can delete these if you're not using tolerations/affinity
toleration_key: ""
toleration_operator: ""
Expand Down
1 change: 1 addition & 0 deletions mkdocs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,7 @@ nav:
- Appset Secret Plugin: k8s_apps/appset-secret-plugin.md
- Cert Manager: k8s_apps/cert_manager.md
- CloudNative Postgress Operator: k8s_apps/cnpg_operator.md
- Collabora Online: k8s_apps/collabora.md
- Core DNS: k8s_apps/core_dns.md
- External Secrets:
- External Secrets Operator: k8s_apps/external-secrets-operator.md
Expand Down

0 comments on commit 19315cc

Please sign in to comment.