dpgaspar commented on code in PR #27434:
URL: https://github.com/apache/superset/pull/27434#discussion_r1519817608


##########
docs/docs/installation/installing-superset-using-docker-compose.mdx:
##########
@@ -5,12 +5,33 @@ sidebar_position: 1
 version: 1
 ---
 
-## Installing Superset Locally Using Docker Compose
+## Using Docker Compose
 
 The fastest way to try Superset locally is using Docker and Docker Compose on 
a Linux or Mac OSX
 computer. Superset does not have official support for Windows, so we have 
provided a VM workaround
 below.
 
+It's **not** typical, nor recommended to use docker-compose to productionize an
+application like Superset. docker-compose should be used for local development
+or testing the app.
+
+**DO NOT USE THIS FOR PRODUCTION!**
+
+Note that there are 3 major ways we support to run docker-compose:
+1. **docker-compose.yml:** for interactive development, where we mount your 
local folder with the
+  frontend/backend files that you can edit and experience the changes you
+  make in the app in real time
+1. **docker-compose-non-dev.yml** where we just build a more immutable image 
based on the
+  local branch and get all the required images running. Changes in the local 
branch
+  at the time you fire this up will be reflected, but changes to the code
+  while `up` won't be reflected in the app
+1. **docker-compose-image-tag.yml** where we fetch an image from docker-hub 
say for the
+  `3.0.0` release for instance, and fire it up so you can try it. Here what's 
in
+  the local branch has no effects on what's running, we just fetch and run
+  pre-built images from docker-hub
+
+More on these two approaches after setting up the requirements for either.
+

Review Comment:
   nice! ^^^



-- 
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

Reply via email to