DOCSP-25538: Add platform to Docker commands (#31)

* DOCSP-25538: Add platform to Docker commands

Author: Chris Cho

source/includes/tutorials/robwma-m1-arch.txt

@@ -0,0 +1,7 @@
+.. note::
+
+   If you are running an Apple M1 CPU, you need to specify the
+   ``--platform='linux/arm64'`` option when running the command to create
+   the tutorial Docker container. Select the :guilabel:`Apple M1 Processors` 
+   tab to see the full command.
+

source/tutorials/explore-change-streams.txt

@@ -27,24 +27,42 @@ Explore Change Streams
 
    .. step:: Connect to the Docker Container
 
+      .. include:: /includes/tutorials/robwma-m1-arch.txt
+
       Create two interactive shell sessions on the tutorial Docker
       Container, each in a separate window.
 
-      .. code-block:: bash
-         :copyable: true
-         :caption: This command starts an interactive shell called ChangeStreamShell1
+      .. tabs::
 
-         docker run --rm --name ChangeStreamShell1 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
 
-      .. code-block:: bash
-         :copyable: true
-         :caption: This command starts an interactive shell called ChangeStreamShell2
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called ChangeStreamShell1
+
+               docker run --rm --name ChangeStreamShell1 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called ChangeStreamShell2
+
+               docker run --rm --name ChangeStreamShell2 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called ChangeStreamShell1
+
+               docker run --platform='linux/arm64' --rm --name ChangeStreamShell1 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called ChangeStreamShell2
 
-         docker run --rm --name ChangeStreamShell2 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+               docker run --platform='linux/arm64' --rm --name ChangeStreamShell2 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
    .. step:: Open a Change Stream
 
-      In **ChangeStreamShell1**, create a Python script to open a change 
+      In **ChangeStreamShell1**, create a Python script to open a change
       stream using the PyMongo driver.
 
       .. code-block:: bash

source/tutorials/migrate-time-series.txt

@@ -32,14 +32,6 @@ from a collection to a time series collection. The time series collection
 stores and indexes the data more efficiently and retains the ability to analyze
 stock performance over time using aggregation operators.
 
-.. important:: Apple M1 incompatibility
-
-   This tutorial requires the time series collection feature introduced in
-   MongoDB version 5.0. The MongoDB Docker image does not currently build for
-   any version after 4.x on an M1 CPU, and therefore cannot run the complete
-   tutorial. MongoDB developers are currently working on resolving this
-   issue.
-
 Migrate a Collection to a Time Series Collection
 ------------------------------------------------
 
@@ -52,13 +44,27 @@ Migrate a Collection to a Time Series Collection
 
    .. step:: Generate Sample Data
 
+      .. include:: /includes/tutorials/robwma-m1-arch.txt
+
       Run the following command to start a Docker container that generates
       a sample collection containing fabricated stock symbols and their prices
       in your tutorial MongoDB replica set:
 
-      .. code-block:: bash
+      .. tabs::
+
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
+
+            .. code-block:: bash
+
+               docker run --rm --network mongodb-kafka-base_localnet -it robwma/stockgenmongo:1.0 -c "mongodb://mongo1" -db Stocks -col PriceData
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
 
-         docker run --rm --network mongodb-kafka-base_localnet -it robwma/stockgenmongo:1.0 -c "mongodb://mongo1" -db Stocks -col PriceData
+               docker run --platform='linux/arm64' --rm --network mongodb-kafka-base_localnet -it robwma/stockgenmongo:1.0 -c "mongodb://mongo1" -db Stocks -col PriceData
 
       Once the data generator starts running, you should see the generated
       data that resembles the following:
@@ -77,9 +83,23 @@ Migrate a Collection to a Time Series Collection
       Create an interactive shell session on the tutorial Docker container
       downloaded for the Tutorial Setup using the following command:
 
-      .. code-block:: bash
 
-         docker run --rm --name TimeSeriesTutorial --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+      .. tabs::
+
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
+
+            .. code-block:: bash
+
+               docker run --rm --name TimeSeriesTutorial --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
+
+               docker run --platform='linux/arm64' --rm --name TimeSeriesTutorial --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
       Create a source configuration file called ``stock-source.json`` with the
       following command:

source/tutorials/replicate-with-cdc.txt

@@ -46,21 +46,49 @@ Replicate Data with a CDC Handler
       windows. In the tutorial, you can use the shells to run and observe
       different tasks.
 
+      .. include:: /includes/tutorials/robwma-m1-arch.txt
+
       Run the following command in the terminal to start an interactive shell
       called **CDCShell1** in one terminal window:
 
-      .. code-block:: bash
-         :caption: This command starts an interactive shell called CDCShell1
+      .. tabs::
+
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called CDCShell1
+
+               docker run --rm --name CDCShell1 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called CDCShell1
 
-         docker run --rm --name CDCShell1 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+               docker run --platform='linux/arm64' --rm --name CDCShell1 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
       Run the following command in the terminal to start an interactive shell
       called **CDCShell2** in the other terminal window:
 
-      .. code-block:: bash
-         :caption: This command starts an interactive shell called CDCShell2
+      .. tabs::
+
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called CDCShell2
+
+               docker run --rm --name CDCShell2 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
+               :caption: This command starts an interactive shell called CDCShell2
 
-         docker run --rm --name CDCShell2 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+               docker run --platform='linux/arm64' --rm --name CDCShell2 --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
       Arrange the two windows on your screen to keep both of them visible to
       see real-time updates.

source/tutorials/sink-connector.txt

@@ -26,13 +26,28 @@ Get Started with the MongoDB Kafka Sink Connector
 
    .. step:: Configure the Sink Connector
 
+      .. include:: /includes/tutorials/robwma-m1-arch.txt
+
       Create an interactive shell session on the tutorial Docker Container
       using the following command:
 
-      .. code-block:: bash
-         :copyable: true
+      .. tabs::
+
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
+
+            .. code-block:: bash
+               :copyable: true
+
+               docker run --rm --name SinkTutorialShell --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
+               :copyable: true
 
-         docker run --rm --name SinkTutorialShell --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+               docker run --rm --platform='linux/arm64' --name SinkTutorialShell --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
       Create a source configuration file called ``simplesink.json`` with
       the following command:

source/tutorials/source-connector.txt

@@ -25,12 +25,27 @@ Get Started with the MongoDB Kafka Source Connector
 
    .. step:: Configure the Source Connector
 
+      .. include:: /includes/tutorials/robwma-m1-arch.txt
+
       Create an interactive shell session on the tutorial Docker container
       downloaded for the Tutorial Setup using the following command:
 
-      .. code-block:: bash
+      .. tabs::
+
+         .. tab:: Intel Processors
+            :tabid: intel-cpu
+
+            .. code-block:: bash
+
+               docker run --rm --name SourceTutorialShell --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
+
+         .. tab:: Apple M1 Processors
+            :tabid: apple-m1-cpu
+
+            .. code-block:: bash
+
+               docker run --platform='linux/arm64' --rm --name SourceTutorialShell --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
-         docker run --rm --name SourceTutorialShell --network mongodb-kafka-base_localnet -it robwma/mongokafkatutorial:latest bash
 
       Create a source configuration file called ``simplesource.json`` with
       the following command: