From 39294769ec177bf12574dfa4633b8db484e07a7a Mon Sep 17 00:00:00 2001 From: Craig Date: Fri, 23 May 2025 10:16:41 -0700 Subject: [PATCH 01/13] cloud: add vdi beta Signed-off-by: Craig --- content/manuals/desktop/setup/vm-vdi.md | 87 +++++++++++++++++++++++-- data/summary.yaml | 3 + 2 files changed, 85 insertions(+), 5 deletions(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index b51978247761..8643a1c273e9 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -9,11 +9,87 @@ aliases: weight: 30 --- -Docker recommends running Docker Desktop natively on Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured. +Docker recommends running Docker Desktop natively on Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured. -To run Docker Desktop in a virtual desktop environment, it is essential nested virtualization is enabled on the virtual machine that provides the virtual desktop. This is because, under the hood, Docker Desktop is using a Linux VM in which it runs Docker Engine and the containers. +To run Docker Desktop in a virtual desktop environment, you have two options, +depending on whether nested virtualization is supported: -## Virtual desktop support +- If your environment supports nested virtualization, you can run Docker Desktop + with its default local Linux VM. +- If nested virtualization is not supported, Docker recommends using Docker + Cloud. To join the beta, contact Docker at `docker-cloud@docker.com`. + +## Use Docker Cloud mode + +{{< summary-bar feature_name="Docker Cloud" >}} + +Docker Cloud mode lets you offload container workloads to a high-performance, +fully hosted cloud environment, enabling a seamless hybrid experience. It +includes an insights dashboard that offers performance metrics and environment +management to help optimize your development workflow. + +This mode is useful in virtual desktop environments where nested virtualization +isn't supported. In these environments, Docker Desktop defaults to using Docker +Cloud mode to ensure you can still build and run containers without relying on +local virtualization. + +Docker Cloud mode decouples the Docker Desktop client from the Docker Engine, +allowing the Docker CLI and Docker Desktop Dashboard to interact with +cloud-based resources as if they were local. When you run a container, Docker +provisions a secure, isolated, and ephemeral cloud environment connected to +Docker Desktop via an SSH tunnel. Despite running remotely, features like bind +mounts and port forwarding continue to work seamlessly, providing a local-like +experience. To use Docker Cloud mode: + +1. Contact Docker at `docker-cloud@docker.com` to activate the feature for your + account. +2. [Install Docker Desktop](/manuals/desktop/setup/install/windows-install.md#install-docker-desktop-on-windows) + version 4.42 or later on your Windows virtual desktop. +3. [Start Docker Desktop](/manuals/desktop/setup/install/windows-install.md#start-docker-desktop). +4. Sign in to Docker Desktop. + +After you sign in, Docker Cloud mode is enabled by default and cannot be +disabled. In this mode, Docker Desktop mirrors your cloud environment, providing +a seamless view of your containers and resources running on Docker Cloud. You +can verify that Docker Cloud mode is working by running a simple container. In a +terminal on your virtual desktop, run the following command: + +```console +$ docker run hello-world +``` + +In the terminal, you will see `Hello from Docker!` if everything is working +correctly. + +### View insights and manage Docker Cloud + +For insights and management, use the [Docker Cloud +Dashboard](https://app.docker.com/cloud). It provides visibility into your +builds, runs, and cloud resource usage. Key features include: + +- Overview: Monitor cloud usage, build cache, and top repositories built. +- Build history: Review past builds with filtering and sorting options. +- Run history: Track container runs and sort by various options. +- Integrations: Learn how to set up cloud builders and runners for your CI + pipeline. +- Settings: Manage cloud builders, usage, and account settings. + +Access the Docker Cloud Dashboard at https://app.docker.com/cloud. + +### Limitations + +The following limitations apply when using Docker Cloud mode: + +- Persistence: Containers are launched in a cloud engine that remains available + as long as you interact with and consume the containers' output. After closing + Docker Desktop, or about 30 minutes of inactivity, the engine is shut down and + becomes inaccessible, along with any data stored in it, including images, + containers, and volumes. A new engine is provisioned for any new workloads. +- Usage and billing: During beta, no charges are incurred for using Docker Cloud + resources. Docker enforces a usage cap and reserves the right to disable + Docker Cloud access at any time. + +## Virtual desktop support when using nested virtualization > [!NOTE] > @@ -33,7 +109,8 @@ Docker does not support running multiple instances of Docker Desktop on the same ## Turn on nested virtualization -You must turn on nested virtualization before you install Docker Desktop on a virtual machine. +You must turn on nested virtualization before you install Docker Desktop on a +virtual machine that will not use Docker Cloud mode. ### Turn on nested virtualization on VMware ESXi @@ -55,7 +132,7 @@ If using Windows container mode, confirm that the Nutanix environment supports H ### Supported configurations -Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support): +Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support-when-using-nested-virtualization): - Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations. diff --git a/data/summary.yaml b/data/summary.yaml index 6edf51df83c5..af8cdb46153c 100644 --- a/data/summary.yaml +++ b/data/summary.yaml @@ -135,6 +135,9 @@ Docker Build Cloud: subscription: [Pro, Team, Business] Docker CLI OpenTelemetry: requires: Docker Engine [26.1.0](/manuals/engine/release-notes/26.1.md#2610) and later +Docker Cloud: + availability: Beta + requires: Docker Desktop 4.42 and later docker compose alpha: availability: Experimental Docker Debug: From 9983785c91a2bf7b503bc3399a93a368617f6369 Mon Sep 17 00:00:00 2001 From: Craig Date: Tue, 27 May 2025 15:04:50 -0700 Subject: [PATCH 02/13] add cloud mode visual indicators Signed-off-by: Craig --- .../manuals/desktop/setup/images/cloud-mode.png | Bin 0 -> 457 bytes content/manuals/desktop/setup/vm-vdi.md | 6 +++++- 2 files changed, 5 insertions(+), 1 deletion(-) create mode 100644 content/manuals/desktop/setup/images/cloud-mode.png diff --git a/content/manuals/desktop/setup/images/cloud-mode.png b/content/manuals/desktop/setup/images/cloud-mode.png new file mode 100644 index 0000000000000000000000000000000000000000..b4d3deb039b838fa2e7892a98f5bbb85d1f9e643 GIT binary patch literal 457 zcmV;)0XF`LP)Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D0bWT&K~zXf?UX-G z!!Q)azjA>v6Diq|$c866G8G9rvoMn*WR5sNI(K1Ck?6!orj#i;0YTpJ3BvFa89BD& zN(}?*Z?WU|?9cCyGi%$n#UFB_E=&09fA-)5isH zy)xTXtWCoO@KVz}UFZ+j>LJmlG%I9n zSOBCqbf66`fK?$I%T!aX;Q14cE;Ugp8;a8RfVW50s!8eZ8tf~EZVwA6VqHB4f<0p? zw82F;eybLZU@v64;TU-(1(%U(HPo3J4G|ki;1rN>-G5wCal4tj>00000NkvXXu0mjfDRH^e literal 0 HcmV?d00001 diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 8643a1c273e9..fe5941979fa0 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -49,7 +49,11 @@ experience. To use Docker Cloud mode: 4. Sign in to Docker Desktop. After you sign in, Docker Cloud mode is enabled by default and cannot be -disabled. In this mode, Docker Desktop mirrors your cloud environment, providing +disabled. When enabled, Docker Desktop's Dashboard header appears purple and the +cloud mode toggle is a cloud icon ({{< inline-image +src="./images/cloud-mode.png" alt="Cloud mode icon" >}}). + +In this mode, Docker Desktop mirrors your cloud environment, providing a seamless view of your containers and resources running on Docker Cloud. You can verify that Docker Cloud mode is working by running a simple container. In a terminal on your virtual desktop, run the following command: From 091e293d5f8069fe21c1f2dba7ad1f2fde90f7e3 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:51:39 -0700 Subject: [PATCH 03/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index fe5941979fa0..434abea4b95a 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -19,7 +19,7 @@ depending on whether nested virtualization is supported: - If nested virtualization is not supported, Docker recommends using Docker Cloud. To join the beta, contact Docker at `docker-cloud@docker.com`. -## Use Docker Cloud mode +## Use Docker Cloud {{< summary-bar feature_name="Docker Cloud" >}} From 0c6e2d464c79b70da6a3b8f1dde962142d011958 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:51:45 -0700 Subject: [PATCH 04/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 434abea4b95a..9cab23f951e6 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -23,7 +23,7 @@ depending on whether nested virtualization is supported: {{< summary-bar feature_name="Docker Cloud" >}} -Docker Cloud mode lets you offload container workloads to a high-performance, +Docker Cloud lets you offload container workloads to a high-performance, fully hosted cloud environment, enabling a seamless hybrid experience. It includes an insights dashboard that offers performance metrics and environment management to help optimize your development workflow. From 47a0afdca934a72e08e94f74b461f53d2000abd3 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:02 -0700 Subject: [PATCH 05/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 9cab23f951e6..4b80eb3bf9da 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -30,7 +30,7 @@ management to help optimize your development workflow. This mode is useful in virtual desktop environments where nested virtualization isn't supported. In these environments, Docker Desktop defaults to using Docker -Cloud mode to ensure you can still build and run containers without relying on +cloud mode to ensure you can still build and run containers without relying on local virtualization. Docker Cloud mode decouples the Docker Desktop client from the Docker Engine, From 35fd94baebcb8840f89f4c678c45ca5fc5cc8345 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:13 -0700 Subject: [PATCH 06/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 4b80eb3bf9da..36d4745de839 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -29,7 +29,7 @@ includes an insights dashboard that offers performance metrics and environment management to help optimize your development workflow. This mode is useful in virtual desktop environments where nested virtualization -isn't supported. In these environments, Docker Desktop defaults to using Docker +isn't supported. In these environments, Docker Desktop defaults to using cloud mode to ensure you can still build and run containers without relying on local virtualization. From 92b023f2abf2f6b70fb2002bdd6c5e51368d55d2 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:21 -0700 Subject: [PATCH 07/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 36d4745de839..3df17fe3c320 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -33,7 +33,7 @@ isn't supported. In these environments, Docker Desktop defaults to using cloud mode to ensure you can still build and run containers without relying on local virtualization. -Docker Cloud mode decouples the Docker Desktop client from the Docker Engine, +Docker Cloud decouples the Docker Desktop client from the Docker Engine, allowing the Docker CLI and Docker Desktop Dashboard to interact with cloud-based resources as if they were local. When you run a container, Docker provisions a secure, isolated, and ephemeral cloud environment connected to From 46d438bbf10c1c821e7c127a272707bd87b30658 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:29 -0700 Subject: [PATCH 08/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 3df17fe3c320..a800ff1002c3 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -39,7 +39,7 @@ cloud-based resources as if they were local. When you run a container, Docker provisions a secure, isolated, and ephemeral cloud environment connected to Docker Desktop via an SSH tunnel. Despite running remotely, features like bind mounts and port forwarding continue to work seamlessly, providing a local-like -experience. To use Docker Cloud mode: +experience. To use Docker Cloud: 1. Contact Docker at `docker-cloud@docker.com` to activate the feature for your account. From 792170abf4111b0e729f673a149491dccf0dff7f Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:35 -0700 Subject: [PATCH 09/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index a800ff1002c3..469b6a702a75 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -48,7 +48,7 @@ experience. To use Docker Cloud: 3. [Start Docker Desktop](/manuals/desktop/setup/install/windows-install.md#start-docker-desktop). 4. Sign in to Docker Desktop. -After you sign in, Docker Cloud mode is enabled by default and cannot be +After you sign in, Docker Cloud is enabled by default and cannot be disabled. When enabled, Docker Desktop's Dashboard header appears purple and the cloud mode toggle is a cloud icon ({{< inline-image src="./images/cloud-mode.png" alt="Cloud mode icon" >}}). From 8c0f0fe065285026c75c3b085bcd0c38f9808432 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:42 -0700 Subject: [PATCH 10/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 469b6a702a75..f2fafe4ea5d9 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -50,7 +50,7 @@ experience. To use Docker Cloud: After you sign in, Docker Cloud is enabled by default and cannot be disabled. When enabled, Docker Desktop's Dashboard header appears purple and the -cloud mode toggle is a cloud icon ({{< inline-image +cloud-mode toggle is a cloud icon ({{< inline-image src="./images/cloud-mode.png" alt="Cloud mode icon" >}}). In this mode, Docker Desktop mirrors your cloud environment, providing From f06d69c30111dfbcd32d1312e01f5804cb676036 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:50 -0700 Subject: [PATCH 11/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index f2fafe4ea5d9..16e49c6a6b14 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -55,7 +55,7 @@ src="./images/cloud-mode.png" alt="Cloud mode icon" >}}). In this mode, Docker Desktop mirrors your cloud environment, providing a seamless view of your containers and resources running on Docker Cloud. You -can verify that Docker Cloud mode is working by running a simple container. In a +can verify that Docker Cloud is working by running a simple container. In a terminal on your virtual desktop, run the following command: ```console From 10d1c02a01a069738b30040b1765c662eeab12c0 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:52:56 -0700 Subject: [PATCH 12/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 16e49c6a6b14..046101a3047a 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -114,7 +114,7 @@ Docker does not support running multiple instances of Docker Desktop on the same ## Turn on nested virtualization You must turn on nested virtualization before you install Docker Desktop on a -virtual machine that will not use Docker Cloud mode. +virtual machine that will not use Docker Cloud. ### Turn on nested virtualization on VMware ESXi From 6d4b5fa8db025d76b400142246236f5e21528334 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 28 May 2025 08:53:04 -0700 Subject: [PATCH 13/13] Update content/manuals/desktop/setup/vm-vdi.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/setup/vm-vdi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 046101a3047a..d9d3a2b6c932 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -82,7 +82,7 @@ Access the Docker Cloud Dashboard at https://app.docker.com/cloud. ### Limitations -The following limitations apply when using Docker Cloud mode: +The following limitations apply when using Docker Cloud: - Persistence: Containers are launched in a cloud engine that remains available as long as you interact with and consume the containers' output. After closing