Skip to content

Commit 347733c

Browse files
desktop,cloud: add vdi beta (#22696)
<!--Delete sections as needed --> ## Description Added Cloud VDI Beta https://deploy-preview-22696--docsdocker.netlify.app/desktop/setup/vm-vdi/ ## Related issues or tickets ENGDOCS-2649 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig <[email protected]> Co-authored-by: Allie Sadler <[email protected]>
1 parent 643956d commit 347733c

File tree

3 files changed

+89
-5
lines changed

3 files changed

+89
-5
lines changed
457 Bytes
Loading

content/manuals/desktop/setup/vm-vdi.md

Lines changed: 86 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,91 @@ aliases:
99
weight: 30
1010
---
1111

12-
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.
12+
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.
1313

14-
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.
14+
To run Docker Desktop in a virtual desktop environment, you have two options,
15+
depending on whether nested virtualization is supported:
1516

16-
## Virtual desktop support
17+
- If your environment supports nested virtualization, you can run Docker Desktop
18+
with its default local Linux VM.
19+
- If nested virtualization is not supported, Docker recommends using Docker
20+
Cloud. To join the beta, contact Docker at `[email protected]`.
21+
22+
## Use Docker Cloud
23+
24+
{{< summary-bar feature_name="Docker Cloud" >}}
25+
26+
Docker Cloud lets you offload container workloads to a high-performance,
27+
fully hosted cloud environment, enabling a seamless hybrid experience. It
28+
includes an insights dashboard that offers performance metrics and environment
29+
management to help optimize your development workflow.
30+
31+
This mode is useful in virtual desktop environments where nested virtualization
32+
isn't supported. In these environments, Docker Desktop defaults to using
33+
cloud mode to ensure you can still build and run containers without relying on
34+
local virtualization.
35+
36+
Docker Cloud decouples the Docker Desktop client from the Docker Engine,
37+
allowing the Docker CLI and Docker Desktop Dashboard to interact with
38+
cloud-based resources as if they were local. When you run a container, Docker
39+
provisions a secure, isolated, and ephemeral cloud environment connected to
40+
Docker Desktop via an SSH tunnel. Despite running remotely, features like bind
41+
mounts and port forwarding continue to work seamlessly, providing a local-like
42+
experience. To use Docker Cloud:
43+
44+
1. Contact Docker at `[email protected]` to activate the feature for your
45+
account.
46+
2. [Install Docker Desktop](/manuals/desktop/setup/install/windows-install.md#install-docker-desktop-on-windows)
47+
version 4.42 or later on your Windows virtual desktop.
48+
3. [Start Docker Desktop](/manuals/desktop/setup/install/windows-install.md#start-docker-desktop).
49+
4. Sign in to Docker Desktop.
50+
51+
After you sign in, Docker Cloud is enabled by default and cannot be
52+
disabled. When enabled, Docker Desktop's Dashboard header appears purple and the
53+
cloud-mode toggle is a cloud icon ({{< inline-image
54+
src="./images/cloud-mode.png" alt="Cloud mode icon" >}}).
55+
56+
In this mode, Docker Desktop mirrors your cloud environment, providing
57+
a seamless view of your containers and resources running on Docker Cloud. You
58+
can verify that Docker Cloud is working by running a simple container. In a
59+
terminal on your virtual desktop, run the following command:
60+
61+
```console
62+
$ docker run hello-world
63+
```
64+
65+
In the terminal, you will see `Hello from Docker!` if everything is working
66+
correctly.
67+
68+
### View insights and manage Docker Cloud
69+
70+
For insights and management, use the [Docker Cloud
71+
Dashboard](https://app.docker.com/cloud). It provides visibility into your
72+
builds, runs, and cloud resource usage. Key features include:
73+
74+
- Overview: Monitor cloud usage, build cache, and top repositories built.
75+
- Build history: Review past builds with filtering and sorting options.
76+
- Run history: Track container runs and sort by various options.
77+
- Integrations: Learn how to set up cloud builders and runners for your CI
78+
pipeline.
79+
- Settings: Manage cloud builders, usage, and account settings.
80+
81+
Access the Docker Cloud Dashboard at https://app.docker.com/cloud.
82+
83+
### Limitations
84+
85+
The following limitations apply when using Docker Cloud:
86+
87+
- Persistence: Containers are launched in a cloud engine that remains available
88+
as long as you interact with and consume the containers' output. After closing
89+
Docker Desktop, or about 30 minutes of inactivity, the engine is shut down and
90+
becomes inaccessible, along with any data stored in it, including images,
91+
containers, and volumes. A new engine is provisioned for any new workloads.
92+
- Usage and billing: During beta, no charges are incurred for using Docker Cloud
93+
resources. Docker enforces a usage cap and reserves the right to disable
94+
Docker Cloud access at any time.
95+
96+
## Virtual desktop support when using nested virtualization
1797

1898
> [!NOTE]
1999
>
@@ -33,7 +113,8 @@ Docker does not support running multiple instances of Docker Desktop on the same
33113
34114
## Turn on nested virtualization
35115

36-
You must turn on nested virtualization before you install Docker Desktop on a virtual machine.
116+
You must turn on nested virtualization before you install Docker Desktop on a
117+
virtual machine that will not use Docker Cloud.
37118

38119
### Turn on nested virtualization on VMware ESXi
39120

@@ -55,7 +136,7 @@ If using Windows container mode, confirm that the Nutanix environment supports H
55136

56137
### Supported configurations
57138

58-
Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support):
139+
Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support-when-using-nested-virtualization):
59140

60141
- Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations.
61142

data/summary.yaml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,9 @@ Docker Build Cloud:
135135
subscription: [Pro, Team, Business]
136136
Docker CLI OpenTelemetry:
137137
requires: Docker Engine [26.1.0](/manuals/engine/release-notes/26.1.md#2610) and later
138+
Docker Cloud:
139+
availability: Beta
140+
requires: Docker Desktop 4.42 and later
138141
docker compose alpha:
139142
availability: Experimental
140143
Docker Debug:

0 commit comments

Comments
 (0)