techdocsmith commented on code in PR #14459:
URL: https://github.com/apache/druid/pull/14459#discussion_r1258894405
##########
docs/tutorials/tutorial-jupyter-docker.md:
##########
@@ -85,6 +93,25 @@ In the same directory as `docker-compose.yaml` and
`environment`, start the appl
DRUID_VERSION={{DRUIDVERSION}} docker compose --profile all-services up -d
```
+### Start Kafka and Jupyter
+
+If you already have Druid running externally, such as an existing cluster or a
dedicated infrastructure for Druid, you can run the Docker containers for Kafka
and Jupyter only.
+
+In the same directory as `docker-compose.yaml` and `environment`, start the
application:
+
+```bash
+DRUID_VERSION={{DRUIDVERSION}} docker compose --profile kafka-jupyter up -d
+```
+
+Please note that if you have an external Druid instance running on a different
machine than the one hosting the Docker Compose environment, you will need to
change the `host` variable in the notebook tutorial to the hostname or address
of the machine where Druid is running. This will establish a connection with
the external Druid cluster.
Review Comment:
```suggestion
If you have an external Druid instance running on a different machine than
the one hosting the Docker Compose environment, change the `host` variable in
the notebook tutorial to the hostname or address of the machine where Druid is
running.
```
avoid "please" :D ; avoid future tense; last sentence is not necessary
##########
docs/tutorials/tutorial-jupyter-docker.md:
##########
@@ -193,9 +220,30 @@ as well as the [Python client for
Druid](tutorial-jupyter-index.md#python-api-fo
You should now be able to access and complete the tutorials.
+## Tutorial setup for ARM-based devices
+
+For ARM-based devices, follow this setup to start Druid externally, while
keeping Kafka and Jupyter within the Docker Compose environment:
+
+1. Start Druid using the `start-druid` script. You can follow [Quickstart
(local)](./index.md) instructions. The tutorials
+ assume that you are using the quickstart, so no authentication or
authorization is expected unless explicitly mentioned.
+2. Start either Kafka and Jupyter or only Jupyter using the following commands
in the same directory as `docker-compose.yaml` and `environment`:
+
+ ```bash
+ # Start Kafka and Jupyter
+ DRUID_VERSION={{DRUIDVERSION}} docker compose --profile kafka-jupyter up -d
+
+ # Start only Jupyter
+ docker compose --profile jupyter up -d
+ ```
Review Comment:
```suggestion
```bash
# Start only Jupyter
docker compose --profile jupyter up -d
# Start Kafka and Jupyter
DRUID_VERSION={{DRUIDVERSION}} docker compose --profile kafka-jupyter up
-d
```
```
##########
docs/tutorials/tutorial-jupyter-docker.md:
##########
@@ -193,9 +220,30 @@ as well as the [Python client for
Druid](tutorial-jupyter-index.md#python-api-fo
You should now be able to access and complete the tutorials.
+## Tutorial setup for ARM-based devices
+
+For ARM-based devices, follow this setup to start Druid externally, while
keeping Kafka and Jupyter within the Docker Compose environment:
+
+1. Start Druid using the `start-druid` script. You can follow [Quickstart
(local)](./index.md) instructions. The tutorials
+ assume that you are using the quickstart, so no authentication or
authorization is expected unless explicitly mentioned.
+2. Start either Kafka and Jupyter or only Jupyter using the following commands
in the same directory as `docker-compose.yaml` and `environment`:
Review Comment:
```suggestion
2. Start either Jupyter only or Jupyter and Kakfa using the following
commands in the same directory as `docker-compose.yaml` and `environment`:
```
Jupyter only is a more frequent use case
--
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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
