diff --git a/docs/k8s_apps/collabora.md b/docs/k8s_apps/collabora.md new file mode 100644 index 000000000..a3ad595cd --- /dev/null +++ b/docs/k8s_apps/collabora.md @@ -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: [] +``` diff --git a/docs/k8s_apps/nextcloud.md b/docs/k8s_apps/nextcloud.md index e5dd69111..d49b75613 100644 --- a/docs/k8s_apps/nextcloud.md +++ b/docs/k8s_apps/nextcloud.md @@ -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 @@ -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 @@ -70,6 +72,7 @@ apps: - `NEXTCLOUD_S3_BACKUP_ACCESS_KEY` - `NEXTCLOUD_S3_BACKUP_ACCESS_ID` - `NEXTCLOUD_RESTIC_REPO_PASSWORD` +- `COLLABORA_ONLINE_PASSWORD` ## Backups @@ -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 @@ -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 * * * @@ -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: "" diff --git a/mkdocs.yaml b/mkdocs.yaml index c11e7e5cd..a35c3491d 100644 --- a/mkdocs.yaml +++ b/mkdocs.yaml @@ -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