Comment on page
Architecture and Deployment
Kyso can be installed on private servers or cloud instance, keeping your company's knowledge secure.
Kyso is a Web Application organized as a set of services and applications packaged in containers prepared to be deployed and work together using a
kubernetescluster (the components could be deployed using other orchestration systems if required, but our current deployment system is focused on
The two main components of the system are:
NodeJSserver that implements the backend functionality using internal and external services and provides a REST API to access it.
kyso-front, the system's web user interface, developed using the
NextJSframework, does its work calling the relevant API methods on behalf of the user.
Other support services used are:
kyso-scs, module used to manage the reports storage and publication; it includes four sub-components that work together:
- an internal ssh server to manage report files (it is accessed only by the API, users don't have direct access to it).
- a web server that provides access to the files with access control (the access validation is managed by calling the API).
- a Java application used to index the content of the reports and add the relevant information to the search engine database.
- a Web server that allows us to run scripts with direct access to the filesystem for maintenance tasks and information retrieval.
elasticsearch, search engine used to search and index comments, discussions and reports uploaded to the platform.
mongodb, a database used to keep all the data related to the platform that is not inside the reports (i.e. configuration and user data, discussions and comments, etc.)
nats, a message oriented middleware used by the API to emit messages related to different events that can be consumed by specialised micro-services
onlyoffice-ds, online editor for text documents, spreadsheets, presentations, forms and PDF reader used to display office formats from the frontend
Additionally the platform supports the deployment of optional message consumers (
natsclients) that perform specialised tasks (send notifications using email or slack, display an activity feed, etc.)
Right now the recommended way of deploying Kyso is to use
kitt(Kyso Internal Tool of Tools), a command line tool that includes support to configure and deploy third party components (i.e.
elasticsearch, …) and our own services (
kyso-scs, …) on kubernetes clusters using
The tool is also capable of installing a cluster for testing purposes on a single Linux server (using
k3d) and install and configure additional services on it or an existing kubernetes cluster.