mirror of https://github.com/docker/docs.git
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 <craig.osterhout@docker.com> Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
parent
643956d16d
commit
347733c276
Binary file not shown.
|
After Width: | Height: | Size: 457 B |
|
|
@ -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.
|
||||
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
Loading…
Reference in New Issue