Merge pull request #10051 from usha-mandya/desktop-stable-2.2-dashboard

Docker Desktop Dashboard updates

_data/toc.yaml

@@ -1173,6 +1173,8 @@ manuals:
     title: Getting started
   - path: /docker-for-mac/install/
     title: Install Docker Desktop for Mac
+  - path: /docker-for-mac/dashboard/
+    title: Dashboard
   - path: /docker-for-mac/kubernetes/
     title: Deploy on Kubernetes
   - path: /docker-for-mac/docker-toolbox/
@@ -1203,6 +1205,8 @@ manuals:
     title: Getting started
   - path: /docker-for-windows/install/
     title: Install Docker Desktop for Windows
+  - path: /docker-for-windows/dashboard/
+    title: Dashboard
   - path: /docker-for-windows/kubernetes/
     title: Deploy on Kubernetes
   - path: /docker-for-windows/networking/

docker-for-mac/dashboard.md

@@ -0,0 +1,131 @@
+---
+description: Docker Desktop Dashboard
+keywords: Docker Desktop Dashboard, container view
+title: Docker Desktop Dashboard
+---
+
+The Docker Desktop Dashboard provides a simple interface that enables you to interact with containers and applications, and manage the lifecycle of your applications directly from your machine. The Dashboard UI shows all running, stopped, and started containers with their status. It provides an intuitive interface to perform common actions to inspect, interact with, and manage your Docker objects including containers and Docker Compose-based applications.
+
+The Docker Desktop Dashboard offers the following benefits:
+
+- A GUI to abstract core information from the CLI
+- Access to container logs directly in the UI to search and explore container behavior
+- Access to combined Compose logs from the UI to understand Compose applications
+- Quick visibility into ports being used by containers
+- Monitor container resource utilization
+
+In addition, the Dashboard UI allows you to:
+
+- Navigate to the [Settings](/docker-for-mac/index/#preferences) menu to configure Docker Desktop preferences
+- Access the [Troubleshoot](troubleshoot.md) menu to debug and perform restart operations
+- Sign into [Docker Hub](/docker-for-mac/index/#docker-hub) using your Docker ID
+
+To access the Docker Desktop Dashboard, from the Docker menu, select **Dashboard**. The Dashboard provides a runtime view of all your containers and applications.
+
+![Docker Desktop Dashboard](images/mac-dashboard.png)
+
+## Explore running containers and applications
+
+From the Docker menu, select **Dashboard**. This lists all your running containers and applications. Note that you must have running containers and applications to see them listed on the Docker Desktop Dashboard.
+
+The following sections guide you through the process of creating a sample Redis container and a sample application to demonstrate the core functionalities in Docker Desktop Dashboard.
+
+### Start a Redis container
+
+To start a Redis container, open your preferred CLI and run the following command:
+
+`docker run -dt redis`
+
+This creates a new Redis container. From the Docker menu, select **Dashboard** to see the new Redis container.
+
+![Redis container](images/mac-redis-container.png){:width="700px"}
+
+### Start a sample application
+
+Now, let us start a sample application. You can download the [Example voting app](https://github.com/dockersamples/example-voting-app) from the Docker samples page. The example voting app is a distributed application that runs across multiple Docker containers.
+
+![Example voting app architecture diagram](../docker-for-windows/images/example-app-architecture.png){:width="600px"}
+
+The example voting app contains:
+
+- A front-end web app in [Python](/vote) or [ASP.NET Core](/vote/dotnet) which lets you vote between two options
+- A [Redis](https://hub.docker.com/_/redis/) or [NATS](https://hub.docker.com/_/nats/) queue which collects new votes
+- A [.NET Core](/worker/src/Worker), [Java](/worker/src/main) or [.NET Core 2.1](/worker/dotnet) worker which consumes votes and stores them
+- A [Postgres](https://hub.docker.com/_/postgres/) or [TiDB](https://hub.docker.com/r/dockersamples/tidb/tags/) database backed by a Docker volume
+- A [Node.js](/result) or [ASP.NET Core SignalR](/result/dotnet) web app which shows the results of the voting in real time
+
+To start the application, navigate to the directory containing the example voting application in the CLI and run `docker-compose up --build`.
+
+```
+$ docker-compose up --build
+Creating network "example-voting-app-master_front-tier" with the default driver
+Creating network "example-voting-app-master_back-tier" with the default driver
+Creating volume "example-voting-app-master_db-data" with default driver
+Building vote
+Step 1/7 : FROM python:2.7-alpine
+2.7-alpine: Pulling from library/python
+Digest: sha256:d2cc8451e799d4a75819661329ea6e0d3e13b3dadd56420e25fcb8601ff6ba49
+Status: Downloaded newer image for python:2.7-alpine
+ ---> 1bf48bb21060
+Step 2/7 : WORKDIR /app
+ ---> Running in 7a6a0c9d8b61
+Removing intermediate container 7a6a0c9d8b61
+ ---> b1242f3c6d0c
+Step 3/7 : ADD requirements.txt /app/requirements.txt
+ ---> 0f5d69b65243
+Step 4/7 : RUN pip install -r requirements.txt
+ ---> Running in 92788dc9d682
+
+...
+Successfully built 69da1319c6ce
+Successfully tagged example-voting-app-master_worker:latest
+Creating example-voting-app-master_vote_1   ... done
+Creating example-voting-app-master_result_1 ... done
+Creating db                                 ... done
+Creating redis                              ... done
+Creating example-voting-app-master_worker_1 ... done
+Attaching to db, redis, example-voting-app-master_result_1, example-voting-app-master_vote_1, example-voting-app-master_worker_1
+...
+```
+
+When the application successfully starts, from the Docker menu, select **Dashboard** to see the Example voting application. Expand the application to see the containers running inside the application.
+
+![Spring Boot application view](images/app-dashboard-view.png){:width="700px"}
+
+Now that you can see the list of running containers and applications on the Dashboard, let us explore some of the actions you can perform:
+
+- Click **Port** to open the port exposed by the container in a browser.
+- Click **CLI** to open a terminal and run commands on the container.
+- Click **Stop**, **Start**, **Restart**, or **Delete** to perform lifecycle operations on the container.
+
+Use the **Search** option to search for a specific object. You can also sort your containers and applications using various options. Click the **Sort by** drop-down to see a list of available options.
+
+## Interact with containers and applications
+
+From the Docker Desktop Dashboard, select the example voting application we started earlier.
+
+The **application view** lists all the containers running on the application and contains a detailed logs view. It also allows you to start, stop, or delete the application.
+
+Hover over the containers to see some of the core actions you can perform. Use the **Search** option at the bottom to search the application logs for specific events, or select the **Copy** icon to copy the logs to your clipboard.
+
+![Application view](images/mac-application-view.png){:width="700px"}
+
+Click on a specific container for detailed information about the container. The **container view** displays **Logs**, **Inspect**, and **Stats** tabs and provides quick action buttons to perform various actions.
+
+![Explore the app](images/mac-container-view.png){:width="700px"}
+
+- Select **Logs** to see logs from the container. You can also search the logs for specific events and copy the logs to your clipboard.
+
+- Select **Inspect** to view low-level information about the container. You can see the local path, version number of the image, SHA-256, port mapping, and other details.
+
+- Select **Stats** to view information about the container resource utilization. You can see the amount of CPU, disk I/O, memory, and network I/O used by the container.
+
+You can also use the quick action buttons on the top bar to perform common actions such as opening a CLI to run commands in a container, and perform lifecycle operations such as stop, start, restart, or delete your container.
+
+Click **Port** to open the port exposed by the container in a browser.
+
+![Spring app browser view](images/mac-browser-view.png){:width="700px"}
+
+## Feedback
+
+We would like to hear from you about the new Dashboard UI. Let us know your feedback by creating an issue in the [docker/for-mac](https://github.com/docker/for-mac/issues) GitHub repository.

docker-for-mac/index.md

@@ -12,6 +12,8 @@ redirect_from:
 - /docker-for-mac/index/
 - /docker-for-mac/osx/
 title: Get started with Docker Desktop for Mac
+toc_min: 1
+toc_max: 2
 ---
 
 Welcome to Docker Desktop!
@@ -318,6 +320,10 @@ experience conflicts, remove `/usr/local/bin/kubectl`.
 
 For information about the reset options, see [Logs and Troubleshooting](troubleshoot.md).
 
+## Dashboard
+
+The Docker Desktop Dashboard enables you to interact with containers and applications and manage the lifecycle of your applications directly from your machine. The Dashboard UI shows all running, stopped, and started containers with their state. It provides an intuitive interface to perform common actions to inspect and manage containers and existing Docker Compose applications. For more information, see [Docker Desktop Dashboard](dashboard.md).
+
 ## Add TLS certificates
 
 You can add trusted Certificate Authorities (CAs) (used to verify registry

docker-for-windows/dashboard.md

@@ -0,0 +1,131 @@
+---
+description: Docker Desktop Dashboard
+keywords: Docker Desktop Dashboard, container view
+title: Docker Desktop Dashboard
+---
+
+The Docker Desktop Dashboard provides a simple interface that enables you to interact with containers and applications, and manage the lifecycle of your applications directly from your machine. The Dashboard UI shows all running, stopped, and started containers with their status. It provides an intuitive interface to perform common actions to inspect, interact with, and manage your Docker objects including containers and Docker Compose-based applications.
+
+The Docker Desktop Dashboard offers the following benefits:
+
+- A GUI to abstract core information from the CLI
+- Access to container logs directly in the UI to search and explore container behavior
+- Access to combined Compose logs from the UI to understand Compose applications
+- Quick visibility into ports being used by containers
+- Monitor container resource utilization
+
+In addition, the Dashboard UI allows you to:
+
+- Navigate to the [Settings](/docker-for-windows/index/#docker-settings-dialog) menu to configure Docker Desktop preferences
+- Access the [Troubleshoot](troubleshoot.md) menu to debug and perform restart operations
+- Sign into [Docker Hub](/docker-for-windows/index/#docker-hub) using your Docker ID
+
+To access the Docker Desktop Dashboard, from the Docker menu, select **Dashboard**. The Dashboard provides a runtime view of all your containers and applications.
+
+![Docker Desktop Dashboard](images/dashboard-settings.png)
+
+## Explore running containers and applications
+
+From the Docker menu, select **Dashboard**. This lists all your running containers and applications. Note that you must have running containers and applications to see them listed on the Docker Desktop Dashboard.
+
+The following sections guide you through the process of creating a sample Redis container and a sample application to demonstrate the core functionalities in Docker Desktop Dashboard.
+
+### Start a Redis container
+
+To start a Redis container, open your preferred CLI and run the following command:
+
+`docker run -dt redis`
+
+This creates a new Redis container. From the Docker menu, select **Dashboard** to see the new Redis container.
+
+![Redis container](images/redis-container.png){:width="700px"}
+
+### Start a sample application
+
+Now, let us start a sample application. You can download the [Example voting app](https://github.com/dockersamples/example-voting-app) from the Docker samples page. The example voting app is a distributed application that runs across multiple Docker containers.
+
+![Example voting app architecture diagram](images/example-app-architecture.png){:width="600px"}
+
+The example voting application contains:
+
+- A front-end web app in [Python](/vote) or [ASP.NET Core](/vote/dotnet) which lets you vote between two options
+- A [Redis](https://hub.docker.com/_/redis/) or [NATS](https://hub.docker.com/_/nats/) queue which collects new votes
+- A [.NET Core](/worker/src/Worker), [Java](/worker/src/main) or [.NET Core 2.1](/worker/dotnet) worker which consumes votes and stores them
+- A [Postgres](https://hub.docker.com/_/postgres/) or [TiDB](https://hub.docker.com/r/dockersamples/tidb/tags/) database backed by a Docker volume
+- A [Node.js](/result) or [ASP.NET Core SignalR](/result/dotnet) web app which shows the results of the voting in real time
+
+To start the application, navigate to the directory containing the example voting application in the CLI and run `docker-compose up --build`.
+
+```
+$ docker-compose up --build
+Creating network "example-voting-app-master_front-tier" with the default driver
+Creating network "example-voting-app-master_back-tier" with the default driver
+Creating volume "example-voting-app-master_db-data" with default driver
+Building vote
+Step 1/7 : FROM python:2.7-alpine
+2.7-alpine: Pulling from library/python
+Digest: sha256:d2cc8451e799d4a75819661329ea6e0d3e13b3dadd56420e25fcb8601ff6ba49
+Status: Downloaded newer image for python:2.7-alpine
+ ---> 1bf48bb21060
+Step 2/7 : WORKDIR /app
+ ---> Running in 7a6a0c9d8b61
+Removing intermediate container 7a6a0c9d8b61
+ ---> b1242f3c6d0c
+Step 3/7 : ADD requirements.txt /app/requirements.txt
+ ---> 0f5d69b65243
+Step 4/7 : RUN pip install -r requirements.txt
+ ---> Running in 92788dc9d682
+
+...
+Successfully built 69da1319c6ce
+Successfully tagged example-voting-app-master_worker:latest
+Creating example-voting-app-master_vote_1   ... done
+Creating example-voting-app-master_result_1 ... done
+Creating db                                 ... done
+Creating redis                              ... done
+Creating example-voting-app-master_worker_1 ... done
+Attaching to db, redis, example-voting-app-master_result_1, example-voting-app-master_vote_1, example-voting-app-master_worker_1
+...
+```
+
+When the application successfully starts, from the Docker menu, select **Dashboard** to see the example voting application. Expand the application to see the containers running inside the application.
+
+![App Dashboard view](images/app-dashboard-view.png){:width="700px"}
+
+Now that you can see the list of running containers and applications on the Dashboard, let us explore some of the actions you can perform:
+
+- Click **Port** to open the port exposed by the container in a browser.
+- Click **CLI** to open a terminal and run commands on the container.
+- Click **Stop**, **Start**, **Restart**, or **Delete** to perform lifecycle operations on the container.
+
+Use the **Search** option to search for a specific object. You can also sort your containers and applications using various options. Click the **Sort by** drop-down to see a list of available options.
+
+## Interact with containers and applications
+
+From the Docker Desktop Dashboard, select the example voting application we started earlier.
+
+The **application view** lists all the containers running on the application and contains a detailed logs view. It also allows you to start, stop, or delete the application.
+
+Hover over the containers to see some of the core actions you can perform. Use the **Search** option at the bottom to search the application logs for specific events, or select the **Copy** icon to copy the logs to your clipboard.
+
+![Application view](images/application-view.png){:width="700px"}
+
+Click on a specific container for detailed information about the container. The **container view** displays **Logs**, **Inspect**, and **Stats** tabs and provides quick action buttons to perform various actions.
+
+![Explore the app](images/container-view.png){:width="700px"}
+
+- Select **Logs** to see logs from the container. You can also search the logs for specific events and copy the logs to your clipboard.
+
+- Select **Inspect** to view low-level information about the container. You can see the local path, version number of the image, SHA-256, port mapping, and other details.
+
+- Select **Stats** to view information about the container resource utilization. You can see the amount of CPU, disk I/O, memory, and network I/O used by the container.
+
+You can also use the quick action buttons on the top bar to perform common actions such as opening a CLI to run commands in a container, and perform lifecycle operations such as stop, start, restart, or delete your container.
+
+Click **Port** to open the port exposed by the container in a browser.
+
+![Spring app browser view](images/app-browser-view.png){:width="700px"}
+
+## Feedback
+
+We would like to hear from you about the new Dashboard UI. Let us know your feedback by creating an issue in the [docker/for-win](https://github.com/docker/for-win/issues) GitHub repository.

docker-for-windows/index.md

@@ -11,6 +11,8 @@ redirect_from:
 - /engine/installation/windows/
 - /docker-for-windows/index/
 title: Get started with Docker for Windows
+toc_min: 1
+toc_max: 2
 ---
 
 Welcome to Docker Desktop!
@@ -514,6 +516,10 @@ proxies and daemon configurations return to what you had set for Linux
 containers. Your Windows container settings are retained and become available
 again when you switch back.
 
+## Dashboard
+
+The Docker Desktop Dashboard enables you to interact with containers and applications and manage the lifecycle of your applications directly from your machine. The Dashboard UI shows all running, stopped, and started containers with their state. It provides an intuitive interface to perform common actions to inspect and manage containers and Docker Compose applications. For more information, see [Docker Desktop Dashboard](dashboard.md).
+
 ## Docker Hub
 
 Select **Sign in /Create Docker ID** from the Docker Desktop menu to access your [Docker Hub](https://hub.docker.com/){: target="_blank" class="_" } account. Once logged in, you can access your Docker Hub repositories directly from the Docker Desktop menu.