02b76d3f45
# [0.7.0](https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/compare/v0.6.0...v0.7.0) (2024-05-06) ### Bug Fixes * **ci:** Add debug option. Has to be supported by stage specific configuration containing: `debug.enabled: {{ env "DEBUG_ENABLED" | default false }}` ([3dc6484](3dc648421b)) * **element:** Provide the internal cluster domain to synapse web ([b9ac5ec](b9ac5ecf2d)) * **univention-management-stack:** Add the image configuration for NATS ([e9ec2f3](e9ec2f3a6e)) * **univention-management-stack:** Fix [#55](https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/issues/55), [#35](https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/issues/35) by updating chart "ums" to 0.11.2 and image "portal-listener" to 0.20.6; To update an existing installation you need to manually delete the `ums-portal-listener` stateful set before the update: `kubectl -n <your_namespace> delete statefulsets ums-portal-listener` ([2ad0270](2ad027082f)) * **univention-management-stack:** Migrate UDM-REST-API image to new Univention registry ([9be3b78](9be3b78761)) * **univention-management-stack:** Objectstore credentials ([d1bd43f](d1bd43fa95)) * **univention-management-stack:** Update Helm chart to 0.12.0 including required changes to openDesk Helmfile deployment. ([fefd2f6](fefd2f6cae)) * **univention-management-stack:** Use the NATS related image configuration ([cd22570](cd225703eb)) ### Features * **element:** Add support for Matrix federation ([36139b4](36139b42f1)) * **helmfile:** Introduce additional variables for mailDomain and synapseDomain ([e6fe2a7](e6fe2a7c18)) * **services:** Add opendesk-home service, which redirects on domain to portal ([c7e2172](c7e217208c))
openDesk Deployment Automation
- Overview
- Disclaimer
- Requirements
- Getting started
- Advanced customization
- Development
- Releases
- Components
- Feedback
- License
- Copyright
- Footnotes
Overview
openDesk is a Kubernetes based, open-source and cloud-native digital workplace suite provided by the "Projektgruppe für Aufbau ZenDiS" of Germany's Federal Ministry of the Interior.
openDesk currently features the following functional main components:
| Function | Functional Component | Component Version |
Upstream Documentation |
|---|---|---|---|
| Chat & collaboration | Element ft. Nordeck widgets | 1.11.59 | For the most recent release |
| Diagram editor | Cryptpad ft. diagrams.net | 5.6.0 | For the most recent release |
| File management | Nextcloud | 28.0.4 | Nextcloud 28 |
| Groupware | OX App Suite | 8.23 | Online documentation available from within the installed application; Additional resources |
| Knowledge management | XWiki | 15.10.8 | For the most recent release |
| Portal & IAM | Nubus | Product Preview1 | Univention's documentation website |
| Project management | OpenProject | 13.4.1 | For the most recent release |
| Videoconferencing | Jitsi | 2.0.8922 | For the most recent release |
| Weboffice | Collabora | 23.05.9.4.1 | Online documentation available from within the installed application; Additional resources |
While not all components are perfectly shaped for the execution inside containers, one of the project's objectives is to align the applications with best practises regarding container design and operations.
This documentation aims to give you all that is needed to set up your own instance of the openDesk.
Basic knowledge of Kubernetes and DevOps processes is required though.
Disclaimer
openDesk will face breaking changes in the near future without upgrade paths before technical release v1.0.0 is reached.
While most components support upgrades, major configuration or component changes may occur, therefore we recommend from scratch installations for now.
In the next months, we not only expect to integrate upstream updates of the functional components to include their most recent feature and security sets, but also to address operational topics like scalability for the openDesk platform.
Of course, further development also includes enhancing the documentation itself.
Requirements
⟶ Visit our detailed Requirements overview.
Getting started
⟶ Visit our detailed Getting started guide.
Advanced customization
Development
⟶ To understand the repository contents from a developer perspective please read the Development guide.
Releases
All technical releases are created using Semantic Versioning.
Gitlab provides an overview on the releases of this project.
Please find a list of the artefacts related to the release either in the source code archive attached to the release or in the files from the release's git-tag:
./helmfile/environments/default/images.yaml./helmfile/environments/default/charts.yaml
⟶ Visit our detailed Workflow docs.
Components
⟶ Visit our detailed Component docs.
Feedback
We love to get feedback from you!
Related to the deployment / contents of this repository, please use the issues within this project.
If you want to address other topics, please check the section "Rückmeldungen und Beteiligung" in the OVERVIEW.md of the openDesk Info Repository.
License
This project uses the following license: Apache-2.0
Copyright
Copyright (C) 2024 Bundesministerium des Innern und für Heimat, PG ZenDiS "Projektgruppe für Aufbau ZenDiS"
Footnotes
-
Nubus is the Cloud Portal and IAM from Univention. It is currently integrated as a product preview within openDesk therefore, not all resources like documentation and structured release notes are available, while the source code can already be found on Open CoDE. Please find updates regarding the Nubus at https://nubus.io. ↩︎