rusackas commented on code in PR #28481: URL: https://github.com/apache/superset/pull/28481#discussion_r1679790077
########## docs/docs/installation/architecture.mdx: ########## @@ -0,0 +1,67 @@ +--- +title: Architecture +hide_title: true +sidebar_position: 1 +version: 1 +--- + +import useBaseUrl from "@docusaurus/useBaseUrl"; + +# Architecture + +This page is meant to give new administrators an understanding of Superset's components. + +## Components + +A Superset installation is made up of these components: +1. The Superset application itself +2. A metadata database to store Superset's data about users, charts, dashboards, etc. +3. A caching layer (optional, but necessary for some features) +4. A worker & beat (optional, but necessary for some features) + +### Optional components and associated features + +The optional components above are necessary to enable these features: +- [Alerts and Reports](/docs/configuration/alerts-reports) +- [Caching](/docs/configuration/cache) +- [Async Queries](/docs/configuration/async-queries-celery/) +- [Dashboard Thumbnails](/docs/configuration/cache/#caching-thumbnails) + +If you install with Kubernetes or Docker Compose, all of these components will be created. + +However, installing from PyPI only creates the application itself. Users installing from PyPI will need to configure a caching layer, worker, and beat on their own if they wish to enable the above features. Configuration of those components for a PyPI install is not currently covered in this documentation. + +Here are further details on each component. + +### The Superset Application + +This is the core application. Superset operates like this: +- A user visits a chart or dashboard +- That triggers a SQL query to the data warehouse holding the underlying dataset +- The resulting data is served up in a data visualization Review Comment: ```suggestion - The resulting data is served up in a data visualization - The Superset application is comprised of the Python (Flask) backend application (server), API layer, and the React frontend, built via Webpack, and static assets needed for the application to work ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: notifications-unsubscr...@superset.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: notifications-unsubscr...@superset.apache.org For additional commands, e-mail: notifications-h...@superset.apache.org