From 347733c276fcd1f6e7dd376e3eb93e5f06816291 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Wed, 4 Jun 2025 06:47:44 -0700 Subject: [PATCH] desktop,cloud: add vdi beta (#22696) ## Description Added Cloud VDI Beta https://deploy-preview-22696--docsdocker.netlify.app/desktop/setup/vm-vdi/ ## Related issues or tickets ENGDOCS-2649 ## Reviews - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../desktop/setup/images/cloud-mode.png | Bin 0 -> 457 bytes content/manuals/desktop/setup/vm-vdi.md | 91 +++++++++++++++++- data/summary.yaml | 3 + 3 files changed, 89 insertions(+), 5 deletions(-) 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 b519782477..d9d3a2b6c9 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -9,11 +9,91 @@ 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 + +{{< summary-bar feature_name="Docker Cloud" >}} + +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. + +This mode is useful in virtual desktop environments where nested virtualization +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 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: + +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 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" >}}). + +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 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: + +- 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 +113,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. ### Turn on nested virtualization on VMware ESXi @@ -55,7 +136,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 b6f0c80374..10e1ba4f1e 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: